roadmap

戦略ロードマップ管理

5 つのモードでプロジェクトのロードマップを管理します。ROADMAP.md と GitHub の実状を同期する、計画ファイルを一から作成する、新機能を 共同でブレインストーミングする、簡単なステータス概要を確認する、 またはヘルプを表示するモードです。

前提条件の確認

gh --version 2>/dev/null && gh auth status 2>/dev/null

gh がインストールされていない場合は、ユーザーに https://cli.github.com を案内します。認証されていない場合は、 gh auth login の実行を案内します。GitHub CLI が正常に動作し、 認証されていない状態で処理を進めてはいけません。

基本原則

CONTEXT.md はプロジェクトの憲法です。 すべてのモードで CONTEXT.md を読み、その中で定義された境界を尊重する必要があります。CONTEXT.md が存在する場合は、 最初に読み、すべての分析と推奨事項をその内容に沿って制約します。

推奨事項が CONTEXT.md の境界に違反する場合は、次の対応を行います。

1. 違反を明確に指摘する
2. どの境界を越えるのか説明する
3. 境界を尊重する代替案を提案する

モードの選択

ユーザーの入力からモードを判断します。 モードが指定されていない場合は、sync を既定とします。

引数	モード	目的
(なし)	sync	ROADMAP.md を GitHub と同期し、優先事項を提案する
sync	sync	既定のモードと同じ
generate	generate	CONTEXT.md と ROADMAP.md を一から作成する
brainstorm	brainstorm	創造的なアイデア出しセッション（読み取り専用）
status	status	読み取り専用の簡単な概要
help	help	利用可能なモードを表示する

モード：sync

ROADMAP.md を GitHub と同期し、優先順位を付けた提案を行います。これが主要なモードです。

1. gh CLI を使って、未完了の Issue、最近クローズされた Issue、マイルストーンを取得します
2. ROADMAP.md と CONTEXT.md を読みます
3. 古いセクション構成を確認します。見つかった場合は、正規の構成（Vision → Immediate Focus → Near-Term → Future → Completed → Boundaries）に移行するか、ユーザーに確認します
4. ROADMAP.md と GitHub の不一致（完了と記載されているが未完了の Issue、未完了と記載されているがクローズ済みの Issue、完全に欠落している Issue）を検出します
5. ROADMAP.md を更新します。不一致を修正し、クローズ済みの Issue を四半期ごとの小見出しの下にある「Completed Milestones」に移動します
6. effort/* ラベルのない未完了の Issue について、references/label-config.md のヒューリスティクスを使って LOE を見積もります
7. GitHub ラベルを同期します。不足しているラベルを作成し、ROADMAP.md のセクションに合わせて roadmap/* ラベルを追加または削除します
8. ROADMAP.md の Issue の行に LOE 指標（[S]、[M]、[L]）を追加します
9. 依存関係、影響と工数のバランス、テーマの一貫性、LOE のバランスに基づいて、優先順位付きの推奨事項を 3～5 件作成します
10. すべての変更と推奨事項の概要を提示します

詳しいワークフローの手順については、references/sync.md を参照してください。ラベルの定義と LOE のヒューリスティクスについては、references/label-config.md を参照してください。

モード：generate

新規プロジェクト、またはドキュメント化されていない プロジェクト用に、CONTEXT.md と ROADMAP.md を作成します。

1. どちらかのファイルが存在する場合は、再生成、マージ、中止のいずれにするかをユーザーに確認します
2. コードベースの構造、依存関係、エントリーポイント、機能を調査します
3. プロジェクトの境界（「明確に行わないこと」）を推測します。つまり、プロジェクトが 行わないことを特定します
4. 類似ツールや業界の状況について、外部情報を調査します
5. 中核となるアイデンティティ、技術的な境界、データの信頼できる情報源、対話モデル、検証基準を含む CONTEXT.md の草案を作成します
6. すべての GitHub Issue とマイルストーンを取得します
7. Issue を Immediate Focus、Near-Term、Future、Completed（四半期ごとに分類）に分類します
8. 未完了の Issue ごとに LOE を見積もり、effort/* ラベルを適用します
9. 正規の構成と LOE 指標を使って ROADMAP.md の草案を作成します
10. まず CONTEXT.md を書き、次に ROADMAP.md を書きます。両方に markdownlint を実行します。

詳しいワークフローの手順とテンプレートについては、 references/generate.md を参照してください。LOE のヒューリスティクスについては、 references/label-config.md を参照してください。

モード：ブレインストーミング

共同でアイデアを出し合い、新たな可能性を探ります。このモードはデフォルトで読み取り専用です。ユーザーが明示的に承認するまで、イシューを作成したり、ROADMAP.md を変更したりしないでください。

1. 現状と境界を把握するため、CONTEXT.md と ROADMAP.md を読みます
2. コードベースを調査し、拡張ポイント、十分に活用されていない機能、新機能の余地を探します
3. 類似ツール、ユーザーからの要望、トレンドについて外部で調査します
4. 次のような問いかけを使い、ユーザーとアイデアを出し合います：「もし〜だったら？」「ほかにどんな人が使う？」「なぜ〜しないの？」「何が足りない？」「何に困っている？」
5. 各アイデアを評価します：CONTEXT.md に照らした境界の確認、工数、影響、依存関係
6. 構造化された形式でアイデアを提示します（説明、理由、境界の確認、工数、影響、次のステップ）
7. どのアイデアを正式なものにするかユーザーに尋ねます。イシューの作成や ROADMAP.md の更新は、その後にのみ行います

詳しいワークフローの手順とアイデアのテンプレートについては、 references/brainstorm.md を参照してください。

モード：ステータス

ロードマップの現状をすばやく読み取り専用で要約します。変更は行いません。

1. gh CLI でイシュー数とマイルストーンの進捗を取得します
2. ROADMAP.md を読みます
3. 全体の指標、カテゴリ別（enhancement/bug/docs）、工数別（small/medium/large）の要約表を提示します
4. 詳細な分析は行わず、明らかな不一致に注意を促します

詳しいワークフローの手順と表のテンプレートについては、 references/status.md を参照してください。

モード：ヘルプ

利用可能なモードと使い方を表示します：

roadmap — Strategic Roadmap Management

MODES:
  (default)    Sync ROADMAP.md + labels with GitHub, recommend priorities
  sync         Same as default
  generate     Bootstrap CONTEXT.md + ROADMAP.md from scratch
  brainstorm   Creative ideation session (collaborative, read-only)
  status       Quick read-only summary of current state
  help         Show this help message

LABELS (synced automatically):
  roadmap/current  → "Immediate Focus" section
  roadmap/next     → "Near-Term Vision" section
  roadmap/future   → "Future Vision" section
  effort/small     → 1-2 hours
  effort/medium    → half day to 1 day
  effort/large     → multi-day

KEY PRINCIPLES:
  CONTEXT.md is the project constitution (all modes respect it)
  Brainstorm mode is read-only until user approves ideas
  Generate mode asks before overwriting existing files
  Labels are synced to match ROADMAP.md sections
  LOE is auto-estimated for issues missing effort/* labels

出力ガイドライン

• 構造化された比較には表を使用します
• 絵文字は控えめにし、ステータス表示にのみ使用します
• GitHub のイシューに言及する際は、必ずイシュー番号を記載します
• ファイルを変更した後は、必ず markdownlint を実行します