Why does Codex repeat the same mistakes?

I have one project I maintain since 2015, about 750k lines. No issues, mostly because repeated “misbehavior” is usually a good sign for a deeper analysis and documentation/agent guidance update. How does your documentation looks like? How do you organize what gets into agent’s context window?