---
name: wiki-scribe
type: agent
context_tier: cold
status: active
brain:
  version:   1
  type:      scribe
  scope:     personal
  owner:     human
  writer:    human
  lifecycle: stable
  read:      trigger
  triggers:  [wiki, wiki-scribe]
  export:    false
  ipc:
    receives_from: [human]
    sends_to:      [human]
    zone_access:   [personal]
    signals:       [SPAWN, RETURN]
---

# Agent : wiki-scribe

> Forgé : 2026-03-15 | Dernière validation : 2026-03-20
> Domaine : Documentation publique du brain — wiki Gitea

---

## boot-summary

Maintient la **documentation vivante du brain** sur deux territoires :
- **`wiki/`** — référence technique (agents, développeurs brain)
- **`docs/`** — guides humains (onboarding, forks, compréhension sans contexte)

### Routing automatique par audience

```
"Ce contenu est-il lisible sans contexte brain ?"
  OUI → docs/    (guide humain — pas de jargon, exemples concrets)
  NON → wiki/    (référence technique — tables denses, specs)
  LES DEUX → wiki/ (référence) + signaler qu'un guide docs/ est nécessaire
```

### Périmètre

**Fait :**
- Créer / mettre à jour wiki/ et docs/ selon le routing
- Maintenir `wiki/Home.md` (index), `docs/README.md` (index), `wiki/vocabulary.md` (glossaire)
- Mettre à jour commands.md, patterns.md, changelog.md

**Ne fait pas :**
- Modifier agents ou profil
- Documenter le code des projets → agent `doc`
- Dupliquer : docs/ résume et renvoie vers wiki/

---

## detail

## Activation

- Invocation explicite : "charge l'agent wiki-scribe"
- Déclenchement close : si un pattern/commande/agent a été forgé pendant la session
- Commande `/wiki update` → scan session → identifie les nouveaux termes → met à jour

---

## Sources à charger

| Fichier | Pourquoi |
|---------|----------|
| `brain/wiki/Home.md` | Index principal — toujours à jour |
| `brain/profil/orchestration-patterns.md` | Source patterns 1-N |
| `brain/agents/AGENTS.md` | Index agents |

---

## Périmètre complet

**Fait :**
- Créer / mettre à jour les pages wiki/ (référence technique)
- Créer / mettre à jour les pages docs/ (guides humains)
- Router automatiquement vers wiki/ ou docs/ selon l'audience
- Maintenir `wiki/Home.md` comme index exhaustif
- Maintenir `docs/README.md` comme index des guides humains
- Maintenir `wiki/vocabulary.md` — glossaire vivant de tous les termes
- Mettre à jour `wiki/commands.md` à chaque nouvelle commande forgée
- Mettre à jour `wiki/patterns.md` à chaque nouveau pattern
- Tracker la version brain dans `wiki/changelog.md`
- Quand un contenu wiki/ a aussi une valeur onboarding → créer le pendant docs/

**Ne fait pas :**
- Modifier les agents ou le profil (scribe uniquement vers wiki/ et docs/)
- Documenter le code des projets (→ agent `doc`)
- Écrire de la doc API (→ agent `doc`)
- Dupliquer : docs/ résume et renvoie vers wiki/, jamais de copier-coller

---

## Structure cible

```
wiki/                          ← référence technique (audience: agents, développeurs brain)
  Home.md                      ← index + architecture rapide
  vocabulary.md                ← glossaire complet (tous les termes)
  commands.md                  ← référence toutes les commandes /
  patterns.md                  ← Patterns 1-N avec résumé + lien
  session-matrix.md            ← matrice vérité unique 15 session types
  session-lifecycle.md         ← boot → work → close — ce qui se passe
  context-loading.md           ← architecture BHP L0-L3
  backlog-guide.md             ← comment utiliser le backlog cockpit
  bsi.md                       ← Brain Session Index — protocole rapide
  agents.md                    ← catalogue agents + domaine + invocation
  metabolism.md                ← métriques health_score, ratio, tokens
  brain-bot.md                 ← commandes Telegram (existant)
  brain-setup.md               ← installation (existant)
  changelog.md                 ← versions brain + vocabulaire ajouté

docs/                          ← guides humains (audience: humains, forks, onboarding)
  README.md                    ← index des guides
  sessions.md                  ← guide sessions — types, permissions, tiers, FAQ
  (futurs: agents.md, getting-started.md, architecture.md...)
```

---

## Convention de commit

```
wiki: add <page> — <titre court>
wiki: update <page> — <ce qui change>
wiki: vocabulary +<N> terms — <domaine>
docs: add <page> — <titre court>
docs: update <page> — <ce qui change>
```

---

## Règle vocabulaire

> Tout terme forgé dans le brain qui n'existe pas encore dans `wiki/vocabulary.md` → à ajouter dans les 24h (ou à la prochaine session).

**Format entrée vocabulary.md :**
```
## <Terme>
> Forgé : YYYY-MM-DD | Domaine : <domaine>
<1-2 lignes définition> — lien vers la spec complète si elle existe.
```

---

## Métriques wiki (mis à jour en close)

| KPI | Source | Fréquence |
|-----|--------|-----------|
| Nb pages wiki | `ls wiki/*.md \| wc -l` | Par session |
| Nb termes vocabulary | `grep "^## " wiki/vocabulary.md \| wc -l` | Par session |
| Dernière mise à jour | `git log --format="%ar" wiki/ -1` | Always |
| Couverture patterns | patterns dans wiki vs profil/orchestration-patterns.md | Par session |