Architecture — Vue d'ensemble¶
Le kit est un assemblage volontairement minimaliste de quatre composants qui se parlent via le système de fichiers et la ligne de commande. Aucun service tiers, aucun démon, aucune base de données.
Composants et interactions¶
flowchart TB
USER[Équipe produit<br/>via VS Code]
subgraph COPILOT["GitHub Copilot Chat"]
AGENT[Agent Coach<br/>.github/agents/]
SKILLS[16 skills<br/>.github/prompts/]
end
subgraph DET["Scripts déterministes"]
HOOKS[4 hooks PowerShell<br/>scripts/*.ps1]
CLI[CLI sdlc<br/>sdlc/sdlc.js]
SCHEMA[schema.js<br/>source de vérité]
VALID[validators.js<br/>+ evaluator.js]
end
subgraph STATE["État et artefacts"]
REG[.product/sdlc-registry.json]
PROD[.product/.epics, .features, .stories]
EVENTS[.product/.events/*.md]
end
USER -->|invoque| COPILOT
COPILOT -->|oriente| USER
COPILOT -.lit.-> PROD
COPILOT -->|produit contenu| PROD
USER -->|commande| CLI
CLI -->|consulte| SCHEMA
CLI -->|vérifie via| VALID
CLI -->|écrit| REG
CLI -->|écrit| EVENTS
HOOKS -.déclenchés par<br/>session Copilot.-> COPILOT
HOOKS -->|lit/écrit| PROD
REG -.versionné.-> GIT((git))
PROD -.versionné.-> GIT
EVENTS -.versionné.-> GIT
Stack résumée¶
| Couche | Techno | Version min |
|---|---|---|
| Orchestration IA | GitHub Copilot Chat (VS Code) | VS Code ≥ 1.95 |
| Scripts session | PowerShell | 5.1 (Windows) / 7+ (crossplatform) |
| CLI état + validateurs | Node.js | 18 LTS |
| Persistance d'état | JSON + Markdown versionnés git | Git ≥ 2.39 |
| Documentation | MkDocs Material | Python ≥ 3.10 |
Navigation de cette section¶
- Machine d'états — référentiel complet repris de
sdlc/SDLC.md. - CLI sdlc — chaque sous-commande de
node sdlc/sdlc.js. - Hooks PowerShell — rôle et déclenchement des 4 hooks de session.
- Invariant de sécurité — pourquoi seul
sdlc.jspeut écrire dans le registre. - Stack technique — choix techno et leurs justifications (liens vers ADR).