docs(overhaul): allow ten review passes

This commit is contained in:
Erik 2026-09-04 21:15:43 +02:00
parent def7fd2119
commit e18e23a5d3
2 changed files with 17 additions and 9 deletions

View file

@ -151,8 +151,12 @@ features; removing the user-requested Extended particle-range option.
bare `stash`. Rollback is a normal revert of a named commit. bare `stash`. Rollback is a normal revert of a named commit.
13. **Register discipline.** Deviations filed/retired in the same commit. 13. **Register discipline.** Deviations filed/retired in the same commit.
14. **Docs are tested truth.** Architecture text and code agree at slice close. 14. **Docs are tested truth.** Architecture text and code agree at slice close.
15. **Time-box.** A chunk that needs a third fix round stops and goes to the 15. **Time-box.** Per the owner's 2026-09-04 override, a chunk may receive at
user with its evidence. No agent decides it needs more infrastructure. most ten review passes, with each code finding repaired only through a new
bounded contract. Stop before an eleventh review and take the evidence to
the user. Documentation-only findings may be corrected directly by the
lead and do not require an implementation round. No agent decides it needs
more infrastructure.
--- ---
@ -169,7 +173,7 @@ work only; they are not instructions for future dispatches.
| Role | Who | Does | Never | | Role | Who | Does | Never |
|---|---|---|---| |---|---|---|---|
| Lead / architect | the main OpenAI Codex session | writes each chunk contract (files, retail functions + addresses, acceptance tests); dispatches one bounded chunk; verifies every claim against source; runs gates; commits; merges main in at slice boundaries | hands off "complete the slice" | | Lead / architect | the main OpenAI Codex session | writes each chunk contract (files, retail functions + addresses, acceptance tests); dispatches one bounded chunk; verifies every claim against source; runs gates; commits; merges main in at slice boundaries | hands off "complete the slice" |
| Implementer | one OpenAI implementation agent per chunk | one file cluster + its tests; build and test green is the return condition; returns a diff summary and open questions | commits; adds evidence infrastructure; starts a third fix round; touches files outside its contract | | Implementer | one OpenAI implementation agent per chunk | one file cluster + its tests; build and test green is the return condition; returns a diff summary and open questions | commits; adds evidence infrastructure; starts an uncontracted fix/review round; touches files outside its contract |
| Retail reviewer | one independent OpenAI review agent per slice on the production port | checks each ported branch against the named decomp with addresses; findings as file:line + decomp citation | reviews tooling | | Retail reviewer | one independent OpenAI review agent per slice on the production port | checks each ported branch against the named decomp with addresses; findings as file:line + decomp citation | reviews tooling |
| Architecture reviewer | one independent OpenAI review agent, only at the two cutover slices (S2, S5) | one owner per fact; layering; lifetime; performance shape | | | Architecture reviewer | one independent OpenAI review agent, only at the two cutover slices (S2, S5) | one owner per fact; layering; lifetime; performance shape | |
| Finding verification | the lead, against the source | each reviewer finding is checked by the lead against the decomp/contract/code before it is acted on; at most one independent OpenAI skeptic, and only for a blocking finding the lead cannot settle | spawns a skeptic per finding (the S1 review fanned out to ~30 agents this way on 2026-09-02; never again) | | Finding verification | the lead, against the source | each reviewer finding is checked by the lead against the decomp/contract/code before it is acted on; at most one independent OpenAI skeptic, and only for a blocking finding the lead cannot settle | spawns a skeptic per finding (the S1 review fanned out to ~30 agents this way on 2026-09-02; never again) |

View file

@ -9,10 +9,13 @@ This packet decomposes plan S5 into bounded chunks. The lead writes each
contract, one bounded OpenAI implementation agent changes only that contract, contract, one bounded OpenAI implementation agent changes only that contract,
the lead verifies every retail claim against the named pseudo-C and the paired the lead verifies every retail claim against the named pseudo-C and the paired
executable/PDB, and independent sequential OpenAI review lenses run before executable/PDB, and independent sequential OpenAI review lenses run before
landing. Per the owner's 2026-09-04 override, no remaining campaign step uses landing. Per the owner's 2026-09-04 overrides, no remaining campaign step uses
Claude Code, Anthropic models, or Anthropic credentials. A chunk that needs a Claude Code, Anthropic models, or Anthropic credentials, and a chunk may
third fix round stops and is written up. Every surviving deviation is entered receive at most ten review passes. Each code finding still receives a bounded
or corrected in the divergence register in the same implementation commit. contract; documentation-only findings may be corrected directly by the lead.
The chunk stops before an eleventh review. Every surviving deviation is
entered or corrected in the divergence register in the same implementation
commit.
## 1. Current boundary after S4 ## 1. Current boundary after S4
@ -1328,5 +1331,6 @@ the owner's OpenAI-only process override.
The same OpenAI retail lens narrowly re-reviews F1/F2 and regression evidence The same OpenAI retail lens narrowly re-reviews F1/F2 and regression evidence
first. Only its PASS unlocks the sequential OpenAI architecture/production/ first. Only its PASS unlocks the sequential OpenAI architecture/production/
gate-honesty review over the entire S5-c3 stack. A failed re-review receives gate-honesty review over the entire S5-c3 stack. Each further code finding
the one remaining bounded fix round; another failure after that stops S5-c3. receives its own bounded contract; S5-c3 stops before an eleventh review pass.
Documentation-only findings may be corrected directly by the lead.