# Best Practices

## For Specifications

- **Be explicit** - Describe what you're building and why
- **Include acceptance criteria** - How do we know it's done?
- **Consider edge cases** - What could go wrong?
- **Reference decisions** - Link to DECISIONS.md
- Don't focus on tech stack - Let Claude suggest tools
- Don't be vague - "Make it work" is too vague

## For Memory Files

- **Update CONSTITUTION.md** - Keep it in sync with AGENTS.md
- **Add DECISIONS.md** - Record why you chose something
- **Document GOTCHAS.md** - Capture what hurt you
- **Commit regularly** - Memory is version controlled
- Don't duplicate AGENTS.md - Reference it instead
- Don't ignore patterns - If something repeats, escalate it

## For Team Collaboration

- **New devs read memory first** - 15 minutes saves hours
- **Review memory before coding** - Refresh your context
- **Update after learning** - Add to GOTCHAS.md immediately
- **Share decisions** - Record in DECISIONS.md
- Don't keep secrets - Document everything
- Don't repeat debates - Check DECISIONS.md first