Journal des vagues¶

Ce journal n'est pas un changelog. C'est une rétrospective : chaque vague y est racontée comme un chapitre de la construction du kit, avec son contexte, ses décisions structurantes, ses pivots, ses artefacts et surtout ses leçons apprises.

La living documentation a vocation à grossir — chaque nouvelle vague ajoute un chapitre. Les anciens restent intacts, même si une décision a été révisée depuis : c'est ce qui fait la traçabilité.

Timeline¶

gitGraph
    commit id: "V1 — Bootstrap" tag: "15 skills, coach, hooks, CLI"
    commit id: "V2 — Portes exécutables" tag: "préconditions + invariants"
    commit id: "V3 — Vague 3" tag: "be.P2, us.P5-DOR, fe.P9"
    commit id: "V4 — As-is synthesis" tag: "model + facilitation"
    commit id: "Rebrand avril 2026" tag: "neutralisation branding"
    commit id: "V5 — Déploiement IONOS" tag: "sdeg.aelworks.fr via CI"
    commit id: "V6 — Intégration Nick Tune" tag: "v3 : PRD, task-level, reflection"
    commit id: "V7 — Port full Claude Code" tag: "v4 : 5 plugins par porte + ADR-0010"

Les vagues¶

V1 — Bootstrap

Le kit naît : 15 skills Copilot, 1 agent orchestrateur, 4 hooks PowerShell, CLI état machine. La base du LIVING/COLD est posée.

V1
V2 — Portes exécutables

Les portes sortent de la doc et entrent dans le code. Préconditions humaines, invariants parent-enfant, checks automatisés par porte.

V2
V3 — Vague 3

Automatisation poussée sur P2, P5 (DOR), P9. La porte P2 acquiert les checks métriques. safeResolve bascule en NEEDS-REVIEW.

V3
V4 — As-is synthesis

Deux visualisations sont produites pour porter le modèle auprès des sponsors : un model.html systémique et un poster de facilitation graphique.

V4
Rebrand avril 2026

Neutralisation de toutes les références à l'ancien contexte employeur. Le kit devient un produit distribuable.

Rebrand
V5 — Déploiement IONOS

La living doc devient publique sur sdeg.aelworks.fr. Pivot du plan VPS/Caddy vers l'infra mutualisée IONOS + SFTP + GitHub Actions, pour s'aligner sur la stack kanban-vibe.

V5
V6 — Intégration Nick Tune (v3)

Fusion sélective avec l'approche « dev workflows as code ». PRD entre G2 et G3 (ADR-0009 D1), 3 skills task-level intra-us.DEV en dual-format (D3), skill #prd-architect (D4), rétrospective outillée #sdeg-reflection (D5). Moteur TS et event-store SQLite explicitement écartés (D2).

V6
V7 — Port full Claude Code (v4)

Bascule complète vers Claude Code en dual-format : 5 nouveaux plugins par porte (sdeg-coach, sdeg-vision, sdeg-plan-dev, sdeg-plan-fab, sdeg-meta) + enrichissement de sdeg-task-level avec tdd-dev. ADR-0010 introduit le bloc sdeg: en frontmatter (applies_at, posture, prohibits, prerequisites, produces) — préparation de la couche métacognitive gate-aware.

V7

Comment lire une vague¶

Chaque chapitre suit la même trame :

Contexte : d'où on part, quelle douleur on adresse.
Décisions structurantes : ce qui a été arbitré. Ces décisions sont souvent liées à une ADR (voir Décisions).
Pivots : ce qui a été envisagé puis abandonné.
Artefacts produits : fichiers, scripts, pages de doc nés de la vague.
Leçons apprises : ce qu'on sait maintenant et qu'on ne savait pas avant.

La section Leçons apprises est le cœur analytique. Elle ne se contente pas de dire « ça a marché » — elle tire un enseignement transférable à la vague suivante.

Conventions¶

Une vague = un chapitre. Pas de sous-chapitres numérotés.
Les chiffres de commits sont ceux du repo sdeg-kernel au moment de la rédaction.
Les liens ADR pointent vers la décision formelle associée.
Les liens skills et portes pointent vers la doc générée.

Voir aussi : Décisions (ADR) · Vision.