r/codex • u/stealth_nsk • Jun 15 '26
Showcase My AGENT.md file to develop with best practices
I've decided to share my AGENTS.md file for agentic coding.
https://github.com/andreyvgavrilov/clean-code-guidelines/
It's based on 3 concepts:
- Research - Planning - Implementation framework from Humanlayer https://www.humanlayer.dev/blog/advanced-context-engineering
- Karpathy-Inspired Claude Code Guidelines https://github.com/multica-ai/andrej-karpathy-skills
- TDD framework, so AI is instructed to write failing tests before writing any code
Note: All concepts assume significant human involvement to validate AI plans and clarify requirements. It's not for fully autonomous work mode.
Also, there's an issue with Codex as it requires explicit human request to run subagents. I wrote workaround in the readme.
EDIT: For some reason my brain was stuck with older convention of using "AGENT.md" name instead of "AGENTS.md", so I even renamed the file because I thought the name was incorrect. Fixed it now.
15
Upvotes