AGENTS.md@plugins/agents-mcp/skills/repo-task-proof-loop · git:20260919.fecc0d5 · 2026-09-19 · sha256 b9743a5357743b40
AGENTS.md@plugins/agents-mcp/skills/repo-task-proof-loop git:20260919.fecc0d5A
Immutable. This exact content never changes and is served at /api/v1/blob/b9743a5357743b40.
<!-- repo-task-proof-loop:start --> ## Repo task proof loop For substantial features, refactors, and bug fixes, use the repo-task-proof-loop workflow. Required artifact path: - Keep all task artifacts in `.agent/tasks/<TASK_ID>/` inside this repository. Required sequence: 1. Freeze `.agent/tasks/<TASK_ID>/spec.md` before implementation. 2. Implement against explicit acceptance criteria (`AC1`, `AC2`, ...). 3. Create `evidence.md`, `evidence.json`, and raw artifacts. 4. Run a fresh verification pass against the current codebase and rerun checks. 5. If verification is not `PASS`, write `problems.md`, apply the smallest safe fix, and reverify. Hard rules: - Do not claim completion unless every acceptance criterion is `PASS`. - Verifiers judge current code and current command results, not prior chat claims. - Fixers should make the smallest defensible diff. - For broad Codex tasks, bounded fan-out is allowed only after `init`, only when the user has explicitly asked for delegation or parallel agent work, and only when task shape warrants it: use bounded `explorer` children before or after spec freeze, use bounded `worker` children only after the spec is frozen, keep the task tree shallow, keep evidence ownership with one builder, and keep verdict ownership with one fresh verifier. - This root `AGENTS.md` block is the repo-wide Codex baseline. More-specific nested `AGENTS.override.md` or `AGENTS.md` files still take precedence for their directory trees. - Keep this block lean. If the workflow needs more Codex guidance, prefer nested `AGENTS.md` / `AGENTS.override.md` files or configured fallback guide docs instead of expanding this root block indefinitely. Installed workflow agents: - `.codex/agents/task-spec-freezer.toml` - `.codex/agents/task-builder.toml` - `.codex/agents/task-verifier.toml` - `.codex/agents/task-fixer.toml` <!-- repo-task-proof-loop:end -->