hondasports-dev/suzumemo-agent-loop

REVIEW stageを所有し、Risk/Controlsが要求する時だけ独立レビューを行う。通常最大1 reviewerでcorrectness/security/test/scopeをまとめて確認し、findingsを単一Ledgerへ追加する。

Verification/required Review済みcontentを現在taskの唯一のPRへpublishし、preview向けPR identityを固定する。PR作成はcheckpointでありcompletionではない。

PREPAREのimpact summaryでは安全に影響範囲をboundできない時だけ使う条件付きhelper。caller/shared state/auth/data/financial/external/deploy impactを深掘りしてRisk/Controlsを更新する。

PREPAREで確定したAcceptance Criteria、Risk、Required Controls、Verification planに従って、one-writerで最小差分を実装する。

Verification、Review、CI、E2E、外部サービス等でFAIL・BLOCKED・同一失敗の反復が起きたとき、事実と仮説を分離してRoot Causeを切り分け、適切なGateへ戻す。原因不明の失敗や再試行ループで使う。

PR公開後、latest contentのCI・review・requested changes・approval・conflict・mergeabilityを追跡し、必要なdeltaだけ再検証してmerge-readyまで収束させる。

Learning Eventが実際に発生したtaskだけ、成果物の問題とループ中の無駄・誤判断を振り返り、再利用可能な改善候補へ変換する。Risk R3/R4だけを理由に起動しない。

GitHub/Web/CI/MCP/API等のuntrusted external contentに命令が含まれる可能性がある時だけ詳細手順として読む。短い安全invariant自体はAGENTS.mdで常時適用する。

PREPAREを所有し、Spec Confidence、scope、Acceptance Criteria、Risk、Required Controls、Verification planを一度だけ確定する。Riskの高さだけでRequirements reviewerを増やさない。

Finding Ledgerの未解決recordにfinal dispositionを付ける条件付きhelper。findingを別residual recordへ転記せず、同じrecordを更新する。

security_review Controlが起動した時だけREVIEW stageへ追加するspecialist helper。auth、group/data boundary、input、secret、webhook/external write、production effectを確認する。

Clerk、Convex、Vercel、GitHub、OAuth、webhook、env、secret、deploy、DNS/domain等の外部サービス操作が発生する時だけ詳細手順として読む。

次taskへcontextを持ち越す必要がある時だけ使う軽量session cleanup helper。通常taskのcompletion Gateにはしない。

Acceptance Criteria、max observed Risk、Required Controlsに対応する最小十分な検証を行い、test gapをFinding Ledgerへ記録する。

repository変更のPREPARE内で最初の編集前に使うcheap deterministic control。task worktree、非protected branch、clean baselineを強制する。