Aller au contenu

sdeg-kernel — Living Documentation

Kit partageable en submodule git qui standardise trois couches du Cycle de Vie Produit entreprise : agents IA, assistants spécialisés, scripts déterministes. Cette documentation est la source de vérité vivante du kit : elle évolue à chaque vague, trace les décisions prises et expose le modèle à 360°.

Points d'entrée

  • Je découvre

    Vision, philosophie herméneutique, principe LIVING/COLD, posture « juste assez ».

    Vision et philosophie

  • Je m'installe

    Prérequis, ajout submodule, bootstrap, premiers pas avec le Coach et la CLI.

    Guide d'usage

  • Je référence

    Les 4 portes de décision (G1–G4) + boucle MVP→G1, catalogue des 21 skills, machine d'états complète.

    Les 4 portes

  • Je trace

    Journal analytique des vagues, ADR, décisions passées et leçons apprises.

    Journal des vagues

Les trois couches du kit

flowchart TB
    subgraph DET["Déterministe — scripts PowerShell + Node.js"]
        H1[hook-session-start.ps1]
        H2[hook-pretooluse.ps1]
        H3[hook-precompact.ps1]
        H4[hook-stop.ps1]
        CLI[sdlc/sdlc.js<br/>CLI machine d'états]
    end
    subgraph IA["IA — GitHub Copilot Chat"]
        COACH[Agent Coach Développement Émergent]
        SKILLS[21 assistants spécialisés<br/>invoqués via #nom]
    end
    subgraph ART["Artefacts — arborescence .product/"]
        REG[sdlc-registry.json]
        EPICS[.epics/*.md<br/>.features/*.md<br/>.stories/*.md]
        EVENTS[.events/YYYY-MM-DD-*.md]
    end
    DET -->|fournit contexte<br/>et état| IA
    IA -->|produit contenu<br/>raffine| ART
    DET -->|seul autorisé<br/>à écrire| REG
    ART -.->|lu par| DET

Règle cardinale. Le déterministe gère l'état et la mémoire. L'IA produit et raffine le contenu. L'IA ne décide jamais de faire avancer un état dans la CLI — c'est toujours une action humaine consciente.

Sujet Page
Pourquoi la spirale herméneutique ? Vision / Herméneutique
Le principe LIVING / COLD Vision / LIVING-COLD
Toutes les portes en un tableau Les 4 portes
Catalogue des skills Skills et agent
Machine d'états complète Architecture / Machine d'états
Invariant de sécurité Architecture / Invariant sécurité
Toutes les décisions structurantes Décisions (ADR)
Visualisations as-is Visualisations

Cette documentation est vivante

  • Chaque page affiche sa date de dernière mise à jour (plugin git-revision-date-localized).
  • Les pages générées portent un marqueur generated: true dans leur frontmatter — elles sont reconstruites à partir des sources (sdlc/schema.js, .github/prompts/, .github/agents/) par npm run docs:gen.
  • Les contenus narratifs (vision, journal, ADR, guide) sont écrits à la main : ils incarnent le sens et la rétrospective.
  • Le README.md et le GUIDE.html restent les contrats techniques pour GitHub et le bootstrap — le site ne les duplique pas, il les inclut ou renvoie vers eux.