retro について
retroは、プロジェクトハーネスで完了またはエスカレーションされた実行を振り返るスキルです。チェックポイントと証拠を監査し、今後の実行改善に向けた教訓と対応事項を記録します。
主な機能
- 01実行仕様と証拠の収集
- 02必須チェックポイントと結果の監査
- 03証拠の品質と追跡可能性の確認
- 04構造化された振り返りレポートの作成
- 05対応事項をバックログや状態記録へ反映
活用シーン
- 01出荷済み実行の振り返り
- 02エスカレーション理由の記録
- 03ultragoalフェーズの終了
- 04監査結果をハーネス作業に反映
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/retroを入力して読み込まれたか確認します。
同梱ファイルreferences/retro-template.md
詳細
/retro — CP-7 Vを閉じる
tiny以外の出荷済みまたはエスカレーションされた実行には、すべてレトロを実施します。レトロは助言的なものですが、強く推奨されます。ハーネスを改善するための手段です。
実施するタイミング
- CP-6 の出荷後（公開承認、PR のマージ、vault の成果物の完了）
- エスカレーション後（検証に失敗した理由を記録）
/ultragoalフェーズの終了時（フェーズごとにレトロを1回実施）- 手動実行：
/retro <run-dir or spec path>
フェーズ 1 — 証拠バンドルを収集する
以下を読みます。
- 仕様またはカードの説明と受け入れ基準
04-projects/harness/runs/<id>/evidence/（ledger、checkpoints.tsv、CP-* ファイル）.claude/logs/loop-ledger.tsv（この実行の最後の行）- ultragoal フェーズの場合は
04-projects/<goal>/STATUS.md
フェーズ 2 — チェックポイント監査
レーンで必須とされた各 CP について、期待値、実績、ギャップを記録します。
| CP | tiny | normal | full |
|---|---|---|---|
| CP-1 spec | スキップ | 必須 | 必須 |
| CP-3v component | スキップ | 必須 | 必須 |
| CP-4 integration | スキップ | スキップ | 複数タスクの場合は必須 |
| CP-5 acceptance | 変更時 | 必須 | 必須 |
| CP-6 ship | 外部公開時 | 外部公開時 | 必須 |
フェーズ 3 — 証拠の品質チェック
以下を確認します。
- PASS の証拠行がないまま出荷された AC-n はありますか？（追跡可能性の違反）
- 観察対象が成果物ではなくツールの戻り値になっている PASS 行はありますか？（確信はあるが未確認）
- 反証可能でなかった基準はありますか？（次の仕様で修正）
フェーズ 4 — レトロを作成する
references/retro-template.md を次の場所にコピーします。
04-projects/harness/retro/YYYY-MM-DD-<slug>.md
すべてのセクションを記入します。アクション項目には ID（AI-01…）を付けます。
フェーズ 5 — 次に活かす
- 収集：アクション項目と教訓を、本日の収集用ステージングに追記
- バックログ：ハーネスの作業がある場合は、
AI-nの行を04-projects/harness/BACKLOG.mdに追加 - STATUS.md：ultragoal フェーズの場合は、フェーズの状態を進め、未解決の
AC-nを記録 - 仕様のチェックポイントログ：仕様の
## Checkpoint logにある CP-7 の行を更新 - 記録：
bash .claude/lib/checkpoint.sh record <run-dir> CP-7 PASS "retro: <path>"
ユーザーへの出力
要約：結果、最大の教訓、最優先のアクション項目、レトロのパス。
コメント
Markdown 対応