CLAUDE.md (and AGENTS.md): best practices for better code

▤ Summary

This article explains how to use CLAUDE.md and AGENTS.md files to improve the code generated by AI agents. It recommends keeping instructions short, natural, and focused on project-specific rules that the model cannot infer on its own. It also highlights what to avoid, such as generic advice, outdated information, and overly rhetorical commands. The piece closes with a practical template that covers project context, environment details, documentation, tests, UX checks, and recurring issues.

▦ Linked Companies