qcsd-development-swarm

QCSD Development Swarm v1.0

スプリント内のコード品質保証を実現する、シフトレフト型の品質エンジニアリングスウォームです。

---

概要

Development Swarm は、精緻化済みのストーリー（Refinement に合格したもの）を受け取り、スプリントの実行中にコード品質を検証します。Ideation Swarm が「これを構築すべきか？」と問い、Refinement Swarm が「これをどのようにテストすべきか？」と問うのに対し、Development Swarm は「出荷するのに十分なコード品質があるか？」と問います。

QCSD フェーズでの位置づけ

フェーズ	スウォーム	判定	タイミング
Ideation	qcsd-ideation-swarm	GO / CONDITIONAL / NO-GO	PI / スプリント計画
Refinement	qcsd-refinement-swarm	READY / CONDITIONAL / NOT-READY	スプリントのリファインメント
Development	qcsd-development-swarm	SHIP / CONDITIONAL / HOLD	スプリント中
Verification	qcsd-cicd-swarm	RELEASE / REMEDIATE / BLOCK	リリース前 / CI-CD
Production	qcsd-production-swarm	HEALTHY / DEGRADED / CRITICAL	リリース後

パラメーター

• SOURCE_PATH：分析対象のソースコードディレクトリ（必須。例：src/auth/）
• TEST_PATH：カバレッジ分析対象のテストディレクトリ（任意。例：tests/auth/）
• OUTPUT_FOLDER：レポートの保存先（デフォルト：${PROJECT_ROOT}/Agentic QCSD/development/）

---

強制ルール - 最初に読むこと

ルール	適用事項
E1	Step 2 では、コアエージェント3つすべて（qe-tdd-specialist、qe-code-complexity、qe-coverage-specialist）を必ず起動してください。例外はありません。
E2	並列で実行する Task 呼び出しは、すべて単一のメッセージに含めてください。
E3	各バッチの後は必ず停止して待機してください。先に進んではいけません。
E4	フラグが TRUE の場合は、条件付きエージェントを必ず起動してください。省略してはいけません。
E5	Step 5 で指定された SHIP / CONDITIONAL / HOLD の判定ロジックを必ず適用してください。
E6	レポートの全構成を必ず生成してください。簡略版にしてはいけません。
E7	各エージェントは、分析前に必ず参照ファイルを読み込んでください。
E8	Step 8 では、すべてのコード変更に qe-defect-predictor の分析を必ず適用してください。常に実行してください。
E9	Step 7 の学習結果の永続化を必ず実行してください。省略してはいけません。

禁止事項：

• エージェントを起動せずに要約すること
• 「簡潔にするため」といった理由でエージェントを省略すること
• バックグラウンドタスクの完了前に先へ進むこと
• 専門エージェントを起動せず、自分で分析すること
• レポートのセクションを省略したり、プレースホルダーテキストを使用したりすること

---

ステップ実行プロトコル

このスキルでは、マイクロファイルによるステップアーキテクチャを採用しています。「途中の情報が失われる」ことによるコンテキストの劣化を避けるため、各ステップは自己完結したファイルとして、一度に1つずつ読み込みます。

Read ツールで各ステップファイルを読み込み、順番に実行してください。

ステップ

1. フラグ検出 -- steps/01-flag-detection.md -- ソースコードとテストをスキャンし、6つのフラグをすべて検出します
2. コアエージェント -- steps/02-core-agents.md -- qe-tdd-specialist、qe-code-complexity、qe-coverage-specialist を並列で起動します
3. バッチ1の結果 -- steps/03-batch1-results.md -- コアエージェントを待ち、すべてのメトリクスを抽出します
4. 条件付きエージェント -- steps/04-conditional-agents.md -- フラグが立った条件付きエージェントを並列で起動します
5. 判定の統合 -- steps/05-decision-synthesis.md -- SHIP / CONDITIONAL / HOLD の判定ロジックを適用します
6. レポート生成 -- steps/06-report-generation.md -- エグゼクティブサマリーと完全なレポートを生成します
7. 学習結果の永続化 -- steps/07-learning-persistence.md -- 分析結果をメモリに保存し、永続化記録を保存します
8. 欠陥予測 -- steps/08-defect-predictor.md -- すべてのコード変更に対して qe-defect-predictor の分析を実行します
9. 最終出力 -- steps/09-final-output.md -- すべてのスコアを含む完了サマリーを表示します

実行手順

1. Read ツールを使用して、現在のステップファイルを読み込みます（例：Read({ file_path: ".claude/skills/qcsd-development-swarm/steps/01-flag-detection.md" })）
2. ステップの指示をすべて実行します
3. 次に進む前に、成功条件がすべて満たされていることを確認します
4. ステップの出力をコンテキストとして次のステップに渡します
5. ステップが失敗した場合は、処理を停止して失敗箇所を報告します。先へ進んではいけません

