# Specs Storytime

Spécifications du projet, **découpées par jalon**. Un dossier par jalon ; chaque
jalon contient un `README.md` (objectif, périmètre, Definition of Done) et ses
**étapes d'implémentation en sous-fichiers numérotés**.

Le suivi d'avancement est dans [`../../ROADMAP.md`](../../ROADMAP.md) (à tenir à jour).
Les principes d'ingénierie sont dans [`../../CLAUDE.md`](../../CLAUDE.md).

## Organisation

| Fichier | Rôle |
|---------|------|
| [`00-vision-architecture.md`](00-vision-architecture.md) | Vision produit, architecture cible, conventions transverses |
| `jalon-N-xxx/README.md` | Objectif du jalon + critères de fin |
| `jalon-N-xxx/NN-etape.md` | Une étape d'implémentation (conception + plan TDD + DoD) |

## Format d'un fichier d'étape

Chaque sous-fichier d'étape suit la même trame :

1. **Objectif** — ce que l'étape livre, en une phrase.
2. **Périmètre & hors-périmètre** — ce qui est inclus / explicitement exclu (YAGNI).
3. **Dépendances** — étapes/jalons préalables.
4. **Conception** — couches concernées, interfaces/contrats, modèles.
5. **Plan TDD** — la liste des tests à écrire **d'abord** (Red), dans l'ordre.
6. **Definition of Done** — conditions de complétion (tests verts, lint, roadmap à jour).
7. **Risques / notes** — pièges connus.

## Jalons

0. [Fondations](jalon-0-fondations/)
1. [Verrouillage / épinglage](jalon-1-verrouillage/) ⚠️ bloquant
2. [Lecture audio](jalon-2-lecture-audio/)
3. [Découverte & gestion des podcasts](jalon-3-podcasts/)
4. [Espace enfant](jalon-4-espace-enfant/)
5. [Code parental & espace parent](jalon-5-code-parental/)
6. [Limites, avertissements & fin de session](jalon-6-limites/)