Hacker News
Fabien Sanglard Published the agent.md He Uses to Hold LLM Code Quality, Including 30-Character Function Names and Enums Instead of Boolean Parameters
Posted 2026-08-21, the file is a working set of constraints rather than a manifesto: extract magic numbers into named constants, use early returns to cut nesting, keep function names under 30 characters, pass enums instead of booleans, always brace single-line conditionals, and enforce layered boundaries where each layer only talks to its immediate neighbors. Visibility widening from private to public is treated as a design decision needing approval. The testing rule is strict TDD, write the test, watch it fail, then fix, and the context section prescribes a fresh session per feature against 'context dilution' plus an explicit agent.md reload when output quality drops.
↳ Follow the thread