closed-loop

クローズドループ実行（V 字モデルの右側）

機械的な検証パイプラインです。各検証ステップで、受け入れ基準 ID（AC-n）に紐づくエビデンス行を出力します。

使用するタイミング

このハーネスはオプトインです。次の場合に実行します。

• /closed-loop <task> または /closed-loop <spec-path> として呼び出された場合。
• ユーザーがクローズドループ、適切な検証、またはエビデンスの記録を求めた場合。
• 00-inbox/MY-PROFILE.md で verification_harness: on が設定されており、これがビルドタスクの場合。
• normal+ レーンを宣言する別のスキルが検証ステップに達した場合。

求められていない依頼では実行しないでください。メモ、概要資料、調査、草稿、通常の編集はハーネスの実行ではなく、それらにチェックポイント台帳を付けるのは単なる余計な作業です。

フェーズ 0 — レーンと実行フォルダー

bash .claude/lib/lane-classify.sh explain "<task>"
bash .claude/lib/checkpoint.sh init 04-projects/harness/runs/<YYYY-MM-DD-HHmm>

レーン	チェックポイント
tiny	CP-3 → CP-5（変更を加える場合）
normal	CP-1 → CP-2 → CP-3 → CP-3v → CP-5
full	+ CP-4 + claim-verifier + CP-6
bug	CP-3 の前に根本原因台帳（CP-0）

記録：checkpoint.sh record <run-dir> CP-0 PASS|SKIP "<lane>"

フェーズ 1 — CP-1 仕様（受け入れ基準）

仕様がある場合は、仕様の ## Acceptance criteria とトレーサビリティマトリクスを使用します。それ以外の場合は、次を作成します。

references/spec-template.md を使って 04-projects/harness/runs/<id>/criteria.md を作成します（基準とマトリクスのセクションのみ）。

各基準には、反証可能性、AC-n ID、検証方法を含めます。

記録：checkpoint.sh record <run-dir> CP-1 PASS "N criteria"

フェーズ 2 — CP-2 計画

タスクを AC ID に対応づけ、evidence/CP-2-plan.md に記載します。マトリクスのステータスを pending に更新します。

記録：checkpoint.sh record <run-dir> CP-2 PASS

フェーズ 3 — CP-3 ビルド

ワーカーが実装します。成果物のパスのみを返します。

フェーズ 4 — CP-3v コンポーネント検証

retry=0
loop:
  spawn task-verifier (fresh context, read-only)
  merge EVIDENCE rows into evidence/ledger.md
  if PASS → break
  if FAIL:escalate → record CP-3v FAIL, escalate
  if FAIL:fixable && retry < 2 → fix-agent → retry++
  else → escalate

検証担当者の EVIDENCE 行を evidence/CP-3v-component.md にコピーします。

記録：checkpoint.sh record <run-dir> CP-3v PASS|FAIL

フェーズ 5 — CP-4 統合検証（full または複数タスクの場合）

integration-verifier を起動します（読み取り専用）。台帳に行を追加します。

単一タスクの normal ではスキップします。

記録：checkpoint.sh record <run-dir> CP-4 PASS|SKIP

フェーズ 6 — CP-5 受け入れ（事後条件）

各変更について、成果物を確認します（curl、スクリーンショット、再取得）。次を出力します。

EVIDENCE AC-n | CP-5 | PASS | <observation> | <artifact>

UI/UX フローの変更： 事後条件は視覚的なものです。環境で利用できる任意のブラウザツールを使い、意味のある状態ごとにスクリーンショットを撮影します。その後、画像を確認し、はみ出し、位置ずれ、クリッピング、色の誤り、レスポンシブレイアウトの崩れがないことを確認してから PASS とします。Observation には実際に確認した内容を記述し、artifact には evidence/ 内のスクリーンショットまたは GIF を指定します。視覚的な欠陥があれば修正し、再撮影します。CLAUDE.md → Visual Verification を参照してください。

evidence/CP-5-acceptance.md を作成します。トレーサビリティの完了条件：マトリクス内のすべての AC に対して、台帳に PASS 行が 1 行以上あること。

記録：checkpoint.sh record <run-dir> CP-5 PASS|FAIL

フェーズ 7 — 記録と引き継ぎ

• .claude/logs/loop-ledger.tsv に追記します。
• 仕様のトレーサビリティマトリクスのステータスを verified に更新します。
• full レーン／大規模タスク： references/report-template.html を使って HTML レポートを生成し、04-projects/harness/runs/<id>/report.html に保存します。criteria.md と evidence/ledger.md（基準、AC トレーサビリティ、検証担当者の判定、事後条件の観察結果）を元に内容を記入します。自己完結型にし、SendUserFile で送信するか、Artifact として公開します。normal／tiny ではスキップします。
• CP-7 のために /retro <run-dir> を提案します。

統合

スキル	レーン	CP-4
ultragoal	フェーズごとに full（格下げはしない）	integration-verifier + North Star の受け入れ
team-brief	full	claim-verifier
comprehensive-analysis、auto-research	full	引用した主張に対する claim-verifier
content-factory	normal	スキップ
review-cockpit	normal	スキップ。CP-6 はカードごとのユーザー承認

エスカレーション用テンプレート

ESCALATED — <task>
Lane: <lane> | Last CP: <CP-n>
Evidence bundle: 04-projects/harness/runs/<id>/evidence/
Open AC IDs: <list without PASS rows>
Decision needed: <one question>