# Specs

Specs are the primary implementation units in this repository.

## Good Specs

Good specs are:
- small
- incremental
- independently understandable
- testable
- focused on one responsibility

---

## Recommended Structure

Each spec should contain:
- spec.md
- architecture.md
- tasks.md
- optional contracts/

---

## Recommended Size

Prefer:
- 3 to 8 specs maximum for dojo projects

Avoid:
- giant umbrella specs
- multi-week implementation specs