Devoxx 2026 Spec Kit

Stop a la dette documentaire — Spec-kit + 3 agents IA

**Devoxx France 2026** — Tools-in-Action 30 min Alexandre Guillemot & Axel [Nom] · WeScale

Governance automatisee des ADRs avec GitHub Spec-kit et 3 agents Claude IA en CI/CD.

Le probleme

Les sachants partent, et vous heritez d'un repo sans spec, sans doc, sans ADR. Le Time-To-Market s'effondre. L'onboarding devient un calvaire.

**Ce repo demontre comment rendre la documentation automatique et non-negociable.**

Comment ca marche

Spec-kit : de la spec au code

Constitution ──→ specify ──→ plan ──→ tasks ──→ implement
  (regles)       (spec)     (design)  (taches)   (code)

Chaque etape produit un artefact versionne. L'IA genere, le dev valide.

3 agents IA en CI

PR ouverte
    |
    +--------+--------+
    v        v        v        (en parallele)
 Agent 1  Agent 2  Agent 3
Structure ADR Review Coherence
  (Bash)  (Claude)  (Claude)
    |        |        |
    +--------+--------+
             v
     Score /100 → >= 80 PASS
                  <  80 FAIL

Agent	Methode	Verifie
Agent 1	Bash (deterministe)	Clean Architecture, imports
Agent 2	Claude Haiku 4.5	Presence + pertinence ADR
Agent 3	Claude Haiku 4.5	Coherence code ↔ documentation

**1 seul FAIL → merge bloque.**

La Regle d'Or (Principe III)

"Toute modification dans `src/domain` ou `src/application` DOIT etre accompagnee d'un nouveau fichier dans `docs/adrs/`"

L'IA est le gardien — pas le redacteur.

Architecture

src/
├── domain/            ← Coeur metier (0 dependances)
│   ├── talk.entity.ts
│   └── talk.repository.ts
├── application/       ← Cas d'usage
│   ├── submit-talk.usecase.ts
│   └── list-talks.usecase.ts
└── infrastructure/    ← Adaptateurs
    ├── in-memory-talk.repository.ts
    └── cli.ts

**Infrastructure → Application → Domain** (Domain ne depend de rien)

Installation

git clone https://github.