AGENTS.md: say what is built; drop the model claim no check holds
The dry run of "Epic: slice 1, first approval. A Release on next reviews a pull request to this repo, and the machine user's approval stands" (#182), under ruling 1 of "The ruleset switch: main requires the machine user's approval of the most recent commit, and slice 1's event is recorded" (#198). This is one small, genuine pull request, for a Release on next to review and approve before any approval is required. The Factory Builder approved this change on 2026-11-09, as the Maintainer's scoping ruled. It opens labelled factory:hands-off, like every open pull request here. The Maintainer takes that label off this one alone when he unpauses.
What
The root AGENTS.md said two things that stopped being true.
| Line | Was | Now |
|---|---|---|
| 4 | "the first of the ports ⦠nothing talks to a model yet" | Names what is built: the Lifecycle, the Controller, the Harness, the evals, the workflows, the Release's rules, the Role pr-review and the ports built so far. "Only adapters/github.py talks to GitHub" stays, since tools/check_repo.py holds it |
| 60 | "Not built yet ⦠roles, evals and the workflows" | "every Role but pr-review"; the four directories' AGENTS.md still name their parts to come |
Line 4 no longer says anything about which module talks to a model. A rule no check holds does not belong in this file, and tools/ scripts call the CLI at the Maintainer's terminal.
AGENTS.md alone changes, still at 60 lines. It is on neither the protected nor the reported list of config/hooks.json, and no review Role reads it as an input.
Verification
CI's verify passes at the head, 2a60aef6 (the same two commits rebased on main 7ff090d7, the v0.1.1 commit). Export verify passed at 90fc0360, before the rebase. make checks: ok.
| Reviewer | Head | Unread parts | Blocking | Major | Minor | Info |
|---|---|---|---|---|---|---|
| agy | a399b90 | none | 0 | 0 | 0 | 0 |
| muse | a399b90 | none | 0 | 0 | 0 | 0 |
| claude-review | a399b90 | none | 0 | 1 | 1 | 0 |
| claude-security | a399b90 | none | 0 | 0 | 1 | 0 |
| claude-review | 90fc036 (rebased as 2a60aef) | none | 0 | 0 | 0 | 0 |
| claude-security | 90fc036 (rebased as 2a60aef) | none | 0 | 0 | 0 | 0 |
| Finding | Severity | Criterion | Where | What | Disposition |
|---|---|---|---|---|---|
| claude-review#1 | major | PR-5 | AGENTS.md:4 | "Only harness/engine.py talks to a model" is held by no check, and tools/ scripts and harness/run.py start the CLI | fixed in 90fc036: the sentence is dropped |
| claude-review#2 | minor | none | AGENTS.md:4 | The built list left out evals and the workflows, and said "the ports" while some are still to come | fixed in 90fc036 |
| claude-security#1 | minor | PR-5 | AGENTS.md:4 | The same model sentence states a trust boundary that no check holds at the module level | fixed in 90fc036: the sentence is dropped |
š¤ Generated with Claude Code