---

再開のサポート

特定のステップから再開するには、--from-step N を指定すると、オーケストレーターはステップ N までスキップします。前のステップで得られる必要な前提データがそろっていることを確認してください。

---

エージェント一覧

エージェント	種別	領域	バッチ
qe-tdd-specialist	コア（常時）	テスト生成	1
qe-code-complexity	コア（常時）	コードインテリジェンス	1
qe-coverage-specialist	コア（常時）	カバレッジ分析	1
qe-security-scanner	条件付き（HAS_SECURITY_CODE）	セキュリティコンプライアンス	2
qe-performance-tester	条件付き（HAS_PERFORMANCE_CODE）	カオスレジリエンス	2
qe-mutation-tester	条件付き（HAS_CRITICAL_CODE）	テスト生成	2
qe-message-broker-tester	条件付き（HAS_MIDDLEWARE）	エンタープライズ統合	2
qe-sap-idoc-tester	条件付き（HAS_SAP_INTEGRATION）	エンタープライズ統合	2
qe-sod-analyzer	条件付き（HAS_AUTHORIZATION）	エンタープライズ統合	2
qe-defect-predictor	分析（常時）	欠陥インテリジェンス	3

合計：10 エージェント（コア 3 + 条件付き 6 + 分析 1）

---

品質ゲートのしきい値

指標	SHIP	CONDITIONAL	HOLD
TDD 遵守率	>= 80%	60 - 79%	< 60%
コード複雑度	平均 <= 10	平均 11-15	平均 > 15
テストカバレッジ	>= 80%	60 - 79%	< 60%
ミューテーションスコア	>= 70%	50 - 69%	< 50%
セキュリティ問題	HIGH/CRITICAL なし	MEDIUM のみ	HIGH/CRITICAL を検出

---

レポートファイル名の対応表

エージェント	レポートファイル名	ステップ
qe-tdd-specialist	02-tdd-analysis.md	2
qe-code-complexity	03-complexity-analysis.md	2
qe-coverage-specialist	04-coverage-analysis.md	2
qe-security-scanner	05-security-scan.md	4
qe-performance-tester	06-performance-analysis.md	4
qe-mutation-tester	07-mutation-testing.md	4
qe-message-broker-tester	08-middleware-health.md	4
qe-sap-idoc-tester	09-sap-integration.md	4
qe-sod-analyzer	10-sod-compliance.md	4
学習の永続化	11-learning-persistence.json	7
qe-defect-predictor	12-defect-prediction.md	8
統合	01-executive-summary.md	6

---

実行モデルの選択肢

モデル	使用する状況	エージェントの起動
Workflow（主要、ADR-102）	Workflow ツールを備えたハーネス	Workflow({ name: "qcsd-development-review", args: { sourcePath, testPath } })
Task Tool（代替）	Workflow をサポートしていない Claude Code セッション	Task({ subagent_type, run_in_background: true })
MCP Tools	MCP サーバーが利用可能	fleet_init({}) / task_submit({})
CLI	ターミナル／スクリプト	swarm init / agent spawn

ワークフロー実行（ADR-102）

.claude/workflows/qcsd-development-review.js は、レビューを決定論的なパイプラインとして実行します。品質の各側面（TDD の遵守状況、複雑度、カバレッジの不足）ごとに 1 つのファインダーを実行します（args.dimensions で対象を選択できます）。→ 各指摘に対して、互いの内容を知らない反証者 3 人が反証します（Loki-mode、ADR-074：反証者が見るのは主張そのものと証拠だけであり、ファインダーの確信度や他の反証者の内容は見ません。不確実な場合は反証とみなします）。→ finding-verdict@1 エンベロープ（ADR-103、schemas/finding-verdict.schema.json）に決定論的に統合します。指摘が残るのは、反証者のうちそれを棄却する人数が ⌈N/2⌉ 未満の場合のみです。最終レポートには確認済みの指摘のみを記載します。棄却された指摘は、監査用に反証内容とともに killed の下に保持されます。

引数：sourcePath（必須）、testPath、dimensions（tdd-adherence|complexity|coverage-gaps のサブセット）、ディメンションごとの maxFindings（デフォルトは 5）。

Workflow ツールが利用できない場合は、以下の Task ツールのプロトコルにフォールバックします。レポートの形式とゲートは同一ですが、敵対的検証の段階はありません（レポートのヘッダーに verification: none と記載してください）。

---

重要な原則

コード品質は意図ではなく証拠によって評価されます。このスウォームは、コードが CI/CD パイプラインに入る前にエンジニアリング基準を満たしていることを確認するため、スプリント内で品質評価を行います。