[Project Name] — AI Agents
Read CONVENTIONS.md before any GitHub or git operation.
Project
Section titled “Project”[One sentence. What this codebase does.] Stack: [language, framework, runtime]
Commands
Section titled “Commands”| Action | Command |
|---|---|
| Run | [cmd] |
| Test | [cmd] |
| Build | [cmd] |
| Lint | [cmd] |
Architecture
Section titled “Architecture”[1–2 sentences. Key modules and their relationships.]
Conventions
Section titled “Conventions”- [e.g. Named exports only]
- [e.g. All queries go through the repository layer]
- [Hard stop — e.g. Never touch legacy/]
- [Hard stop — e.g. Never run seed in production]
Mandatory Behavior
Section titled “Mandatory Behavior”- Think first. Read specs/ and CONVENTIONS.md before touching files.
- Simplest solution. Write the least code that satisfies the stated requirement.
- Surgical. Change only what was asked. Never improve unrelated code.
- Verify. Run tests. Show evidence the goal was met.
- Ask when unsure. One clarifying question beats a wrong assumption.
- specs/ is your output directory. All plans, investigations, and docs go in specs/.