116 lines
4.8 KiB
Markdown
116 lines
4.8 KiB
Markdown
# Bootstrap Spec — Auto vs Explicite + Réflexes conventionnels
|
|
|
|
> **Type :** Contexte — propriétaire : `helloWorld`
|
|
> Rédigé : 2026-03-14
|
|
> Résout : "Audit bootstrap — agents auto-déclenchés vs invocation explicite"
|
|
> "Réflexes conventionnels — invocations implicites par contexte"
|
|
|
|
---
|
|
|
|
## Problème
|
|
|
|
CLAUDE.md liste tous les agents dans une table uniforme. Mais ils n'ont pas tous le même mode de déclenchement. Certains doivent réagir automatiquement à chaque message — d'autres sont invoqués explicitement sur demande. Sans cette distinction, le bootstrap est flou et les agents ne savent pas quand ils sont censés s'activer.
|
|
|
|
---
|
|
|
|
## Deux modes — définition
|
|
|
|
### Mode A — Présence permanente (vérification continue)
|
|
|
|
Ces agents observent CHAQUE message et interviennent si leurs seuils sont atteints. Ils ne sont pas "chargés" — ils sont présents.
|
|
|
|
| Agent | Seuil de déclenchement | Intervient comment |
|
|
|-------|----------------------|-------------------|
|
|
| `coach` | Toujours actif | Observe la progression, signale les patterns récurrents, guide sans bloquer |
|
|
| `interprete` | Demande ambiguë / scope croisé / intention floue | Reformule avant que Claude agisse |
|
|
| `mentor` | Explication demandée / plan complexe / risque de mauvaise compréhension | Pédagogie, validation de compréhension |
|
|
| `aside` | Message préfixé `/btw` | 2-3 lignes, capture todo si actionnable, retour session |
|
|
|
|
### Mode B — Agents 🔴 chauds (détection domaine)
|
|
|
|
Chargés automatiquement quand le domaine est détecté dans la conversation. Un seul chargement par session suffit.
|
|
|
|
```
|
|
Domaine détecté → charger l'agent → il reste actif pour la session
|
|
```
|
|
|
|
Table de détection dans `~/.claude/CLAUDE.md` section "Agents 🔴 chauds".
|
|
|
|
### Mode C — Agents 🔵 stables (invocation explicite)
|
|
|
|
Ne se déclenchent jamais automatiquement. Invoqués par l'utilisateur ou sur signal d'un agent chaud.
|
|
|
|
```
|
|
"charge l'agent X" → lire agents/X.md immédiatement
|
|
"scribe, [action]" → scribe agit
|
|
"orchestrator-scribe, [action]" → orchestrator-scribe agit
|
|
```
|
|
|
|
---
|
|
|
|
## Réflexes conventionnels — invocations implicites
|
|
|
|
Ces déclenchements n'ont pas besoin d'une instruction explicite. Ils sont des **réflexes du système** — Claude doit les appliquer sans qu'on le demande.
|
|
|
|
### Réflexes toujours actifs
|
|
|
|
| Signal contextuel | Réflexe attendu |
|
|
|------------------|-----------------|
|
|
| `/btw <question>` | `aside` — 2-3 lignes max, `→ on reprend.` |
|
|
| Session qui se termine naturellement | Proposer bilan scribes + checkpoint si session longue |
|
|
| `checkpoint` / `/checkpoint` | orchestrator-scribe pose signal CHECKPOINT dans BRAIN-INDEX.md |
|
|
| Tâche dans `focus.md` terminée | scribe la marque ✅ sans qu'on le demande |
|
|
| Agent forgé ou modifié | scribe vérifie AGENTS.md en fin de session |
|
|
| Gap infra identifié (port, service absent) | scribe le signale en fin de session même si non corrigé |
|
|
|
|
### Réflexes sur domaine détecté
|
|
|
|
| Signal contextuel | Réflexe attendu |
|
|
|------------------|-----------------|
|
|
| Fix sur code sensible (auth, tokens) | `security` suggère `testing` |
|
|
| Nouvelle feature en prod | `capital-scribe` signalé si milestone notable |
|
|
| Pattern validé en conditions réelles | `toolkit-scribe` proposé |
|
|
| "todo cette feature" dans un projet | `todo-scribe` vérifie + crée l'entrée si absente |
|
|
| Commit avec beaucoup de fichiers touchés | `git-analyst` proposé pour narration sémantique |
|
|
|
|
### Réflexes de coordination inter-sessions
|
|
|
|
| Signal contextuel | Réflexe attendu |
|
|
|------------------|-----------------|
|
|
| Travail terminé, autre instance doit reviewer | `orchestrator-scribe` pose READY_FOR_REVIEW |
|
|
| Session trop longue (compactage prévisible) | Proposer CHECKPOINT avant que ça arrive |
|
|
| Démarrage de session — watchdog | Scribe scanne Claims + Signals. helloWorld scanne CHECKPOINT. |
|
|
|
|
---
|
|
|
|
## Ce qui NE doit PAS être un réflexe
|
|
|
|
```
|
|
❌ Charger des agents "au cas où"
|
|
❌ Lire des fichiers brain sans raison précise
|
|
❌ Proposer un bilan scribe toutes les 5 minutes
|
|
❌ Demander confirmation pour chaque micro-décision
|
|
❌ Interrompre le travail pour signaler un gap non urgent
|
|
```
|
|
|
|
**Règle :** les réflexes sont discrets. Ils agissent ou signalent en fin d'action, pas pendant.
|
|
|
|
---
|
|
|
|
## Ordre de priorité des modes
|
|
|
|
```
|
|
1. Mode A (présence permanente) — toujours actif, en arrière-plan
|
|
2. Réflexes conventionnels — déclenchés sur signal contextuel précis
|
|
3. Mode B (🔴 chauds) — chargés sur détection domaine
|
|
4. Mode C (🔵 stables) — sur invocation explicite uniquement
|
|
```
|
|
|
|
---
|
|
|
|
## Changelog
|
|
|
|
| Date | Changement |
|
|
|------|------------|
|
|
| 2026-03-14 | Création — résout "Audit bootstrap" + "Réflexes conventionnels". Trois modes distincts, table de réflexes, règle anti-bruit |
|