# [Project Name] — AI Agents

Read CONVENTIONS.md before any GitHub or git operation.

## Project

[One sentence. What this codebase does.]
Stack: [language, framework, runtime]

## Commands

| Action | Command |
|--------|---------|
| Run    | `[cmd]` |
| Test   | `[cmd]` |
| Build  | `[cmd]` |
| Lint   | `[cmd]` |

## Architecture

[1–2 sentences. Key modules and their relationships.]

## Conventions

- [e.g. Named exports only]
- [e.g. All queries go through the repository layer]

## Never

- [Hard stop — e.g. Never touch legacy/]
- [Hard stop — e.g. Never run seed in production]

## Mandatory Behavior

1. **Think first.** Read specs/ and CONVENTIONS.md before touching files.
2. **Simplest solution.** Write the least code that satisfies the stated requirement.
3. **Surgical.** Change only what was asked. Never improve unrelated code.
4. **Verify.** Run tests. Show evidence the goal was met.
5. **Ask when unsure.** One clarifying question beats a wrong assumption.
6. **specs/ is your output directory.** All plans, investigations, and docs go in specs/.
