# Kanban — source de vérité

`DOCS/kanban.html` est **généré**. Ne pas l'éditer à la main.

```
kanban/
  board.json          colonnes, bandeau d'intro, horodatage
  cards/<n>-<col>/    un chantier ouvert = un fichier .md
  done/               un chantier clos = un fichier .md
```

Après toute modification :

```
python3 DOCS/tools/build_kanban.py
```

Les compteurs de colonne et le bandeau de chiffres clés sont **calculés** à partir du
nombre de fichiers. Il n'y a plus rien à compter ni à vérifier à la main.

## Gestes courants

| Geste | Action |
|---|---|
| Ajouter un chantier | créer un `.md` dans `cards/<colonne>/` |
| Déplacer de colonne | déplacer le fichier vers l'autre dossier |
| Clore un chantier | déplacer vers `done/`, ne garder que `title` dans le frontmatter |
| Réordonner | changer le préfixe numérique du nom de fichier (pas de 10) |

## Frontmatter d'une carte

```
---
title: Titre du chantier              (requis, HTML inline autorisé)
area: manager                          (requis — cible des filtres de domaine)
horizon: v1                            (optionnel — v1 | v2)
tags: manager-app, infra               (affichés en puces monospace)
flag: warn | code mort depuis C3       (optionnel — critical | warn | good)
src: todo-features.md — Quota stockage (requis — d'où vient l'info)
---
<p>Corps de la carte, en HTML.</p>
```

Le build échoue en nommant le fichier si `title`, `area` ou `src` manque.