Aller au contenu

Guide d'usage

Ce guide couvre l'utilisation opérationnelle du kit dans un projet consommateur. Il ne ré-explique pas la vision (voir Vision) ni la machine d'états (voir Architecture) — il décrit uniquement comment s'en servir.

Les 5 pages du guide

  • Installation

    Prérequis système, ajout du submodule, bootstrap, installation des hooks git.

    Installation

  • Première session

    Parcours scénarisé : initialiser un BE, franchir la première porte, prendre ses marques.

    Première session

  • Usage quotidien

    Les commandes qui reviennent chaque jour : status, check, move, invocation d'un skill, maintenance de spiral-state.md.

    Usage quotidien

  • Mise à jour submodule

    Comment tirer une nouvelle version du kernel, gérer les changements de schéma, valider la compatibilité.

    Mise à jour

  • Dépannage

    Symptômes courants, causes probables, remèdes éprouvés.

    Dépannage

  • Templates

    Templates d'entrée (EO, transcription, atelier) et leur usage.

    Templates

  • Déploiement

    Publier la living doc sur sdeg.aelworks.fr via GitHub Actions + SFTP IONOS. Prérequis, rollback, dépannage.

    Déploiement

Flux type d'une journée

flowchart LR
    A[Ouvrir la session<br/>Copilot / Claude] -->|hook SessionStart<br/>injecte spiral-state| B[Point de situation<br/>avec le Coach]
    B --> C{Porte active<br/>identifiée ?}
    C -->|Oui| D[Invoquer le skill<br/>qui produit le livrable]
    C -->|Non| E[#agent-coach-emergent<br/>pour recentrer]
    D --> F[Revue humaine<br/>du livrable]
    F --> G[node sdlc/sdlc.js check<br/>puis move]
    G --> H[Mise à jour<br/>spiral-state.md]
    H --> I[Fin de session<br/>hook Stop rappelle]

Le contrat avec l'IA

L'IA (Copilot, Claude) propose, rédige, structure. Elle ne franchit jamais une porte seule. Les commandes node sdlc/sdlc.js move sont toujours exécutées par l'humain, après revue consciente du livrable.

Si une IA propose de lancer elle-même un move, c'est un signal d'alerte : le prompt a été mal compris ou le contrat a été oublié. Refuser, rappeler le principe, et faire le move soi-même.

Voir aussi : Les 4 portes · Skills et agent · Architecture.