agile-roadmap

ロードマップ計画

このスキルを使って、幅広い目標を明確で優先順位の付いたロードマップに変換し、実行可能なバックログにつなげます。

スラッシュコマンド経由で受け取った初期コンテキスト：$ARGUMENTS

$ARGUMENTS に値がある場合は、開始点として使用します（例：インテイク、イニシアチブの一覧、期間）。 空の場合は、ロードマップの目標を尋ねます。

言語

成果物はユーザーの言語で作成します。文法を正しく使い、必要な発音区別符号や文字体系固有の文字を適用します。ユーザーの言語が不明な場合は、出力を生成する前に確認します。テンプレートは英語です。見出しと内容を翻訳して合わせてください。

プロジェクトのルート

このスキルは、エージェントの現在の作業ディレクトリではなく、作業対象のリポジトリであるプロジェクトのルートを基準とするパスに成果物を書き込みます。

• プロジェクト内から実行する場合は、このスキルに記載された相対パスを使用します。
• 別のディレクトリから実行する場合（例：兄弟リポジトリから、またはプロジェクトが別の場所にある場合）は、すべての成果物パスの先頭に<project-root>/を付けます。
• プロジェクトのルートが曖昧な場合は、書き込む前にハーネスの質問ツールを使ってユーザーに確認します。

プロンプト

CLAUDE.md / AGENTS.md のプロジェクト全体の規約（「Skill Prompting Conventions」）に従います。以下の判断ポイントでは、ハーネスの構造化質問ツール（Claude Code のAskUserQuestion、Codex のask_user_question、OpenCode のquestion）を使用します。パス／名前／値を列挙できない場合に限り、自由形式のテキストを使用します。

判断ポイント	構造化質問にする理由	推奨される選択肢
ロードマップの種類	テンプレートの種類に影響するため	軌道型・四半期型
次に分解するイニシアチブ	次のスキルの分岐となるため	最初のイニシアチブ・一覧から選択

自由形式のプロンプト（構造化質問ツールなし）：

• 期間の開始日と終了日（四半期型の場合）
• イニシアチブの説明

一時停止なしモード：ユーザーがスキル途中の確認を明示的に無効にしている場合は、すべての構造化質問を「未解決の質問」（または同等の項目）に記載し、処理を中断せずに進めます。

使用する場合

ロードマップは期間ではなく、軌道の複雑さによって定義されます。以下の条件のうち2つ以上に当てはまる場合は、このスキルを使用します。

• 複数のイニシアチブ／フェーズを順序付ける必要がある（すべてを並行して進められない）
• 現在の意思決定が今後の意思決定に影響する（局所最適化が技術的負債になる可能性がある）
• 個々のステップを承認する前に、関係者が全体の道筋を把握する必要がある
• 外部依存関係（他チーム、ベンダー、期限）がある
• 全体の複雑さが単一のエピックに収まらない

順序付けされた5つのフェーズがある4週間のイニシアチブも、ロードマップのメリットがあります。「短すぎる」と判断して除外しないでください。

使用しない場合

• 独立して完結するイニシアチブ（単一のエピックで対応できる）
• 波及効果のない単一のエピック — /agile-epic に直接進む
• チームがすでに軌道を明確に把握しており、ロードマップを必要とする関係者もいない

スコープ（ロードマップの種類）

• **軌道ロードマップ：**フェーズ間に依存関係がある複数フェーズのイニシアチブ（期間を問わない）
• **イニシアチブロードマップ：**名前の付いたイニシアチブのフェーズ、ストーリー、ブロッカー解除、実施順序
• **四半期ロードマップ：**方向性の調整、期間目標、主要な優先事項（特定の種類の一つであり、唯一の種類ではありません）

運用ルール

• ロードマップでは、詳細な技術項目の羅列ではなく、成果と能力に焦点を当てる必要があります。
• ロードマップの各項目には、期待される価値、依存関係、進捗を示す指標を記載する必要があります。
• ロードマップでは、確約事項、リスク、期間外の事項を明示する必要があります。
• 可能な場合は、各イニシアチブに対応するエピックを示す必要があります。

軌道ロードマップの作成方法（デフォルト）

1. 全体の取り組みが目指す目標を示します。
2. 2～5個のフェーズまたはイニシアチブを列挙します（順次または並行）。
3. 依存関係と価値に基づいて順序を決め、順序付けを明示します。
4. 各フェーズについて、期待される成果、依存関係、進捗を示す指標、リスクを記載します。
5. 確約事項、リスク、スコープ外の事項を記録します。
6. 説明が観察可能で、関係者に提示できる内容になっていることを確認します。

四半期ロードマップの作成方法（特定の種類）

上記と同じですが、期間の目標（四半期）を時間の境界として使用します。 関係者が期間ベースの視点を求めている場合（プロダクトや経営層向けによくあります）に使用します。

エピック別ロードマップの作成方法

1. エピックの目標を宣言します。
2. フェーズまたはデリバリーの段階を定義します。
3. フェーズごとにストーリーを関連付けます。
4. ブロッカーの解消、リスク、中間検証を明確にします。
5. ロードマップが計画に取って代わることなく、実行の指針となることを確認します。

保存場所

• イニシアチブ／軌道のロードマップ：planning/<initiative>/roadmap.md
• 四半期ロードマップ：planning/roadmaps/Q<N>-YYYY.md

共同作業

チームに開発者が2人以上いる場合、ロードマップでは次の点を考慮します。

• 開発者が同時に作業できるよう、並行トラック（例：バックエンド、フロントエンド、AI エンジニアリング）を特定します
• ブロックを最小限に抑えるため、トラック間のインターフェース契約を定義します
• タイムライン上で、並行して進められるストーリー／フェーズを示します
• ロードマップ作成時に、チームの規模と構成を確認します

ソロ開発者

ソロ開発者の作業では、実行時に並行作業は適用されません。並行トラックの構成は将来への備えとして役立ちます。後から2人目の開発者が加わった場合に分担できる可能性のあるトラックを注記しつつ、実際のデリバリーでは順次進める流れを選択してください。Mermaid の flowchart（依存関係）は、gantt（スケジュール）よりもソロ作業に適しています。

連携

ロードマップの最後に、次の項目のみを提案します。

• 「最初のイニシアチブをストーリーに分解するため、/agile-epic を実行しますか？」

重要： ロードマップでは、イニシアチブをマクロレベルで特定します。実行前に、各イニシアチブを /agile-epic で分解してください。

テンプレート

このスキルのベースとして templates/roadmap.md を使用します。

フローとの関係

flowchart LR
    A["/agile-intake"] --> B["/agile-roadmap"]
    B --> C["/agile-epic"]
    C --> D["/agile-story"]
    D --> E[execution]
    E --> F["/agile-status"]

このスキルは戦略と実行をつなぎます。分解には /agile-epic を、実行計画には /agile-story を使用します。