docs: align operator runbooks with local and github lanes
This commit is contained in:
@@ -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)
|
||||
|
||||
@@ -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)
|
||||
|
||||
@@ -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`.
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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)
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user