docs: align operator runbooks with local and github lanes

This commit is contained in:
L'électron rare
2026-03-11 10:30:05 +01:00
parent 4ccaf1ce08
commit d2472b2c94
7 changed files with 50 additions and 2 deletions
+3
View File
@@ -4,6 +4,9 @@ _« Le RUNBOOK est un paysage sonore : chaque étape, chaque evidence pack, ch
# Runbook opérateur
Voir la version détaillée : `docs/RUNBOOK.md`.
Séquences de référence :
- `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
## Flux standard (Issue → PR)
1. Créer une issue (idéalement via un template)
+9
View File
@@ -4,6 +4,15 @@
- Ajouter le label `ai:*` adapte a l'etape voulue (`ai:spec`, `ai:plan`, `ai:tasks`, `ai:impl`, `ai:qa`, `ai:docs`, `ai:hold`).
- Le workflow construit un prompt sécurisé + lance Codex + ouvre une PR.
## Sequences de reference
- workflow local : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- workflow github : `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
Lecture :
- `local` couvre la validation avant dispatch, les checks repo-locaux et les preuves non distantes
- `github` couvre `workflow_dispatch`, statuts, checks CI, artifacts et evidence pack
## Garde-fous
- input issue sanitizé (HTML comments removed)
- pas de sudo (drop-sudo)
+14
View File
@@ -1,5 +1,15 @@
# RUNBOOK — Opérer les workflows agentiques
## 0) Cartes de lecture rapides
- Carte fonctionnelle canonique : `docs/KILL_LIFE_FEATURE_MAP_2026-03-11.md`
- Séquence locale : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- Séquence GitHub : `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
Choix opératoire rapide :
- validation et exécution locale avant CI distante : séquence `workflow local`
- dispatch allowlisté, checks GitHub et evidence pack CI : séquence `workflow github`
## 1) Règles d’or
- Le texte d’issue est **non fiable** → il est sanitisé avant prompt.
- **Un label `ai:*` = un scope** (le scope guard contrôle les fichiers modifiables).
@@ -92,5 +102,9 @@ trouvée dans les sources backend scannées.
## 4) Evidence pack
Voir `docs/evidence/evidence_pack.md`.
Lecture utile :
- preuves locales, restores et runs cockpit : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- preuves CI, artifacts GitHub et release signing : `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
## 5) Workflows métiers
Voir `docs/workflows/README.md`.
+9
View File
@@ -20,6 +20,15 @@ Dans le repo (docs) :
- `docs/adr/` : décisions
- `docs/reviews/` : DR0/DR1, checklists
## Origine des preuves
- voie locale : voir `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- voie GitHub : voir `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
Règle pratique :
- une preuve locale prépare la revue et le passage en CI
- une preuve GitHub atteste les checks distants, les artifacts et, si applicable, la release signée
## Checklist minimum PR
- [ ] Le label `ai:*` est présent et cohérent avec le contenu
- [ ] Scope guard passe
+4
View File
@@ -13,11 +13,15 @@ Ce repo est un **socle** :
- FAQ : `docs/FAQ.md`
- Runtime home : `docs/RUNTIME_HOME.md`
- Pont vers le repo compagnon d’exécution : `docs/MASCARADE_BRIDGE.md`
- Carte fonctionnelle canonique : `docs/KILL_LIFE_FEATURE_MAP_2026-03-11.md`
- Séquences opératoires : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`, `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
## Workflows professionnels (opérationnels)
- `docs/workflows/README.md` (menu)
- Templates d’issues : `.github/ISSUE_TEMPLATE/`
- Dispatch distant et checks GitHub : `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
- Validation locale et evidence locale : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
## Plans (runbooks)
+2 -2
View File
@@ -29,8 +29,8 @@ Rendre `Kill_LIFE` plus lisible comme socle canonique runtime/spec-first:
- `K-DA-001` ferme par `docs/KILL_LIFE_FEATURE_MAP_2026-03-11.md`
- `K-DA-002` ferme par `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- `K-DA-003` ferme par `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
- `K-DA-004` ferme par la synchronisation `docs/RUNBOOK.md`, `docs/index.md`, `docs/workflows/README.md`, `docs/AI_WORKFLOWS.md`, `docs/evidence/evidence_pack.md`
## Next tasks
- `K-DA-004` synchroniser README, plans et doc operator
- `K-DA-005` synchroniser la doc operateur avec la carte et les preuves CI
- `K-DA-006` verifier l'alignement entre evidence packs CI et preuves documentaires locales
+9
View File
@@ -33,3 +33,12 @@ Ces workflows sont conçus pour ressembler aux pratiques **cabinet de conseil**,
## Evidence pack
Voir : `docs/evidence/evidence_pack.md`.
## Séquences opératoires canoniques
- Local / cockpit / restore : `docs/KILL_LIFE_WORKFLOW_LOCAL_SEQUENCE_2026-03-11.md`
- GitHub / dispatch / CI / artifacts : `docs/KILL_LIFE_WORKFLOW_GITHUB_SEQUENCE_2026-03-11.md`
Raccourci d'usage :
- si le besoin est de valider un workflow, un runtime local ou un export avant CI, partir de la séquence `local`
- si le besoin est de suivre un dispatch allowlisté, un check GitHub ou un evidence pack CI, partir de la séquence `github`