SKRAFT — Le Handbook

SKRAFT est un pipeline SDLC piloté par des agents IA. Chaque phase de développement est exécutée par un agent dédié, puis validée par un reviewer indépendant — aucun agent ne valide son propre travail.

« The only way to go fast is to go well. » — Martin, R. C., Clean Architecture, 2017.

Première visite ? Installez, puis choisissez

Installez SKRAFT avec /plugin.
Choisissez le parcours correspondant à l’état réel de votre projet.

Votre point de départ	Parcours
Story affinée ou backlog existant	Parcours principal
Code existant sans documentation ou sans filet de sécurité	Parcours Brownfield

Pour comprendre le passage de relais avant de lancer un workflow, suivez ensuite une commande Starbucks de bout en bout.

Comment lire ce handbook

La documentation suit la structure Diátaxis — quatre portes selon ce que vous cherchez à faire :

Porte	Pour…	Commencez par
Apprendre (tutoriel)	suivre un parcours guidé	Premiers pas, Le fil rouge
Faire (guide pratique)	résoudre une tâche précise	Customisation, Genesis & contribution
Comprendre (explication)	savoir pourquoi c’est construit ainsi	Le pipeline, La revue avant la revue
Consulter (référence)	retrouver un fait précis	Catalogue agentique, Gates, Patterns

Où aller selon votre rôle

Décideur — pourquoi la revue assistée réduit le délai de livraison : Pour décideurs.
Développeur — le pipeline phase par phase et l’équipe d’agents : Le pipeline, L’équipe.
Mainteneur d’un legacy — comprendre, sécuriser puis transformer l’existant : Parcours Brownfield.
Architecte — décisions et frontières : Architecture, Clean Architecture.
Vous venez de HVE ? — la continuité (RPI, state.json, BRD/PRD en amont) : HVE → SKRAFT.

Les parcours en une image

flowchart LR
    C{Point de départ} -->|backlog brut| D[DISCOVER optionnel]
    C -->|story affinée| R[RESEARCH]
    C -->|code hérité| BF[Brownfield standalone]
    BF -.->|PRD, backlog ou code sécurisé| C
    D -.->|triage| DI[DISCUSS optionnel]
    DI -.->|story affinée| R
    R -->|recherche sourcée| DE[DESIGN]
    DE -->|architecture| DIS[DISTILL]
    DIS -->|scénarios| DEL[DELIVER]
    DEL -->|code| PR[Pull Request]
    style BF fill:#102016,stroke:#6f8478
    style D fill:#1a3a2a,stroke:#4ed58a
    style DI fill:#1a3a2a,stroke:#4ed58a
    style DE fill:#1a3a2a,stroke:#4ed58a
    style DIS fill:#1a3a2a,stroke:#4ed58a
    style DEL fill:#1a3a2a,stroke:#4ed58a
    style PR fill:#102016,stroke:#6f8478

DISCOVER puis DISCUSS sont deux workflows produit autonomes et optionnels. Ils précèdent skraft-orchestrator, point d’entrée du pipeline d’ingénierie RESEARCH → DESIGN → DISTILL → DELIVER, sur le substrat partagé HVE-Core. Brownfield reste un parcours standalone choisi par l’humain. Il rejoint le parcours principal quand le backlog, la story ou le code sont prêts.