docs-workflow-bootstrap

ドキュメントワークフローの初期構築

目的

後続のステージで参照できる信頼性の高いドキュメントを用意するため、最小限のワークフローの骨組みを作成します。

使用する場合

• 最小限の骨組みファイルが1つ以上不足している場合
• リポジトリがこのドキュメント主導のワークフロー用に初期化されていない場合
• 基本となるドキュメントの入口がまだ存在しないため、後続のステージで状態を復元できない場合

使用しない場合

• 最小限の骨組みがすでに存在する場合
• 現在の作業がロードマップの分解、タスク固有の設計、または実行である場合
• ユーザーが初期構築中に実装タスク、仕様、計画、またはコード変更を求めている場合

最初に読むもの

• 既存の docs/ ファイル（ある場合）
• リポジトリのドキュメント言語に関する手がかり（ある場合）
• 現在のユーザープロンプト

担当する内容

• 最小限の骨組みの有無の確認
• 最小限のワークフロー入口ドキュメントの作成
• 初期構築中に明示的に依頼された場合に限り、計画インボックスに目標を簡潔に記録
• 初期構築のレビュー時に停止し、引き継ぎ先を提案

担当しない内容

• マイルストーンの分解
• 実装タスクの作成
• タスク固有の spec.md または plan.md
• 実装またはブランチのワークフロー
• 骨組みドキュメントにロードマップや実行の詳細を詰め込みすぎること

開始時の確認事項

不足している場合に限り、次のファイルを作成します。

• docs/index.md
• docs/architecture/index.md
• docs/tasks/index.md
• docs/tasks/planning-inbox.md
• docs/tasks/backlog.md
• docs/context/index.md

リポジトリにドキュメントの言語ルールがある場合は、それに従います。ない場合は、現在のユーザーの使用言語に従います。

デフォルトのフロー

1. 不足している最小限の骨組みファイルを確認します。
2. 不足しているワークフローの入口だけを作成します。
3. 内容は最小限にし、ナビゲーションを中心にします。
4. ユーザーが初期構築中にロードマップのような入力の保持を明示的に依頼した場合に限り、計画インボックスに目標の概要を簡潔に記録します。
5. 作成または変更したファイルを報告した後、初期構築のレビュー時に停止します。

境界ルール

• 初期構築で扱うのは、ドキュメントガバナンスのみです。
• デフォルトでは、マイルストーン、モジュール、タスク、spec.md、plan.md、docs/specs/、または docs/plans/ を作成しないでください。
• 初期構築中に、幅広いユーザー要件をタスク分解に変換しないでください。
• planning-inbox.md に目標の概要を簡潔に記録してもかまいませんが、マイルストーンの分解は行いません。
• 後続のステージで整理し直すための作業が発生しないよう、骨組みドキュメントは小さく保ちます。

進行できない場合

• 最小限の骨組みがすでに存在するものの、次のステージが不明な場合は、doc-driven-spec-workflow に引き継ぎます。
• 初期構築中にユーザーがロードマップの計画を求めた場合は、最小限の骨組みを完成させてから、milestone-planning を提案します。
• 初期構築中にユーザーが具体的なタスクの実行を求めた場合、リポジトリに確認済みのロードマップ状態がすでに存在しない限り、直接その作業に進まないでください。

レビューとフォローアップ

• 作成または変更したファイルを報告した後、初期構築のレビュー時に停止します。
• レビュー後に明確な前進の指示があれば、通常のフォローアップを進める許可として扱います。
• レビュー後のデフォルトのフォローアップは次のとおりです。
  • レビュー済みの骨組みドキュメントをコミットします
  • ただし、ユーザーがコミットしないよう明示的に依頼した場合を除きます
  • その後、次のステージを選択できるよう doc-driven-spec-workflow に戻ります
• ユーザーがその進行経路を明示的に依頼した場合に限り、別のステージへ直接進みます。

出力

• 作成したファイル
• 変更したファイル
• 保持した計画インボックスの目標の概要（ある場合）
• 推奨する次のスキル

停止地点

• 初期構築のレビュー時

引き継ぎ

• Decided
• Undecided
• Next skill
• Stop point

参考資料

• 最小限の骨組みドキュメントの形式には、references/scaffold-template.md を使用します。