# AGENTS.md - project instructions for your coding agent
# Works with Claude Code, Codex, OpenCode, Qwen Code, Goose, OpenHands and any
# harness that reads Markdown instruction files. Fill in the brackets, delete
# what does not apply, and keep every rule traceable to a real failure (see
# the ratchet log at the bottom - Addy Osmani's rule: no rule added before a
# failure justifies it).

## Mission
[One paragraph: what this project does and what done looks like.]

## Setup and commands
- Install: [command]
- Test: [command] - the agent must run this and see green before claiming done
- Lint/typecheck: [command]
- Run locally: [command]

## Boundaries
- Never commit secrets. Environment-specific values live in [.env path], never in the repo.
- Never overwrite [production config / live data / migrations] without being asked.
- Stay inside [src/ or the relevant directories] unless the task requires otherwise.
- [Add one boundary per real incident, not per imagined one.]

## Style
- [Language version, formatter, naming conventions - three lines max.]

## Ratchet log
Every rule below traces to a failure that actually happened. Date it, link
the commit or session if you can, and write the rule so the agent never makes
that mistake again.
- [YYYY-MM-DD] [What went wrong] -> [Rule that prevents it]