State tradeoffs, do not over-build, and touch only what the request needs. Two projects say these rules came from mistakes agents kept making.
Turn a recurring mistake into a decision the agent can act on: what to check before editing, when to stop expanding scope, or when a request should remain read-only.
Four framing sections before any repository detail
Four general sections come first: Think Before Coding, Simplicity First, Surgical Changes, and Goal-Driven Execution. They cover assumptions, scope, adjacent code, and completion criteria.
Reproduction is the start of triage. The file requires evidence from documented behavior, types, or established runtime semantics before treating the result as a bug.
AGENTS.mdL56
Source excerpt starting at line 56.
56- A reproducible error is not automatically a bug. First prove the behavior violates Better Auth's documented contract, TypeScript contract, or established runtime semantics.