correct

1# Correct
2 
3The operator keeps correcting agents in this repo for the same mistakes. Change the repo so the next agent can't make them.
4 
5Assume every contributor is an agent that sees only the files it opened, copies the nearest example, and takes the shortest path that compiles. Design the repo so a change that looks right from one file is right for the whole repo.
6 
7## Find the mistake classes
8 
9First, read recent commits, reverts, review comments, agent instruction files, and comments that explain workarounds. Group the mistakes into classes. A class counts once it has happened twice.
10 
11## Fix each class at the highest level that works
12 
131. **Eliminate it with architecture.** Give each piece of state one owner and each task one supported way. Hide internals so the wrong import fails. Replace hand-synced lists with one source of truth. Delete old ways and dead code an agent would copy.
142. **Enforce it with types so the bad state can't be written.** If bad code still compiles, add a lint or CI check whose error names the file, type, or function to use instead. If the pattern is already common, fail only when a change adds more.
153. **Test the behavior.** Fix or delete any test that still passes when the behavior it checks breaks, or that fails when only the internals change.
164. **Write docs or agent rules last, only for judgment calls.** Nothing fails when an agent skips them.
17 
18## Fix and prove
19…