ship-roadmap

ロードマップを出荷する（自動操縦）

一度だけ検出した後、ドライバーが起動するループ（Claude の /loop、外部ドライバー、または手動での再実行）を実行します。ロードマップの各単位について、計画、実装、レビュー、PR の作成、必要に応じたマージを行います。ロードマップ完了後は既存の課題を確認し、すぐに修正する作業を出荷し、残りは提案として報告します（バックログは自動作成しません）。最後に最終レポートを出力します。判断には高性能なティア、入力作業には低コストのティアを使い、取り消しに大きなコストがかかる判断には人間が関与します。

ship-roadmap はループの指揮役です。ネイティブの固定 SHIP: バナーと締めくくりの → Next: ブロックを出力します。パッケージが所有する機械結果プロファイルは、ドライバーがループ内で呼び出すワーカーとセンサーのスキルに適用されます。

ターンの契約 — ターン終了前に確認する

✓ Exactly ONE stage advanced (or a terminal banner printed) and ONE line appended to the run log
✓ Nothing was merged outside the active --fullauto wrapper; direct merge
  commands remained blocked and no authorization survived the iteration
✓ Artifact language: explicit user instruction > the project's declared docs language > English. The CONVERSATION language never decides — a Spanish prompt still produces English PRs/issues/commits/SPECs unless one of the first two says otherwise
✓ The closing `→ Next:` block is printed as the ABSOLUTE last output

未チェックのボックスが1つでもあれば、ターンは完了していません。

使用するタイミング

マージ時と終了時に監督を行う、確定済みのロードマップに使用します。1つの機能、1つのバグ、または探索的な作業には、代わりに手動の計画／実行フローを使用してください。

ステップ 0 — プロジェクトを調査する（常に最初に実施）

作業に取りかかる前に、以下を読みます。CLAUDE.md／AGENTS.md のワークフロー規約、ドキュメントマップ、docs/features/ROADMAP.md、修正インデックス、アーキテクチャドキュメント、.github/ テンプレート。その後、以下を確認します。

1. 基盤： ガイド、マップ、ロードマップ、修正インデックスが存在する場合は、基盤の作成をスキップし、記載内容を確認します。そうでない場合は、基盤作成によって不足している項目を作成します。
2. スキル： plan-feature、execute-phase、review-change、audit-pr がインストール済みであることを確認し、ワーカープロンプト用に各スキルのディレクトリを記録します。存在しない場合は、npx skills add gtrabanco/agentic-workflow を実行して停止します。--fullauto の場合は、実行可能な .agentic-workflow/hooks/fullauto-merge.sh とそのプラットフォームガードも必須です。それ以外の場合は、直接マージせず init-workspace に処理を引き継ぎます。
3. 実行状況： 既存の docs/features/SHIP_DECISIONS.md がある場合、または docs/ship-founding の PR がオープン中の場合は、--continue を指定して再開します。引数なしの呼び出しでは、再度基盤作成を行わず、状況を報告します。
4. 状態： 新規プロジェクトか既存プロジェクトか、ブランチ、作業ツリーの変更状態を確認します。説明のつかないデフォルトブランチの変更がある場合は停止します（黙ってクリーンアップしないでください）。

段階的な読み込み — 実行ルートを選択する

許可リストは、以下にリンクされたパスのみです。別の参照先を決して作り出さないでください。 すべてのルートは guardrails から始め、その後、対応する行のみを読み込みます。

--continue を使用した AUDIT での厳守ルール： 次の順序で、references/GUARDRAILS.md、references/RECOVERY_AND_SELECTION.md、references/STOP_CONDITIONS.md、references/ADVANCE.md、references/MODEL_ROUTING.md、references/AUDIT_AND_MERGE.md のみを読み込みます。ステージ終了後に、references/CLOSEOUT_AND_LOG.md を読み込みます。実行が終端状態ではなく、名前付きのプリミティブがすべて存在する場合、そのターンでは他の参照先をすべて禁止します。

現在の条件	この順序でルート全体を読み込む	今は読み込まない
実行を検出または調査し、--continue を指定しない（デフォルトモードまたは新規作成の --fullauto）	guardrails → founding	recovery、stop conditions、advance、model routing、audit/merge、terminal report、portability
既存リポジトリでの founding に --fullauto を指定	guardrails → founding → audit and merge policy	recovery、stop conditions、advance、model routing、terminal report、portability
AUDIT 以外のイテレーションを続行	guardrails → recovery and selection → stop conditions → advance → ステージ実行前に model routing → ステージ実行後に closeout and log	founding、audit/merge、terminal report、portability
AUDIT/fullauto イテレーションを続行	guardrails → recovery and selection → stop conditions → advance → model routing → AUDIT ステージ前に audit and merge policy → ステージ実行後に closeout and log	founding、terminal report、portability
終端での停止／レポート	上記の該当する行、その後に terminal report	無関係な行
名前付きのプラットフォームプリミティブが存在しない	上記の該当する行、その後に portability	無関係な行

終端状態になる前に終端レポートを読み込んではなりません。また、プリミティブがすべて存在する場合は portability も読み込んではなりません。すべてのステージに先立ってモデルルーティングを行い、--fullauto を指定しない実行も含め、すべての AUDIT ステージに先立って audit/merge を行います。

選択したリソースは、このファイルから 1 ホップ先にあります。固定バナー、遷移、最低基準のチェック、出力ブロックは規範的です。必須のリソースが読み取れない場合は実行を停止し、以前の実行内容から推測して補ってはなりません。

ポータビリティ

このワークフローはドライバーに依存しません。プリミティブを利用できない場合に限り、portability の代替手順をそのまま使用してください。ステージの順序と安全性の最低基準は維持してください。

他のスキルとの関係

関係	スキル／ポリシー
組み合わせ（同一／下位ティア）	init-workspace、JIT の design-feature + plan-feature-scaffold、plan-feature、レビュー→集約の手動フロー（/review-change → REVIEW-FAIL の場合は /fold-findings → /review-change を再実行）、判定のみの audit-pr、audit-docs。
低コストのワーカー	execute-phase（新しいコンテキスト／フェーズ）、機械的な集約、監査ブロッカーの修正。検証済みのワーカーモデルを使用してください。
人への引き継ぎ	デフォルトのマージ、product-audit（より高い作業負荷）、および triage-issue によるレポート用イシューバッチ。
兄弟スキル	workflow-status が厳密なセンサー結果を提供します。ワーカースキルはパッケージ所有の出力プロファイルを使用し、コンダクターはネイティブの SHIP: ターン契約を維持します。

機能ごとの手動フローが引き続きデフォルトです。このスキルは、人による対応を両端に組み込んだ形でそのフローを提供します。

完了条件

• ターミナルバナーと最終レポートが存在し、PR がオープンになっています。ロードマップのステータスは正しく、すべての PR はマージ済み、オープン状態で監査済み、または理由を添えて保留されています。SHIP: COMPLETE にはイシューの確認も含まれ、残件は提案として報告されています。
• 確定した回答、イテレーションの根拠、成果、推奨事項を SHIP_DECISIONS.md、実行ログ、レポートで追跡できます。レポートには、人間が次に行うべき具体的なアクション（マージ、トリアージ、提案、プロダクト監査の時期）が記載されています。