# 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 |