docs: track design docs, plans, audits, coordination infrastructure, handoffs

- 21 docs/*.md: audits, design notes, deployment plans, checklists, memos
- Coordination: ROLES, runbooks (DGX reboot, Lea live), patches, registre, syntheses, systemd, QG template
- Handoffs: 6 Codex handoff documents + README + template
This commit is contained in:
Dom
2026-07-02 13:29:58 +02:00
parent 7dd5c872df
commit 6907ecc82f
42 changed files with 5267 additions and 0 deletions

View File

@@ -0,0 +1,97 @@
# Runbook — Test Lea live grandeur nature
- `Date`: 2026-06-08
- `Auteur`: Qwen (draft)
- `Statut`: DRAFT — en attente preflight vert + GO Dom
- **Interdit** : ❌ Replay autonome
---
## Prérequis
| # | Vérification | Commande / Action | Critère GO |
|---|---|---|---|
| 1 | Windows cible visible | `ping DESKTOP-58D5CAC_windows` | ✅ Répond |
| 2 | httpx OK côté Windows | `python -c "import httpx; print('OK')"` dans venv Windows | ✅ Import OK |
| 3 | Agent V1 en cours | Vérifier processus Windows agent V1 | ✅ Running |
| 4 | DGX Ollama accessible | `curl http://localhost:11434/api/tags` | ✅ Répond |
| 5 | Workflows acquis retrouvés | Dashboard → workflows chargés | ✅ ≥ 1 workflow visible |
| 6 | Dom présent physiquement | Devant le poste Windows | ✅ Confirmé |
---
## Exécution
### Étape 1 : Préflight (NON destructif)
```bash
# Sur le poste dev Linux
curl -X POST http://localhost:5005/api/v1/traces/stream/replay/preflight \
-H "Content-Type: application/json" \
-d '{"machine_id": "DESKTOP-58D5CAC_windows"}'
```
**Attendu** : `workflow_known: true`, aucun blocage G1-G6.
### Étape 2 : Capture Shadow supervisée
1. Ouvrir le dashboard Lea
2. Démarrer un apprentissage supervisé
3. Scénario safe : Notepad → Enregistrer → Explorateur → Easily Assure
4. **Ne pas** déclencher de replay autonome
5. Observer et collecter les preuves en temps réel
### Étape 3 : Collecte des preuves
| Preuve | Où la trouver | Critère |
|---|---|---|
| `live_events.jsonl` | `data/training/live_events.jsonl` | Non vide, timestamps cohérents |
| `learn_*.json` | `agent_chat/state/learn_*.json` | Présent, state non vide |
| Shadow understanding | `agent_chat/state/` | Compréhension non vide |
| Screenshots avant/après | Captures manuelles | Chaque action documentée |
| Rapports preflight | Sortie curl étape 1 | `workflow_known: true` |
### Étape 4 : Arrêt propre
1. Stopper l'apprentissage via le dashboard
2. Vérifier que les fichiers de state sont cohérents
3. Ne pas lancer de replay automatique
---
## Critères GO/NOGO
### GO (tous doivent être verts)
| ID | Critère |
|---|---|
| G1 | Préflight `workflow_known: true` |
| G2 | Windows cible joignable |
| G3 | `httpx` import OK côté Windows |
| G4 | DGX Ollama accessible (`localhost:11434`) |
| G5 | Workflows acquis retrouvés (≥ 1) |
| G6 | Dom confirme présent physiquement |
### NOGO (un seul suffit)
| ID | Critère |
|---|---|
| N1 | Préflight KO |
| N2 | Windows injoignable |
| N3 | `httpx` absent |
| N4 | DGX Ollama inaccessible |
| N5 | Dom absent devant Windows |
| N6 | Replay autonome demandé |
---
## Rollback
1. Arrêter proprement l'apprentissage
2. Ne pas supprimer les fichiers de state
3. Documenter le point d'arrêt
4. Rapporter à Codex/Claude
---
*Ce runbook est un draft. Il sera validé après preflight vert et GO Dom.*