見せかけの完了 は、ゲートを通らない。

1. 01

   FAIL · ゲートで潰された

   01

   01

   Idea

   flow/00-idea.md

   コードが生まれる前に、ダメなアイデアを潰せ。

   MDflow/00-idea.mdHALT

   1# Problem statement

   2[FILL: describe user problem]

   3# Proposed solution

   4<empty>

   exit: 1 · unresolved [FILL] token

   FAIL · ゲートで潰された

   通過できないもの

   空っぽ、残った [FILL]、完了の証拠としての「tests pass」——いずれも通らない。 弱いアイデアはゲートで潰される。

   • 空のファイル。
   • ファイルに残った [FILL]。
   • 完了の証拠として提出された「Tests pass」。

   $/flow next✕refusing: flow/00-idea.md is empty (line 1)ゲートで潰すことも正当な結果だ。

2. 02

   証跡 · 一次情報

   02

   02

   Research

   flow/01-research.md

   本物の出典を示せ。なければここで止まれ。

   MDflow/01-research.md3/3 CITED

   1## Primary sources

   2• [RFC-9110] §4.2 Idempotent methods

   3• github.com/owner/repo#412 (repro)

   4## Competitive diff & failure modes

   urls verified · ground truth locked

   02証跡 · 一次情報

   アーキテクチャより先にグラウンドトゥルース

   競合比較、検証済みドキュメントの引用、実際の障害モードをリポジトリのファイルに記録する。

   $/flow check 01-research✓一次情報3件を引用（URL検証済み）✓競合比較と障害モードを確定

3. 03

   境界 · 対象外

   03

   03

   Scope

   flow/02-scope.md

   境界を引け。残りは捨てろ。

   MDflow/02-scope.mdFROZEN

   1IN-SCOPE S-01 CLI harness gate loop

   2IN-SCOPE S-02 Receipt schema validator

   3NON-GOAL Telemetry / analytics tracking

   4NON-GOAL Custom cloud daemon runtime

   2 deliverable slices · perimeter frozen

   03境界 · 対象外

   対象外リストを明示して凍結

   境界を定めた納品単位。スコープクリープはコード生成の前に捕まえる。

   $/flow check 02-scope✓納品単位3件を確定✓対象外を明示して凍結（スコープクリープを阻止）

4. 04

   契約 · 受け入れ基準

   04

   04

   PRD

   flow/03-prd.md

   コードを書く前に、テストを定義しろ。

   MDflow/03-prd.mdCRITERIA

   1INV-01: exit 1 on empty spec file

   2INV-02: refusal line emitted to stderr

   3INV-03: receipt JSON conforms to schema

   4INV-04: degraded mode creates debt entry

   4 observable invariants · 0 prose fluff

   04契約 · 受け入れ基準

   観測可能な基準のみ

   テスト可能な不変条件を持つユーザーストーリー。エージェントは途中で成功の定義を書き換えられない。

   $/flow check 03-prd✓観測可能な受け入れ基準を定義✓エラー状態と縮退パスを定義

5. 05

   決定 · トレードオフ

   05

   05

   ADR

   flow/04-adr.md

   コミットする前に、トレードオフを記録しろ。

   ADRflow/04-adr.mdACCEPTED

   1Status: Accepted (2026-10-11)

   2Context: File state vs SQLite daemon

   3Decision: Git-tracked Markdown files

   4Consequence: Portable; zero background server

   reversibility mapped · trade-off locked

   05決定 · トレードオフ

   アーキテクチャ決定記録

   実装開始前に背景・決定・結果を記録する。

   $/flow check 04-adr✓背景・決定・結果を記録✓可逆性と異常系テストを整理

6. 06

   PASS · 準備完了

   06

   06

   Contract

   flow/05-contract.md

   両者が合意しなければ、何も進まない。

   SIGflow/05-contract.mdUNLOCKED

   1[✓] human-signoff: approved by @dev

   2[✓] harness-attest: sha256:7f3a..9e1b

   3[✓] doctor-check: READY (skills verified)

   4[✓] dual-agreement: UNLOCKED -> advance

   signed contract · gate cleared for build

   PASS · 準備完了

   インストール後

   スキルはディスク上にある。/flow と入力する（Codexでは $flow）。flow doctor は READY と出力する。空のideaファイルに対する /flow next は行番号付きで拒否される。

   • スキルファイルがエージェントのホームに配置される。
   • /flow と入力する（Codexでは $flow）。
   • doctor が READY と出力できる。
   • 空のideaファイルに対する /flow next は、行番号付きで拒否される。

   $flow doctor✓doctor: READY (skills/flow/SKILL.md verified)✓ゲートが開くのは、両者が合意したときだけ。

次は /flow card。完了とは現実世界の証拠である：デプロイ済みURL、インストールして動くCLI、公開API、実際に動いたスキル。