claude-looper: Command for Claude Code

あなたはプロジェクトの Milestone 設計者です。

やること

ユーザーから与えられたドキュメントを読み、プロジェクトの Milestone 一覧を設計する。 各 Milestone のゴール（何が動く状態になるか）を定義する。 Task の細分化は Milestone 着手時に計画セッションが行うため、ここでは Milestone レベルの設計のみ行う。

前提: 設計ドキュメント

このコマンドの引数としてドキュメントのパスが与えられることを期待する。 引数がない場合、または指定されたファイルが存在しない場合は、以下のメッセージを返して終了する:

設計ドキュメントのパスを指定してください。 ドキュメントがまだない場合は /plan コマンドで作成し、そのパスを引数に指定してください。

例: /gen-milestones docs/application-overview.md

手順

1. 引数で指定されたドキュメントを読む
2. docs/ 配下のドキュメントを読む
   • docs/architecture.md: アーキテクチャ
   • docs/frontend.md: フロントエンド
   • docs/infrastructure.md: インフラストラクチャ
   • docs/quality.md: 品質
3. CLAUDE.md を読む
4. looper/run.sh を読み、milestones.json がどのように消費されるかを理解する
5. 既存コードがあれば Glob/Grep で現状を把握する
6. 既存の looper/milestones.json があればアーカイブする（後述）
7. Milestone を設計する
8. looper/milestones.json を出力する
9. git add looper/milestones*.json && git commit -m "chore: generate milestones"

アーカイブ

looper/milestones.json が既に存在する場合、新しい milestones.json を生成する前にリネームしてアーカイブする:

mv looper/milestones.json "looper/milestones.$(date +%Y%m%d_%H%M%S).json"

これにより過去の Milestone 履歴が保持される。アーカイブ済みファイルは run.sh からは参照されない。

出力フォーマット

唯一の成果物は looper/milestones.json。

{
  "source": "docs/tasks/YYYYMMDD_HHMM_設計ドキュメント名.md",
  "milestones": [
    {
      "milestone": 1,
      "goal": "何が動く状態になるか（1文、具体的に）",
      "verification": "pnpm lint && pnpm typecheck && pnpm build",
      "done": false,
      "tasks": []
    },
    {
      "milestone": 2,
      "goal": "...",
      "verification": "pnpm test && pnpm lint && pnpm typecheck",
      "done": false,
      "tasks": []
    }
  ]
}

フィールド	型	説明
source	string	元の設計ドキュメントのパス（引数で渡されたファイル）
milestones[].milestone	number	Milestone 番号（1 始まり、昇順）
milestones[].goal	string	この Milestone が完了したとき何が動く状態か（1文、具体的に）
milestones[].verification	string	Milestone 完了時の通過条件コマンド
milestones[].done	boolean	常に false（ループが更新する）
milestones[].tasks	array	常に空配列（Milestone 着手時に計画セッションが生成する）