Hey, I made a small repo about making codebases easier for Codex / coding agents to work in:
Can’t leave a link but here it is, github .com /noahljungberg/agent-legible-repositories
The idea is basically:
The repo is the agent interface
I noticed agents work way better when the repo has a good AGENTS.md / CLAUDE.md style entry file, clear docs, task plans, tests, and obvious verification commands.
So I wrote a small paper + SKILL.md + checklist for it.
Not meant to be super formal, mostly just something useful to feed to agents when setting up or fixing repos. Mostly meant for myself and I felt like writing an overleaf paper on it using resources i usually used anyway when setting up repos and documentation, but I figured some of you might like it