ship

/ship

完了した作業から、正常に動作するインストールまでの提供経路を最適化します。実行コストが低いなら、提供こそが作業です。

Ship は実行フェーズの最終ステップです。ユーザーの手元に届いていないコードは、価値を提供していません。

使用するタイミング

実行が完了し、テストとレビューを終えて、変更をユーザーに届ける必要があるときに /ship を実行します。デプロイを行わずに、停滞した提供パイプラインに対して /ship を実行し、提供経路の負担を明らかにする単独の診断にも使用できます。

次の場合は使用しないでください： まだ開発中の場合です。Ship は作業が完了してから使用します。

JIT リファレンス

出荷時に、想定と異なるターゲット環境、ユーザーの行動、所有権の不備、または提供経路の負担が明らかになった場合に限り、references/reality-contact.md を読み込みます。

Ship のプロセス

ステップ 1：提供経路を特定する

コードから正常に動作するインストールまでの経路を示します。

「この変更の提供経路は、[ローカル] → [PR／レビュー] → [マージ] → [CI/CD] → [ステージング／本番] → [ユーザーのインストール] です。」

具体的に記述します。各ステップと、その担当者または担当システムを明記します。

ステップ 2：提供経路の負担を評価する

提供経路の負担とは、速度を低下させる摩擦です。レビュー待ち、マージの競合や安定性、ゲート／スキャンにかかる時間（直列か並列か、不安定か）、承認のボトルネック、デプロイ所要時間、ロールバックの準備状況、手動ステップについて、どこで時間が失われているかを特定します。

ステップ 3：Ship を実行する

CI/CD のコンテキストがある場合

1. パイプラインを参照する — 該当するビルド／デプロイ設定を示します
2. 適切なワークフローをトリガーする — PR にラベルを付ける、デプロイブランチにプッシュするなど
3. パイプラインを監視する — 失敗を確認し、状況を報告します
4. デプロイを確認する — 変更が反映されていることを確認します

CI/CD のコンテキストがない場合

1. デプロイ手順を列挙する — 必要な作業を順番に示します
2. 各手順を実行する — または、実行するコマンドを提示します
3. 各段階を確認する — 次に進む前に成功を確認します
4. 最終状況を報告する — ユーザー向けの変更が反映されていることを確認します

ステップ 4：出荷後の検証

次のことを検証するまで、出荷は完了していません。

• 稼働していますか？ — デプロイされ、実行されています
• 正常に動作していますか？ — 意図した動作が実現されています
• アクセスできますか？ — ユーザーがアクセスして利用できます
• 約束した特性は実現されていますか？ — 出荷した結果が /execute で宣言した成功基準と一致しています
• 実際の状況は想定と一致しましたか？ — ユーザー／運用担当者が、解決したと考えていた問題に直面しました。隠れた制約や所有権の不備は、適切な学習成果物に引き継がれています

必要に応じて、その場限りの検証テストを作成します。重要なのは恒久的なインフラではなく、確信を得ることです。検証では、デプロイが完了したかどうかだけでなく、作業で実現するとした内容に立ち返って確認します。

Ship は引き続き提供に焦点を当てます。検証失敗やロールバックから得た学びは /salvage に引き継ぎ、より広範な現実との接点から得た学びは /aim、/problem-space、ガードレール、または metis に引き継ぎます。検証に失敗しない限り、出荷済みの作業を再開しないでください。

出力形式

## Ship

### Ship Report

**Shipped:** [what was shipped]
**Target:** [where it was shipped to]
**Path:** [the delivery path taken]

### Delivery-Path Tax Identified
- [Friction point 1]: [time/effort cost]
- [Friction point 2]: [time/effort cost]

### Ship Actions Taken
1. [Action 1 - result]
2. [Action 2 - result]

### Verification
- [x] Deployed successfully
- [x] Running in target environment
- [x] User-facing functionality confirmed

### Delivered Characteristics Validation
- [x] [Declared criterion/characteristic 1]
- [ ] [Declared criterion/characteristic 2, if not yet verified]

### Reality Contact Check
- Frame match: [matched | partially matched | missed]
- Different problem encountered: [none | describe]
- Hidden constraints / ownership failures: [none | describe]
- Learning routed to: [`/salvage` | `/aim` | `/problem-space` | guardrail | metis | none]

### Recommendations
[Any suggestions for reducing delivery-path tax in future]

セッションの引き継ぎ

セッションファイルを使用している場合は、## Ship を置き換えるか追記します。提供経路の負担、検証状況、実現した特性の検証結果、現実との接点の結果、学びの引き継ぎ先を保持してください。