Tetardtek
8244a07881
- brain-engine: server, embed, search, RAG, MCP, start.sh (standalone) - brain-ui: source React complète, build.sh, DocsView avec tier colors - docs: 14 pages guides humains (getting-started, architecture, sessions, workflows, agents, vues tier) - brain-compose.yml v0.9.0: tier featured ajouté, sessions/agents par tier, coach_level, API key schema - DISTRIBUTION_CHECKLIST v1.2: brain-engine + brain-ui + docs dans la checklist
129 lines
4.6 KiB
Markdown
129 lines
4.6 KiB
Markdown
# DISTRIBUTION_CHECKLIST.md — brain-template maintenance
|
|
|
|
> Référence pour garantir que brain-template reste distribution-ready.
|
|
> À exécuter avant chaque release / tag.
|
|
|
|
---
|
|
|
|
## Vérification zéro fuite identité
|
|
|
|
```bash
|
|
# Depuis la racine du repo brain-template
|
|
grep -ri "tetardtek" . --include="*.md" --include="*.yml" \
|
|
| grep -v ".git" \
|
|
| grep -v "bsi-schema.md" # bsi-schema: exemple username accepté
|
|
```
|
|
|
|
Attendu : **0 résultats**.
|
|
|
|
---
|
|
|
|
## Placeholders en production dans brain-template
|
|
|
|
| Placeholder | Signification | Fichiers concernés |
|
|
|-------------|---------------|-------------------|
|
|
| `<OWNER_DOMAIN>` | Domaine de l'owner (ex: `monbrain.com`) | `profil/decisions/006`, `007`, `022`, `README.md` |
|
|
| `<BRAIN_ROOT>` | Chemin absolu local du brain (ex: `/home/user/Dev/Brain`) | `ARCHITECTURE.md`, `profil/architecture.md` |
|
|
| `<owner>` | Identifiant/username de l'owner | `profil/decisions/008` |
|
|
| `l'owner` | Référence générique à l'utilisateur du brain | agents/ (tous) |
|
|
|
|
---
|
|
|
|
## Répertoires obligatoires (structure v1.0)
|
|
|
|
```
|
|
brain-template/
|
|
agents/ ← tous les agents dépersonnalisés
|
|
contexts/ ← sessions génériques (10 fichiers)
|
|
agent-memory/ ← README + _template/
|
|
brain-engine/ ← moteur local (server, embed, search, RAG, MCP)
|
|
brain-ui/ ← dashboard React (docs, workflows, cosmos)
|
|
docs/ ← guides humains (14 pages)
|
|
profil/
|
|
decisions/ ← ADRs (placeholders domaine)
|
|
collaboration.md.example
|
|
CLAUDE.md.example
|
|
handoffs/
|
|
workflows/
|
|
README.md
|
|
KERNEL.md
|
|
ARCHITECTURE.md
|
|
DISTRIBUTION_CHECKLIST.md ← ce fichier
|
|
```
|
|
|
|
---
|
|
|
|
## Contextes inclus (génériques uniquement)
|
|
|
|
| Fichier | Usage |
|
|
|---------|-------|
|
|
| `session-navigate.yml` | Lecture légère — exploration brain |
|
|
| `session-work.yml` | Projet actif — mode travail |
|
|
| `session-pilote.yml` | Co-construction — mode pilote (ADR-035) |
|
|
| `session-edit-brain.yml` | Écriture kernel — writes autorisés |
|
|
| `session-kernel.yml` | Lecture kernel — read-only |
|
|
| `session-brainstorm.yml` | Mode brainstorm |
|
|
| `session-debug.yml` | Debug actif |
|
|
| `session-audit.yml` | Audit code/système |
|
|
| `session-coach.yml` | Mode coaching |
|
|
|
|
**Exclus** (trop owner-specific) : `session-infra.yml`, `session-deploy.yml`,
|
|
`session-urgence.yml`, `session-capital.yml`, `session-handoff.yml`
|
|
|
|
> v1.0 → v1.1 : `session-brain.yml` ajouté (10e contexte) — sessions de travail sur le brain lui-même, 100% générique.
|
|
|
|
---
|
|
|
|
## Docs (guides humains)
|
|
|
|
**v1.1 : docs/ inclus — 14 pages.**
|
|
Guides humains lisibles sans contexte brain : getting-started, architecture, sessions, workflows, agents par famille, vues par tier.
|
|
|
|
```
|
|
docs/
|
|
README.md ← index
|
|
getting-started.md ← premiere page — "j'ai forke, quoi maintenant ?"
|
|
architecture.md ← comment les pieces s'assemblent
|
|
sessions.md ← types, permissions, metabolisme, close
|
|
workflows.md ← recettes d'agents par situation
|
|
agents.md ← vue d'ensemble + comparatif tiers
|
|
agents-code.md ← review, securite, tests, refacto, perf
|
|
agents-infra.md ← VPS, CI/CD, monitoring, mail
|
|
agents-brain.md ← coach, scribes, orchestration, kernel
|
|
vue-tiers.md ← comparatif tous tiers
|
|
vue-free.md ← detail tier free
|
|
vue-featured.md ← detail tier featured
|
|
vue-pro.md ← detail tier pro
|
|
vue-full.md ← detail tier full
|
|
```
|
|
|
|
**Audit avant release :** `grep -ri "tetardtek" docs/` → 0 resultats.
|
|
|
|
## Wiki
|
|
|
|
**v1.0 : wiki absent.**
|
|
Le nouvel utilisateur construit son wiki au fil des sessions via `wiki-scribe`.
|
|
Le wiki est technique (audience agents) — le docs/ couvre l'onboarding humain.
|
|
|
|
---
|
|
|
|
## Checklist avant release
|
|
|
|
- [ ] `grep tetardtek` → 0 résultats
|
|
- [ ] `ls contexts/` → 10 fichiers présents
|
|
- [ ] `ls agent-memory/` → README.md + _template/
|
|
- [ ] README.md lisible par un inconnu (pas de référence owner)
|
|
- [ ] `ls docs/` → 14 fichiers présents
|
|
- [ ] `grep -ri "tetardtek" docs/` → 0 résultats
|
|
- [ ] `ls brain-engine/` → server.py, embed.py, search.py, start.sh présents
|
|
- [ ] `grep -ri "tetardtek" brain-engine/` → 0 résultats
|
|
- [ ] `ls brain-ui/src/` → composants présents
|
|
- [ ] `grep -ri "tetardtek" brain-ui/src/` → 0 résultats
|
|
- [ ] PATHS.md vide / exemple — aucun chemin machine réel
|
|
- [ ] `brain-compose.local.yml.example` → aucun token/credential réel
|
|
- [ ] Tag git `vX.Y.Z` créé après vérification
|
|
|
|
---
|
|
|
|
*Dernière mise à jour : 2026-03-20 — v1.2 docs + brain-engine + brain-ui standalone*
|