doc-driven-spec-workflow

ドキュメント主導の仕様策定ワークフロー

目的

次のステージのスキルを1つだけ選びます。ここではステージの作業を行いません。

使用するタイミング

• リポジトリがこのドキュメント主導のワークフローに従っている
• ユーザーは作業の続行を希望しているが、現在のステージが明確でない
• 新しい会話で、ドキュメントとプロンプトからワークフローの状態を把握し直す必要がある

最初に読むもの

1. docs/tasks/index.md
2. docs/tasks/planning-inbox.md
3. docs/tasks/backlog.md
4. docs/tasks/ 配下の関連するマイルストーン、モジュール、タスクのドキュメント
5. docs/architecture/
6. docs/context/
7. 現在のユーザープロンプト

ドキュメントがないことはルーティングの手掛かりであり、目標が不明確である証拠ではありません。

担当すること

• 現在のワークフローステージを特定する
• 次のステージのスキルを選ぶ
• 根拠が不十分な場合、ルーティングに必要な最小限の質問をする
• Decided、Undecided、Next skill、Stop point を引き継ぐ

担当しないこと

• スキャフォールド作成の詳細
• ロードマップ分解の詳細
• タスク固有の spec.md または plan.md の作成
• 実行環境の分離、実装、検証、ブランチのクローズ
• 選択されたステージのスキルが担当する個別の決定

ルーティング表

状況	次のスキル
最小限のドキュメントスキャフォールドが不足している	docs-workflow-bootstrap
ドキュメントまたはプロンプトに、未解決の目標、制約、成功基準、または今行うことと後で行うことの境界が示されている	planning-clarification
マイルストーンの構成、モジュールのグループ化、タスクの分解、または提供順序が不明確である	milestone-planning
具体的なタスクが選択されている、または確定済みのロードマップの状態から明確に選択できる	task-preparation

開始時の確認事項

• 次の最小限のスキャフォールドファイルのいずれかが欠けている場合は、docs-workflow-bootstrap にルーティングします。
  • docs/index.md
  • docs/architecture/index.md
  • docs/tasks/index.md
  • docs/tasks/planning-inbox.md
  • docs/tasks/backlog.md
  • docs/context/index.md
• 肯定的な曖昧さの根拠がある場合に限り、planning-clarification にルーティングします。ドキュメントが欠けている、または古いというだけでは不十分です。
• 次のすべてに当てはまる場合に限り、task-preparation にルーティングします。
  • マイルストーンの Roadmap confirmed: yes が設定されている
  • マイルストーンをまたぐ場合、前のマイルストーンのクローズが解決済みである
  • タスクのステータスが planned または in_progress である
  • 依存関係が満たされているか、明示的に免除されている
  • 進行を妨げる未解決のハードゲートがない
  • ユーザーがタスクを選択している、またはドキュメントで次のタスクが明確に示されている

デフォルトの流れ

1. 根拠の順序に従ってドキュメントを読み、最も強いルーティングの手掛かりを特定します。
2. 次のステージのスキルを1つだけ選びます。
3. 根拠が不十分な場合は、推測せず、ルーティングに必要な最小限の質問を1つします。
4. ステージ固有の決定ではなく、ステージのコンテキストのみを引き継ぎます。

停止地点

• 1つのステージスキルに引き継ぐ
• または、ルーティングに必要な最小限の質問を1つする

ブロックされた場合

• 根拠から次のステージを特定できない場合は、ルーティングに関する質問を1つします
• ユーザーに代わってルーティングの質問に答えないでください
• 仕様書を作成したり、ロードマップの構成をでっち上げたりして、不確実性を回避しないでください

引き継ぎ

• Current stage
• Why
• Decided
• Undecided
• Next skill
• Stop point