feat: flow traceability — trace a need across AIDD gestures, visualized in Kanban

[blafourcade]

Thread télémétrie — Axe B (traçabilité du flow). Sœur de l'observabilité runtime (#297), but différent.

Ce n'est PAS du runtime — c'est de la télémétrie de processus / cycle de vie. On suit un besoin/feature à travers les gestes AIDD et on le voit progresser dans le Kanban (#194).

---

1. Modèle de corrélation

• Un besoin = un need_id stable (minté au 1er geste, brainstorm/idea).
• Propagé via le front-matter des artefacts (need_id: en tête de chaque markdown stické) + un manifeste aidd_docs/tasks/<need_id>/.
• Tout geste suivant lit/écrit le même need_id → chaîne corrélée.

2. Gestes → Events → Colonnes Kanban

Étape (colonne)	Geste(s) AIDD	Event émis	Artefact stické
Idea	aidd-refine:01-brainstorm	aidd.flow.brainstorm	notes brainstorm
Define	aidd-pm:03-prd, 04-spec, 02-user-stories	aidd.flow.spec	PRD / spec / stories
Plan	aidd-dev:01-plan	aidd.flow.plan	plan
Build	aidd-dev:02-implement	aidd.flow.implement	diff / code
Verify	aidd-dev:03-assert, 06-test, 05-review	aidd.flow.verify	rapport review/test
Ship	aidd-vcs:01-commit, 02-pull-request, 03-release-tag	aidd.flow.ship	commit / PR

3. Schéma d'event aidd.flow.<geste>

• need_id (corrélation), gesture, artifact_path, status (started/done/skipped), timestamp, model, tool hôte
• Réutilise schéma OTel feat: OTel semantic conventions / event schema for AIDD telemetry #343 + plomberie feat: OTel sink/transport layer (collector wiring + export config) #344/feat: telemetry privacy/consent model (opt-in, anonymization, retention) #345 (opt-in, anonymisé, jamais de contenu).

4. Règles de rendu Kanban (#194)

• La carte d'un besoin se place dans la colonne du geste le plus avancé atteint (status=done).
• Geste started non done → carte « en cours » dans la colonne courante.
• skipped → la colonne est marquée sautée (le flow AIDD permet de sauter des gestes).
• Sync bi-directionnel Tools - Kanban Visual Layer #194: bouger une carte peut déclencher le geste correspondant.

5. Acceptance criteria

• need_id minté au brainstorm et propagé (front-matter + manifeste)
• Chaque skill du tableau émet son aidd.flow.<geste> corrélé
• Artefacts stickés liés au need_id
• Kanban Tools - Kanban Visual Layer #194 lit les events → place la carte dans la bonne colonne
• Un besoin est traçable de Idea à Ship sans trou

6. Dépendances

• Plomberie OTel: schéma feat: OTel semantic conventions / event schema for AIDD telemetry #343, sink feat: OTel sink/transport layer (collector wiring + export config) #344, privacy feat: telemetry privacy/consent model (opt-in, anonymization, retention) #345
• Substrat visuel: Kanban Tools - Kanban Visual Layer #194
• Touche les skills de tous les plugins (émission d'event en fin de geste)

Labels: traceability, observability.