qcsd-ideation-swarm

QCSD アイデエーションスウォーム v7.0

PI プランニングとスプリントプランニングのための、シフトレフト型品質エンジニアリングスウォームです。

---

概要

アイデエーションスウォームは、開発開始前にストーリーと URL を評価します。HTSM v6.3 の品質基準、リスクストーミング、テスト容易性分析を使用します。GO／CONDITIONAL／NO-GO の判定を出力し、QCSD ライフサイクルの最初のゲートとなります。

QCSD フェーズでの位置付け

フェーズ	スウォーム	判定	タイミング
アイデエーション	qcsd-ideation-swarm	GO / CONDITIONAL / NO-GO	PI／スプリントプランニング
リファインメント	qcsd-refinement-swarm	READY / CONDITIONAL / NOT-READY	スプリントリファインメント
開発	qcsd-development-swarm	SHIP / CONDITIONAL / HOLD	スプリント中
検証	qcsd-cicd-swarm	RELEASE / REMEDIATE / BLOCK	リリース前／CI-CD
本番	qcsd-production-swarm	HEALTHY / DEGRADED / CRITICAL	リリース後

パラメーター

• URL：分析するウェブサイト（URL モードでは必須）
• OUTPUT_FOLDER：レポートの保存先（デフォルト：${PROJECT_ROOT}/Agentic QCSD/{domain}/）

独自の機能

• URL モード：ライブウェブサイト分析用の自動 5 段階ブラウザーカスケード
• HAS_VIDEO フラグ：動画コンテンツを検出し、/a11y-ally によるフォローアップを推奨
• HTML 出力：html_output: true の場合、HTML レポートを生成
• ブラウザーカスケード：Vibium -> agent-browser -> Playwright+Stealth -> WebFetch -> WebSearch-fallback

---

適用ルール — 最初にお読みください

ルール	適用内容
E1	ステップ 2 では、必ず 3 つのコアエージェント（qe-quality-criteria-recommender、qe-risk-assessor、qe-requirements-validator）をすべて起動してください。例外はありません。
E2	並列実行するすべての Task 呼び出しは、必ず 1 つのメッセージにまとめてください。
E3	各バッチの後は必ず停止して待機してください。先に進んではいけません。
E4	フラグが TRUE の場合は、必ず条件付きエージェントを起動してください。省略してはいけません。
E5	ステップ 5 で指定された GO／CONDITIONAL／NO-GO の判定ロジックを、必ずそのとおりに適用してください。
E6	必ず完全なレポート構成を生成してください。短縮版は使用できません。
E7	各エージェントは、分析前に必ず参照ファイルを読み込んでください。
E8	必ずステップ 7 の学習内容の永続化を実行してください。省略してはいけません。

禁止されている行動：

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

---

ステップ実行プロトコル

このスキルでは、マイクロファイル方式のステップアーキテクチャを採用しています。「途中で忘れる」ことによるコンテキスト劣化を防ぐため、各ステップは個別のファイルとして一度に 1 つずつ読み込みます。

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

ステップ

1. フラグの検出 -- steps/01-flag-detection.md -- URL コンテンツを取得（ブラウザーカスケード）し、7 つのフラグをすべて検出（HAS_UI、HAS_SECURITY、HAS_UX、HAS_VIDEO、HAS_MIDDLEWARE、HAS_SAP_INTEGRATION、HAS_AUTHORIZATION）
2. コアエージェント -- steps/02-core-agents.md -- qe-quality-criteria-recommender、qe-risk-assessor、qe-requirements-validator を並列で起動
3. バッチ 1 の結果 -- steps/03-batch1-results.md -- コアエージェントの完了を待ち、すべての指標を抽出
4. 条件付きエージェント -- steps/04-conditional-agents.md -- フラグが立った条件付きエージェントを並列で起動
5. 判定の統合 -- steps/05-decision-synthesis.md -- GO／CONDITIONAL／NO-GO の判定ロジックを適用
6. レポートの生成 -- steps/06-report-generation.md -- エグゼクティブサマリーと完全なレポートを生成
7. 学習内容の永続化 -- steps/07-learning-persistence.md -- 調査結果をメモリに保存し、永続化レコードを保存して、動画のフォローアップ推奨を含める
8. 最終出力 -- steps/08-final-output.md -- すべてのスコアとフォローアップ推奨事項を含む完了サマリーを表示

実行手順

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

再開のサポート

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

---

エージェント一覧

エージェント	種類	領域	バッチ
qe-quality-criteria-recommender	コア（常時）	要件検証	1
qe-risk-assessor	コア（常時）	カバレッジ分析	1
qe-requirements-validator	コア（常時）	要件検証	1
qe-accessibility-auditor	条件付き（HAS_UI）	ビジュアルアクセシビリティ	2
qe-security-auditor	条件付き（HAS_SECURITY）	セキュリティコンプライアンス	2
qe-qx-partner	条件付き（HAS_UX）	ドメイン横断	2
qe-middleware-validator	条件付き（HAS_MIDDLEWARE）	エンタープライズ統合	2
qe-sap-rfc-tester	条件付き（HAS_SAP_INTEGRATION）	エンタープライズ統合	2
qe-sod-analyzer	条件付き（HAS_AUTHORIZATION）	エンタープライズ統合	2

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

注：Ideation スウォームには、独立した最終分析エージェントのステップがないため、ステップは 9 つではなく 8 つです。HAS_VIDEO フラグは /a11y-ally の追加推奨をトリガーしますが、エージェントは追加で起動しません。

---

品質ゲートのしきい値

指標	GO	CONDITIONAL	NO-GO
テスト可能性スコア	>= 70%	40 - 69%	< 40%
リスクスコア	LOW/MEDIUM	HIGH（軽減可能）	CRITICAL
要件の完全性	>= 80%	50 - 79%	< 50%
品質基準のカバレッジ	>= 7/10 カテゴリー	4-6/10 カテゴリー	< 4/10 カテゴリー

---

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

エージェント	レポートファイル名	ステップ
qe-quality-criteria-recommender	02-quality-criteria.md	2
qe-risk-assessor	03-risk-assessment.md	2
qe-requirements-validator	04-requirements-validation.md	2
qe-accessibility-auditor	05-accessibility-audit.md	4
qe-security-auditor	06-security-audit.md	4
qe-qx-partner	07-ux-assessment.md	4
qe-middleware-validator	08-middleware-assessment.md	4
qe-sap-rfc-tester	09-sap-assessment.md	4
qe-sod-analyzer	10-sod-compliance.md	4
Learning Persistence	11-learning-persistence.json	7
Synthesis	01-executive-summary.md	6

---

実行モデルの選択肢

モデル	使用する場合	エージェントの起動
Task Tool（PRIMARY）	Claude Code セッション	Task({ subagent_type, run_in_background: true })
MCP Tools	MCP サーバーが利用可能	fleet_init({}) / task_submit({})
CLI	ターミナル／スクリプト	swarm init / agent spawn

---

重要な原則

品質は最後にテストするのではなく、最初から作り込むものです。このスウォームは、コードを書く前にストーリーの実現可能性、テスト可能性、リスクを評価します。