AGENTS.md git:20260703.90a4404A

Immutable. This exact content is served forever at /api/v1/blob/b555aa6e2628681b.

@CONTRIBUTING.md

## Code comments

Write comments for a reader who is new to the codebase but familiar with the goal of the project. Avoid jargon-dense shorthand: explain *why* the code does what it does in plain language, spell out non-obvious context (invariants, gotchas, links to the decision), and don't assume the reader knows internal nicknames, prior incidents, or module history. A good test: someone on day one who knows what the product does should understand the comment without grepping elsewhere.