diff --git a/RUNBOOK.md b/RUNBOOK.md index 1c6d552..393b9be 100644 --- a/RUNBOOK.md +++ b/RUNBOOK.md @@ -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) diff --git a/docs/AI_WORKFLOWS.md b/docs/AI_WORKFLOWS.md index ec12ea9..6b8671a 100644 --- a/docs/AI_WORKFLOWS.md +++ b/docs/AI_WORKFLOWS.md @@ -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) diff --git a/docs/RUNBOOK.md b/docs/RUNBOOK.md index 05226f7..7868a8c 100644 --- a/docs/RUNBOOK.md +++ b/docs/RUNBOOK.md @@ -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`. diff --git a/docs/evidence/evidence_pack.md b/docs/evidence/evidence_pack.md index cf7e198..47bcfd0 100644 --- a/docs/evidence/evidence_pack.md +++ b/docs/evidence/evidence_pack.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 diff --git a/docs/index.md b/docs/index.md index 700b195..6f169f8 100644 --- a/docs/index.md +++ b/docs/index.md @@ -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) diff --git a/docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md b/docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md index 7592191..74e2ce2 100644 --- a/docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md +++ b/docs/plans/REPO_DEEP_ANALYSIS_2026-03-11.md @@ -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 diff --git a/docs/workflows/README.md b/docs/workflows/README.md index bb2bf91..e04a371 100644 --- a/docs/workflows/README.md +++ b/docs/workflows/README.md @@ -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`