sumik5/practicing-software-engineering
plugins/devkit/skills/practicing-software-engineering/SKILL.md
Comprehensive SW engineering practices covering project foundations (fast feedback, small steps, DORA metrics), team organization (Team Topologies, 4 types), pair programming (4 patterns), developer habits (GREAT framework), IC effectiveness mindset (outcomes vs outputs, strategic prioritization), career-stage skills (junior to staff, IC vs management), cross-functional influence (PM/design, authority-free leadership), 20 anti-patterns (15 individual + 5 team-level), sustainable performance (burnout, remote work), and AI-enhanced workflows (daily AI, 90-day rollout). Use when starting projects, organizing teams, for IC effectiveness, career growth, or team AI culture.
$ install --global
skillsauthnpx skillsauth add sumik5/sumik-claude-plugin practicing-software-engineeringInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 11, 2026, 5:43 AM128.5s10 files scanned
SKILL.md
- name:
- practicing-software-engineering
- description:
- >-
- when_to_use:
- >-
- instead. For CI/CD, use cloud:
- practicing-devops instead. For DDD/Clean Architecture, use
- applying-clean-architecture instead. For ODD/debugging, use cloud:
- implementing-observability instead.
- For prompt engineering techniques, use ai:
- developing-with-ai instead.
ソフトウェアエンジニアリングプラクティス
新しいプロジェクトを成功させるための基盤構築から、チーム組織設計、ペアプログラミング、 優れた開発者習慣まで、ソフトウェア開発の横断的プラクティスを体系化したガイド。
このスキルの使い方
| 状況 | 参照先 | |------|--------| | 新規プロジェクト開始時の基盤設計 | FOUNDATIONS.md | | チーム組織設計・チームトポロジー | TEAM-ORGANIZATION.md | | ペアプログラミング導入・パターン選択 | TEAM-ORGANIZATION.md | | 開発者習慣の確立・悪習慣の排除 | DEVELOPER-HABITS.md | | IC効果性マインドセット・アウトカム思考 | EFFECTIVENESS-MINDSET.md | | キャリア成長・昇進・IC vs Management パス | CAREER-GROWTH.md | | PM/デザイナー協働・権限なきリーダーシップ | INFLUENCE-LEADERSHIP.md | | 個人・チームのアンチパターン検出・対処 | ANTI-PATTERNS.md | | バーンアウト防止・リモートワーク・エネルギー管理 | SUSTAINABLE-PERFORMANCE.md | | AI日常統合ワークフロー・チームAI採用計画 | AI-ENHANCED-WORKFLOW.md |
他スキルとの差別化
| スキル | 扱う内容 |
|--------|---------|
| 本スキル | プロジェクト基盤・チーム組織・ペアプロ・開発者習慣・IC効果性・キャリア・影響力・アンチパターン・持続可能性・AI活用 |
| testing-code | TDD/BDD/ATDD の具体的手法・テスト設計 |
| writing-clean-code | SOLID原則・コードスメル・リファクタリング手法 |
| cloud:practicing-devops | Deployment Pipeline設定・CI/CD具体構成 |
| applying-clean-architecture | DDD・Clean Architecture・マイクロサービス |
| ai:developing-with-ai | AIコーディングツール活用・プロンプトエンジニアリング・LLM対話設計 |
| pursuing-simplicity | 自己誘発の複雑化を認識して削る判断（Orient-Step-Learn・S vs C ルーブリック）、技術ミニマリズム（依存/FW/機能）、個人の自動化と環境習熟、シンプリシティ志向のソフトスキル、データ駆動の簡素化 |
クイックスタート
新規プロジェクト開始
1. ビジョン作成 → Fast Feedback ループ確立 → Walking Skeleton 構築
2. Deployment Pipeline（最小版）を最初のフィーチャーと同時に構築
3. DORA メトリクス（Throughput / Stability）計測開始
4. チーム構造を確定
チーム組織設計
1. Stream-Aligned Team を中心に設計（大多数のチームがこれ）
2. Platform Team は Stream-Aligned Team の自律性を高める目的のみ
3. Enabling Team は専門知識の一時的な貸し出し役
4. チームサイズ: 5〜9人を目標
AskUserQuestion: チーム構造選択
チーム構造を設計する際は以下を確認すること:
機能横断チーム vs コンポーネントチーム — どちらが適しているかはプロジェクト規模と依存構造による:
- 小〜中規模プロジェクト → 全員が全体を担う機能横断チーム
- 大規模・複雑なシステム → Stream-Aligned + Platform + Enabling の3層構成
AskUserQuestion: ペアプログラミングパターン選択
用途に応じてパターンを使い分けること:
- 通常の開発 → Driver & Navigator（デフォルト）
- TDD実践時 → Ping Pong
- ナレッジ移転・オンボーディング → Strong-Style
- ❌ Parent-Child は避けるべきアンチパターン
概要
プロジェクト基盤（FOUNDATIONS.md）
- Fast Feedback: ビルド・テスト・デプロイ・プロダクションからの高速フィードバック
- 学習最適化: レトロスペクティブ・実験的アプローチ・エビデンス基盤の意思決定
- 小さなステップ: Walking Skeleton から始め、インクリメンタルに拡大
- 目標設定: TIME か SCOPE を固定（両方同時は禁止）
- 計測: DORA メトリクス（Throughput / Stability）を最初期から導入
チーム組織（TEAM-ORGANIZATION.md）
- チームサイズ: 5〜9人。認知負荷と通信複雑性を最小化
- チームトポロジー: Stream-Aligned / Enabling / Complex Subsystem / Platform
- Platform Team の原則: Stream-Aligned Team の自律性向上が目的
- ペアプログラミング: 4つのパターン + Pair Rotation + 成功のコツ
開発者習慣（DEVELOPER-HABITS.md）
- GREAT Habits: Code as Communication / エンジニア思考 / 設計としてのコーディング / 品質優先 / チームワーク / 小さなステップ
- よくある落とし穴: Happy Path 思考 / コードオーナーシップ / 責任回避 / 変更恐怖 / ツール崇拝 / 神話への執着
IC効果性マインドセット（EFFECTIVENESS-MINDSET.md）
- アウトカム思考: アウトプット（コード・機能）ではなくアウトカム（ユーザー行動変化・ビジネス指標）で仕事を評価する判断フレームワーク
- 生産性 vs 効果性: 4つの作業領域（機能開発・バグ修正・技術的負債・コラボレーション）での判断軸の違い
- 高レバレッジ行動: 複利効果をもたらす行動（ドキュメント・メンタリング・プロセス改善）の特定と優先
キャリア成長とレベルアップ（CAREER-GROWTH.md）
- キャリアステージ別スキルマトリクス: Junior（L3）→ Staff（L6+）の各段階で求められるスコープ・自律性・技術的意思決定・リーダーシップの変化
- IC vs Engineering Management パス: Technical Track（Staff/Principal/Distinguished Engineer）vs Management Track の適性・評価・転換ポイント
- 昇進戦略: スポンサーシップ獲得・可視性向上・影響範囲の拡大を具体的に計画する方法
影響力・ICリーダーシップ（INFLUENCE-LEADERSHIP.md）
- PM/デザイナーとの協働チェックリスト: 要件理解→技術インサイト提供→関係構築の3フェーズで機能横断チームを動かす方法
- 権限なきリーダーシップ: 影響力の構成要素（信頼×コミュニケーション×証拠）と具体的な実践手法
- 技術意思決定の影響力: RFC・ADR・技術ロードマップを使った組織横断での意思決定への参画方法
アンチパターン集（ANTI-PATTERNS.md）
- 個人レベル（IC）15パターン: Knowledge Silos・Hero Complex・Over-Engineering・Analysis Paralysis・Perfectionism 等の検出シグナルと対処法
- チームレベル5パターン: Rubber Stamping・Low Bus Factor・形骸化レトロ等、チームの効果性を阻む構造的問題
- 早期検出アプローチ: 各アンチパターンの兆候を素早く発見し、チームに影響が広がる前に介入する判断基準
持続可能なパフォーマンス（SUSTAINABLE-PERFORMANCE.md）
- バーンアウト認識と回復: 6カテゴリの診断シグナル表・回復フロー（休暇→マネージャー対話→専門サポート）
- エネルギー管理5実践: Pomodoro サイクル・マイクロ休憩・罪悪感なきバケーション・身体的健康・コーディング以外の趣味
- リモートワーク実践: 非同期コミュニケーションリズム・孤独感対策・仕事と生活の境界設定
AI活用ワークフロー（AI-ENHANCED-WORKFLOW.md）
- AIの得意/苦手タスク: ボイラープレート生成・テスト初稿・マイグレーション等のAI向けタスクと、アーキテクチャ判断・セキュリティ実装等の人間主導タスクの分類
- 1日のAI統合ワークフロー: 計画/設計（ADR ブレインストーミング）・実装（コンテキスト管理）・レビュー・メンタリングまで、フェーズ別AI活用プロンプトパターン
- 90日チームAI採用ロールアウト: Month 1（個人実験）→ Month 2（共有と標準化）→ Month 3（プロセス組み込み）の段階的チーム展開計画
Related Skills
sumik5/developing-fastapi
tools
VerifiedTrustedCommunity
FastAPI (Python) web API development guide covering fundamentals (routing, path/query params, Pydantic models, request/response, error handling), data persistence (SQLAlchemy, SQLModel, async DB, MongoDB, CRUD, Alembic migrations), dependency injection (Depends, dependency_overrides, scopes/lifespan), auth & security (OAuth2, JWT, CORS), async & concurrency (async/await, Starlette, BackgroundTasks, WebSocket, SSE/streaming), testing (TestClient, pytest, httpx, mocking), production deployment & scaling (uvicorn/gunicorn, Docker, optimization), generative-AI services (model serving, streaming, concurrency), and microservice/GraphQL/OpenAPI patterns. MUST load when fastapi is in pyproject.toml/requirements.txt or .py files import fastapi. For Python language/tooling fundamentals (uv/ruff/mypy, packaging, non-FastAPI patterns), use lang:developing-python. For REST/HTTP-spec design, versioning, and API test strategy, use developing-web-apis. For Node.js/Fastify backend services, use building-nodejs-services.
1SKILL.mdUpdated Jul 21, 2026
sumik5/collecting-studying-exams
development
VerifiedTrustedCommunity
studying（スタディング, member.studying.jp）のコースレッスン一覧URLから、配下の「スマート問題集」 「セレクト過去問集（学科試験対策・実技試験対策）」の全問題（問題文・選択肢・正解・解説）を科目単位で 取得し、1科目1JSONファイルに保存する。出力は creating-flashcards スキルへ渡して科目ごとに Anki フラッシュカード化できる。 Use when studying のコースレッスン一覧URL（https://member.studying.jp/course/id/<course_id>/ 形式） を渡され「問題を全部保存したい」「Anki カードにしたい」等と言われたとき。 補足トリガー: studying, スタディング, 資格試験, スマート問題集, セレクト過去問集, 問題集, JSON 保存, Anki 連携。 ブラウザ操作自体の汎用ガイドは web:automating-browser、E2E テストは web:testing-e2e-with-playwright を使う。本スキルは studying 専用の収集ワークフロー + bundled script（scripts/collect-studying.sh） ＋ログイン認証を提供する。
1SKILL.mdUpdated Jul 21, 2026
sumik5/collecting-whizlabs-exams
development
VerifiedTrustedCommunity
Whizlabs のコース practice test 一覧URLから、配下の全クイズ（Free Test・Practice Test 1〜N 等）を practice mode で巡回し、各問題（問題文・選択肢・正解・解説・参考資料）を取得して 1 クイズ 1 JSON ファイルに 保存する。出力は creating-flashcards スキルへ渡してクイズごとに Anki フラッシュカード化できる。 Use when Whizlabs のコースURL（/learn/course/<slug>/<course-id>/pt 形式）を渡され 「問題を全部保存したい」「Anki カードにしたい」等と言われたとき。 補足トリガー: whizlabs, ホイズラボ, 資格試験, 問題集, practice test, quiz 収集, JSON 保存, Anki 連携。 ブラウザ操作自体の汎用ガイドは web:automating-browser、E2E テストは web:testing-e2e-with-playwright を使う。 本スキルは Whizlabs 専用の収集ワークフロー + bundled script（scripts/collect-whizlabs.sh）＋ ログイン認証（agent-browser Auth Vault）を提供する。
1SKILL.mdUpdated Jul 20, 2026
sumik5/developing-flutter-apps
development
VerifiedTrustedCommunity
Guides production Flutter app development with Dart targeting iOS, Android, web, and desktop from a single codebase, including project setup, the widget system (Stateless/Stateful, Material and Cupertino), layout, theming and animation, state management (setState, Provider, Riverpod, BLoC/Cubit, Redux, GetX), navigation and routing (Navigator, go_router, auto_route), networking and backends (http, dio, REST, Firebase, GraphQL), local persistence, responsive multi-platform design, architecture patterns (Clean Architecture, BLoC, MVVM), the pub.dev package ecosystem, widget and integration testing, performance optimization, and build and store release. REQUIRED when creating, implementing, modifying, testing, or shipping a Flutter app, or when pubspec.yaml lists the flutter SDK. For the Dart language itself (types, null safety, OOP, async, collections), use developing-dart. For native iOS/iPadOS apps in Swift/SwiftUI, use developing-ios-apps. For Apple HIG UI/UX decisions, use applying-apple-hig.
1SKILL.mdUpdated Jul 16, 2026