Tetardtek
60d9cf7332
Ajout : 11 session-*.yml, modes soft locks, coach-boot + time-anchor, ADR-008→024. Retrait : focus.md, BRAIN-INDEX.md, SUPERVISOR-STATE.md, claims/, todo/. brain-template = kernel distribuable propre.
73 lines
2.7 KiB
Markdown
73 lines
2.7 KiB
Markdown
---
|
|
name: ADR-019-session-modes-soft-lock
|
|
type: decision
|
|
context_tier: cold
|
|
---
|
|
|
|
# ADR-019 — Session modes : soft lock comportemental par déclaration au boot
|
|
|
|
> Date : 2026-03-17
|
|
> Statut : actif
|
|
> Décidé par : brainstorm session sess-20260317-1329-boot
|
|
|
|
---
|
|
|
|
## Contexte
|
|
|
|
Sans mécanisme de mode, une session Claude dérive naturellement vers l'exécution technique même quand elle devrait rester en navigation/coaching. Le contexte se pollue, la présence coach se dilue, et c'est l'humain qui porte la charge de garder le cap.
|
|
|
|
Trois alternatives ont été évaluées : mode dans le memory-global (permanent), mode dans les claims BSI (inter-sessions), mode déclaré à la session.
|
|
|
|
---
|
|
|
|
## Décision
|
|
|
|
Les modes sont déclarés au démarrage d'une session Claude via un mot-clé, chargent un fichier `modes/<nom>.md`, et constituent un **soft lock** : Claude refuse d'exécuter ce qui dépasse le périmètre du mode et redirige vers une session dédiée.
|
|
|
|
**Déclaration :** mot-clé dans le premier message (`brain +navigate`, `brain +kernel`, etc.)
|
|
**Fichiers :** `Brain/modes/<nom>.md` — chargés au boot si le mot-clé est détecté par helloWorld
|
|
**Enforcement :** soft — Claude dit "ouvre une autre session pour ça", il n'exécute pas
|
|
**Périmètre :** intra-session uniquement — pas de visibilité cross-sessions
|
|
|
|
---
|
|
|
|
## Alternatives considérées
|
|
|
|
| Option | Raison du rejet |
|
|
|--------|----------------|
|
|
| Mode dans `memory-global/` | Permanent = toujours actif. Un mode est ponctuel, pas identitaire |
|
|
| Mode dans claims BSI | BSI = gouvernance fichiers. Ne gère pas le comportement Claude. Mauvais périmètre |
|
|
| Mode dans `~/.claude/session-role/` | Local machine, non tracké, pas distributable avec le brain |
|
|
|
|
---
|
|
|
|
## Conséquences
|
|
|
|
**Positives :**
|
|
- Contexte préservé — pas de pollution par des tâches hors périmètre
|
|
- Présence coach maintenue sur la durée
|
|
- Livrable immédiatement — pas de dépendance BSI
|
|
- Distributable avec le brain-template
|
|
|
|
**Négatives / trade-offs assumés :**
|
|
- Soft lock uniquement — repose sur la discipline Claude, pas un mécanisme dur
|
|
- Pas de visibilité cross-sessions (hard lock = futur, attend évolution BSI)
|
|
- Nécessite que helloWorld détecte le mot-clé et charge le bon fichier mode
|
|
|
|
---
|
|
|
|
## À construire
|
|
|
|
- `Brain/modes/` — répertoire des modes
|
|
- `Brain/modes/brain-navigate.md` — premier mode à forger
|
|
- Modification de `agents/helloWorld.md` — détection mot-clé + chargement mode
|
|
- `brain-template/modes/` — mode example dans le template
|
|
|
|
---
|
|
|
|
## Références
|
|
|
|
- Fichiers concernés : `Brain/modes/` (à créer), `agents/helloWorld.md`, `memory-global/coach_presence.md`
|
|
- Sessions : `sess-20260317-1329-boot`
|
|
- Lexique : `profil/lexique.md` — distinction type de session / mode
|