# workflows/_template.yml — Template workflow thématique
# Copier + renommer : cp workflows/_template.yml workflows/<theme>.yml
# Lancer le premier step : bash scripts/workflow-launch.sh workflows/<theme>.yml

name: <theme-slug>          # ex: brain-engine-be7
branch: theme/<theme-slug>  # branche git dédiée — créer avec theme-branch-open.sh
pilote: <sess-id>            # renseigné au lancement (sess-id de la session pilote)

# ---
# chain : séquence de satellites dans l'ordre d'exécution
# Chaque step est traduit en claim BSI par workflow-launch.sh
# ---

chain:

  - step: 1
    type: code               # satellite_type : code | brain-write | test | deploy | search
    scope: <scope>/          # dossier ou fichier cible
    story_angle: "<description courte de la tâche>"
    # gate absent → proceed si result.status = ok

  - step: 2
    type: test
    scope: <scope>/
    story_angle: "Tests <scope>"
    gate: 0-failures         # proceed uniquement si result.tests.failed = 0

  - step: 3
    type: brain-write
    scope: <fichier>.md
    story_angle: "Documenter <livrable>"
    # gate absent → proceed si result.status = ok

  - step: 4
    type: deploy
    scope: vps/
    story_angle: "Déployer <livrable>"
    gate: human              # pause — confirmation humaine avant deploy

# ---
# Gates disponibles (transition vers le step suivant) :
#   absent       → proceed si result.status = ok
#   0-failures   → proceed si result.tests.failed = 0 (step type:test uniquement)
#   human        → pause + confirmation avant de lancer le step suivant
#   never        → chaîne s'arrête ici (step terminal)
# ---