# Convention `docs/suivi/` — trace versionnée des lots SUIVI

## Objectif

Rendre l’état réel d’un lot SUIVI (rédigé / envoyé / poussé / déployé / testé) **lisible dans git**, sans dépendre de la mémoire ni de `PROJECT.md` (souvent en retard).

## Nommage

```
docs/suivi/SUIVI_<NNNN>_<slug_court>.md
```

Exemples : `SUIVI_1023_flags_marche_budget.md`, `SUIVI_1024_convention_fichiers_suivi.md`.

- `<NNNN>` = numéro SUIVI sur 4 chiffres (zéro-paddé).
- `<slug_court>` = kebab-case, descriptif, sans accents.

## Structure imposée

Chaque fichier commence par un frontmatter YAML, puis des sections markdown :

```markdown
---
suivi: 1023
date: 2026-07-28
sujet: <une ligne>
chantier: <slug ; ex. budgets-programme>
type: diagnostic | fix | feature | chore
statut: rédigé | envoyé | poussé | déployé | testé | abandonné
hash: <hash réel du commit, vide si non poussé>
fichiers:
  - chemin/fichier
---

## PROMPT ENVOYÉ
<texte intégral du prompt SUIVI, tel que reçu>

## SYNTHÈSE
<synthèse du lot : ce qui a été fait, tests, hash>

## DÉPLOIEMENT / TEST
<rempli après déploiement prod : date, résultat du test>

## LEÇON
<2 lignes max, UNIQUEMENT s'il y a une leçon réutilisable. Sinon omettre la section.>
```

Copier `_TEMPLATE.md` pour démarrer un nouveau fichier.

## Règles

1. **`statut` = source de vérité de l’avancement.**  
   `grep "statut: poussé" docs/suivi/` liste ce qui attend un déploiement.

2. **Un numéro SUIVI = un fichier**, jamais réutilisé — y compris pour un diagnostic sans commit applicatif.

3. **À partir de #1024** : chaque lot SUIVI **crée ou complète son propre fichier** `docs/suivi/` **dans le même commit** que le code du lot — section SYNTHÈSE remplie, `hash:` renseigné (après amend/push si besoin : mettre à jour le hash dans un commit suivant du même lot, ou renseigner le hash du commit qui contient le fichier), `statut: poussé` une fois sur `origin/main`.

4. Ordre typique des `statut` : `rédigé` → `envoyé` → `poussé` → `déployé` → `testé` (ou `abandonné`).

5. Ne pas y mettre de secrets, dumps SQL, ni données personnelles.

## Fichiers spéciaux

| Fichier | Rôle |
|---------|------|
| `README.md` | Cette convention |
| `_TEMPLATE.md` | Squelette vide à copier |
| `SUIVI_*.md` | Un lot = un fichier |