orchestrating-analysis

name	orchestrating-analysis
description	分析フェーズ全体のワークフローをオーケストレーション。戦略→要件定義→機能要件→非機能要件の順序で各 analyzing-* スキルの実行を案内。分析フェーズの開始、全体像の把握、次に何を分析すべきかの判断、分析の進め方の相談時に使用。「分析を始めたい」「要件定義の次は何？」「設計ドキュメントを一通り作りたい」といった場面で発動する。

分析フェーズオーケストレーション

分析フェーズ全体の作業順序を案内する。各工程には専門の analyzing-* スキルがあるため、このスキルの役割は「何を・どの順序で・なぜその順序で」進めるかを示すことにある。

開発ガイド（@docs/reference/開発ガイド.md）の分析セクションに定義されたフローに準拠する。

分析フェーズの構成

分析は 戦略 → 要件定義 → 機能要件 → 非機能要件 の 4 段階で進める。各段階の出力が次の段階の入力になるため、この順序を守ることが品質を確保する上で重要になる。

段階 1: 戦略

プロジェクトの「なぜ・何を・どうやって」を明確にする。ここが曖昧だと後工程すべてがブレるため、最初に固める。

工程	スキル	成果物
ビジネスアーキテクチャ分析	analyzing-business-architecture	ビジネスモデルキャンバス、バリューストリーム、ケイパビリティマップ
インセプションデッキ作成	analyzing-inception-deck	10 の問いへの回答、概念アーキテクチャ、マイルストーン

段階 2: 要件定義

システムが解決すべき問題と境界を定義する。RDRA 2.0 の体系に従い、システム価値→外部環境→境界の順で分析を進める。

工程	スキル	成果物
要件定義	analyzing-requirements	システムコンテキスト、要求モデル、業務フロー
ユースケース・ユーザーストーリー	analyzing-usecases	ビジネスユースケース、システムユースケース、ユーザーストーリー

段階 3: 機能要件

要件をどう実現するかの設計を行う。アーキテクチャが決まらないとデータモデルやドメインモデルの粒度が定まらないため、アーキテクチャ設計を先に行う。

工程	スキル	成果物
アーキテクチャ設計	analyzing-architecture	バックエンド・フロントエンド・インフラ設計
データモデル設計	analyzing-data-model	ER 図、テーブル定義
ドメインモデル設計	analyzing-domain-model	エンティティ、値オブジェクト、集約
UI 設計	analyzing-ui-design	画面遷移図、画面イメージ

段階 4: 非機能要件

システムの品質特性と運用方針を定義する。機能要件が見えた段階で策定することで、現実的な要件を設定できる。

工程	スキル	成果物
テスト戦略	analyzing-test-strategy	テストピラミッド、テスト種別、カバレッジ目標
非機能要件	analyzing-non-functional	性能・セキュリティ・可用性・保守性要件
運用要件	analyzing-operation	運用フロー、監視設計、障害対応手順

横断: 技術スタック・ADR

技術スタック選定とアーキテクチャ決定記録は、分析の進行に応じて随時実施する。

工程	スキル	成果物
技術スタック選定	analyzing-tech-stack	技術選定・評価結果
ADR 作成	creating-adr	Architecture Decision Record

進め方

現状を確認してから始める

分析を開始する前に、プロジェクトの現状を把握する。既存のドキュメントやコードがある場合、ゼロから始める必要はない。

1. docs/ 配下の既存ドキュメントを確認
2. docs/design/ 配下の設計ドキュメントの有無を確認
3. 未着手の工程を特定し、次のアクションを提案

途中から再開する場合

すべての工程を最初から実施する必要はない。既に完了している工程はスキップし、未着手または更新が必要な工程から再開する。

Example:

ユーザー: 「要件定義は終わった。次は何をすればいい？」
回答: 段階 3（機能要件）のアーキテクチャ設計から開始。
      analyzing-architecture スキルを使ってアーキテクチャ設計を進める。

工程間のフィードバック

分析は一方通行ではない。後工程の検討で前工程の見直しが必要になることがある。たとえば、データモデル設計中に要件の不足に気づいた場合は、要件定義に戻って補完する。

コンテキスト管理

分析フェーズは多くの工程を含むため、長時間セッションになりやすい。以下のタイミングで /compact を実施し、コンテキストを圧縮する。

• 分析工程 1 件が完了したとき
• 設計ドキュメント 1 件の作成・更新が完了したとき
• コミット完了後、次の工程に着手する前

/compact 実施前に、現在の作業状態と次の工程をメモとして出力する。これにより、圧縮後も作業の連続性を保てる。

注意事項

• 分析結果は開発フェーズで継続的に見直す。完璧を目指して分析を長引かせるより、十分な品質で開発に進み、フィードバックで改善する方が効果的
• 各工程の成果物は docs/ 配下に Markdown + PlantUML で文書化する
• リリース計画（planning-releases）は分析フェーズの最後に、技術スタック選定後に実施する