State Management

Le framework gère l'état via les fichiers produits par chaque persona — pas de base de données, pas de service externe.

Principe

Chaque persona produit des artefacts (fichiers markdown) qui servent d'entrée au persona suivant dans le pipeline :

Analyst → docs/specs/auth.md
              ↓
Architect → docs/plans/auth.md
              ↓
Developer → src/auth/* (code)
              ↓
Reviewer → docs/reviews/2025-01-15-auth.md

Structure des outputs

docs/
├── specs/           ← PRD (Product Requirements Document)
│   └── auth.md      ← Output analyst
├── plans/           ← ADR (Architecture Decision Record)
│   └── auth.md      ← Output architect
├── reviews/         ← Rapports de review
│   └── 2025-01-15-auth.md  ← Output reviewer
├── bugs/            ← Reproduction + diagnostic
│   └── login-crash.md      ← Output bugfix pipeline
├── apex/            ← Outputs APEX (par task-id)
│   └── 01-auth/
│       ├── context.md
│       ├── analysis.md
│       └── plan.md
└── brainstorm/      ← Outputs brainstorm
    └── auth-strategy.md

Avantages

Aspect	Fichiers	Base de données
Versionning	Git natif	Migration nécessaire
Lisibilité	Markdown, lisible partout	Requiert un client
Portabilité	Copier/coller	Export nécessaire
Recherche	grep / Glob	Requêtes SQL
Collaboration	PR / merge	Sync nécessaire

Flags de sauvegarde

La plupart des skills acceptent le flag -s (save) pour persister leurs outputs :

/apex -s implement auth     # Sauvegarde dans docs/apex/
/brainstorm -s auth-strategy  # Sauvegarde dans docs/brainstorm/
/review-code -s              # Sauvegarde dans docs/reviews/

Sans le flag -s, les outputs restent dans le contexte de la conversation mais ne sont pas écrits sur disque.

Reprise de session

Le flag -r (resume) permet de reprendre un travail précédent en rechargeant les fichiers produits :

/apex -r 01-auth    # Recharge docs/apex/01-auth/*

L'IA relit les artefacts existants et reprend au dernier step complété.