status-todo-loop

目的

「次に何やるんだっけ？」を消す。 STATUS.md を唯一の現在地として、triad-handoff と連動して常に全体観が戻る状態にする。

重要: STATUS.md は「検証済みの最新スナップショット」。計画や推測は書かない。履歴は DONELOG.md に分離する。

運用ルール

タスク開始時（改訂：reality-check 必須）

•status-reality-check を実行（コードと STATUS の整合を確認）
•STATUS.md の「Verified Reality」を更新（必要なら）
•STATUS.md の「次の最小 Permit（1個）」を確定
•triad-task-intake を作成
•codex-review-request を作成（必要なら）
•Human 承認 → Permit 確定 → Implementation

タスク終了時

•triad-handoff を書く
•cargo test（こまめに）
•
STATUS.md を更新：
- •Verified Reality（実装済み/未実装）
- •Next Minimal Permit（1個）
- •Open Decisions（必要なら）
•DONELOG.md に追記（追記のみ、破壊禁止）

STATUS.md に書いていいもの

OK	NG
✅ 検証済みの実装状況	❌ 推測
✅ 正本一覧（検証済み）	❌ 長期計画（→ roadmap.md）
✅ 次の最小 Permit（1個）	❌ 履歴（→ DONELOG.md）
✅ 未解決の設計判断	❌ 複数の候補を並列

STATUS.md 更新チェックリスト

タスク終了後に以下を確認：

markdown

## STATUS 更新チェックリスト

- [ ] Verified against commit を更新したか？
- [ ] Verified Reality は実コードと一致しているか？
- [ ] 正本一覧は最新か？
- [ ] 次の最小 Permit は1個に絞られているか？
- [ ] 履歴は DONELOG.md に追記したか？
- [ ] STATUS を破壊的に書き換えていないか？

連携フロー（改訂版）

mermaid

flowchart TD
  A[Task Start] --> B[status-reality-check<br/>code vs STATUS]
  B -->|Mismatch| C[STOP<br/>Update STATUS Verified Reality]
  B -->|OK| D[STATUS: Next Minimal Permit = 1]
  D --> E[triad-task-intake]
  E --> F[codex-review-request]
  F --> G[Human Approval]
  G --> H[Implementation]
  H --> I[cargo test（こまめに）]
  I --> J[triad-handoff]
  J --> K[STATUS update + DONELOG append]
  K --> L[Task End]

重要な教訓 (2026-01-25)

問題: STATUS.md が実態と乖離し、「未着手」と記載していた機能が実は完了済みだった。

原因: STATUS.md を無検証で信頼する設計だった。

対策:

•status-reality-check スキルを追加（本セッションで作成）
•タスク開始時に reality-check 必須化
•履歴を DONELOG.md に分離
•STATUS は「検証済みスナップショット」のみ