# docs/ — Documentation humaine

> Guides lisibles sans contexte brain. Pour forks, onboarding, ou quand tu veux comprendre comment ca marche.

---

## Guides disponibles

| Guide | Description |
|-------|-------------|
| **Guides** | |
| [getting-started.md](getting-started.md) | **Commence ici** — les 5 premieres minutes apres un fork |
| [architecture.md](architecture.md) | Comment les pieces s'assemblent — version humaine |
| [sessions.md](sessions.md) | Types de sessions, permissions, metabolisme, close sequences |
| [satellites.md](satellites.md) | Les repos satellites — todo, toolkit, progression, reviews |
| [brain-engine-guide.md](brain-engine-guide.md) | Demarrer, arreter, diagnostiquer brain-engine |
| [workflows.md](workflows.md) | Recettes d'agents — quels agents combiner pour quoi |
| **Agents** | |
| [agents.md](agents.md) | Vue d'ensemble — comparatif tiers, navigation |
| [agents-code.md](agents-code.md) | Agents code & qualite — review, securite, tests, refacto, perf |
| [agents-infra.md](agents-infra.md) | Agents infra & deploy — VPS, CI/CD, monitoring, mail |
| [agents-brain.md](agents-brain.md) | Agents brain & systeme — coach, scribes, orchestration, kernel |
| **Vues par tier** | |
| [vue-tiers.md](vue-tiers.md) | Comparatif — tous les tiers d'un coup d'oeil |
| [vue-free.md](vue-free.md) | 🟢 free — ce que tu as |
| [vue-featured.md](vue-featured.md) | 🔵 featured — ce que tu gagnes |
| [vue-pro.md](vue-pro.md) | 🟠 pro — l'atelier complet |
| [vue-full.md](vue-full.md) | 🟣 full — ton brain, tes regles |

---

## Difference avec wiki/

| Espace | Audience | Contenu |
|--------|----------|---------|
| `docs/` | Humains, forks, onboarding | Guides, explications, FAQ |
| `wiki/` | Agents IA, brain interne | Matrices, specs techniques, lifecycle |

Les deux espaces documentent le meme systeme — `docs/` en langage humain, `wiki/` en reference technique.