gsd-complete-milestone

マイルストーン {{version}} を完了としてマークし、milestones/ にアーカイブして、ROADMAP.md と REQUIREMENTS.md を更新します。

目的：リリース済みバージョンの履歴を作成し、マイルストーンの成果物（ロードマップと要件）をアーカイブして、次のマイルストーンに備えます。 出力：マイルストーンをアーカイブ（ロードマップと要件）し、PROJECT.md を更新して、Git タグを作成します。

<execution_context> 続行する前に、今すぐ次のファイルを読み込んでください。

• @{{PLATFORM_ROOT}}/get-shit-done/workflows/complete-milestone.md（メインワークフロー）
• @{{PLATFORM_ROOT}}/get-shit-done/templates/milestone-archive.md（アーカイブテンプレート） </execution_context>

**プロジェクトファイル：** - `.planning/ROADMAP.md` - `.planning/REQUIREMENTS.md` - `.planning/STATE.md` - `.planning/PROJECT.md`

ユーザー入力：

• バージョン：{{version}}（例：「1.0」、「1.1」、「2.0」）

complete-milestone.md のワークフローに従ってください。

0. 監査の確認：

   • .planning/v{{version}}-MILESTONE-AUDIT.md を確認します
   • 存在しない、または古い場合：先に {{COMMAND_PREFIX}}audit-milestone を実行するよう提案します
   • 監査ステータスが gaps_found の場合：先に {{COMMAND_PREFIX}}plan-milestone-gaps を実行するよう提案します
   • 監査ステータスが passed の場合：ステップ 1 に進みます

   ## Pre-flight Check
   
   {If no v{{version}}-MILESTONE-AUDIT.md:}
   ⚠ No milestone audit found. Run `{{COMMAND_PREFIX}}audit-milestone` first to verify
   requirements coverage, cross-phase integration, and E2E flows.
   
   {If audit has gaps:}
   ⚠ Milestone audit found gaps. Run `{{COMMAND_PREFIX}}plan-milestone-gaps` to create
   phases that close the gaps, or proceed anyway to accept as tech debt.
   
   {If audit passed:}
   ✓ Milestone audit passed. Proceeding with completion.
   

1. 準備状況の確認：

   • マイルストーン内のすべてのフェーズに完了済みの計画があることを確認します（SUMMARY.md が存在すること）
   • マイルストーンの範囲と統計を提示します
   • 確認を待ちます

2. 統計の収集：

   • フェーズ数、計画数、タスク数を数えます
   • Git の範囲、ファイル変更数、LOC を算出します
   • Git ログから期間を抽出します
   • 概要を提示し、確認を求めます

3. 成果の抽出：

   • マイルストーンの範囲内にあるすべてのフェーズの SUMMARY.md ファイルを読み取ります
   • 重要な成果を 4～6 件抽出します
   • 承認を求めて提示します

4. マイルストーンのアーカイブ：

   • .planning/milestones/v{{version}}-ROADMAP.md を作成します
   • ROADMAP.md からフェーズの詳細全体を抽出します
   • milestone-archive.md テンプレートに記入します
   • ROADMAP.md をリンク付きの1行要約に更新します

5. 要件のアーカイブ：

   • .planning/milestones/v{{version}}-REQUIREMENTS.md を作成します
   • v1 の要件をすべて完了としてマークします（チェックボックスにチェックを入れます）
   • 要件の結果（検証済み、調整済み、破棄）を記録します
   • .planning/REQUIREMENTS.md を削除します（次のマイルストーン用に新しいファイルを作成します）

6. PROJECT.md の更新：

   • リリース済みバージョンを記載した「Current State」セクションを追加します
   • 「Next Milestone Goals」セクションを追加します
   • 以前の内容を <details> 内にアーカイブします（v1.1 以降の場合）

7. コミットとタグ付け：

   • ステージング：MILESTONES.md、PROJECT.md、ROADMAP.md、STATE.md、アーカイブファイル
   • コミット：chore: archive v{{version}} milestone
   • タグ：git tag -a v{{version}} -m "[milestone summary]"
   • タグをプッシュするか確認します

8. 次のステップを提示：

   • {{COMMAND_PREFIX}}new-milestone — 次のマイルストーンを開始します（ヒアリング → 調査 → 要件 → ロードマップ）

<success_criteria>

• マイルストーンが .planning/milestones/v{{version}}-ROADMAP.md にアーカイブされている
• 要件が .planning/milestones/v{{version}}-REQUIREMENTS.md にアーカイブされている
• .planning/REQUIREMENTS.md が削除されている（次のマイルストーン用に新規作成）
• ROADMAP.md が1行のエントリーにまとめられている
• PROJECT.md が現在の状態に合わせて更新されている
• Git タグ v{{version}} が作成されている
• コミットが成功している
• 新しい要件の作成が必要であることを含め、ユーザーが次のステップを把握している </success_criteria>

<critical_rules>

• 最初にワークフローを読み込む： 実行前に complete-milestone.md を読み取ります
• 完了を確認する： すべてのフェーズに SUMMARY.md ファイルが必要です
• ユーザーの確認： 確認段階では承認を待ちます
• 削除前にアーカイブする： 元のファイルを更新または削除する前に、必ずアーカイブファイルを作成します
• 1行の要約： ROADMAP.md でまとめたマイルストーンは、リンク付きの1行にします
• コンテキスト効率： アーカイブにより、ROADMAP.md と REQUIREMENTS.md のサイズをマイルストーンごとに一定に保ちます
• 新しい要件： 次のマイルストーンは、要件の定義を含む {{COMMAND_PREFIX}}new-milestone で開始します </critical_rules>