Progressive Disclosure

Le framework utilise un système de chargement progressif inspiré de Claude Skills pour optimiser l'utilisation du contexte.

Le problème

Les AI coding agents ont une fenêtre de contexte limitée. Charger toute la documentation d'un coup :

• Sature le contexte inutilement
• Dégrade la qualité des réponses
• Gaspille des tokens

La solution : 3 niveaux

Niveau 1 — Découverte

---
name: feature
description: |
  Pipeline complet pour implémenter une nouvelle fonctionnalité.
  Utilise analyst → architect → developer → reviewer.
allowed-tools: Read, Write, Edit, Bash, Glob, Grep
---

L'IA lit le frontmatter YAML et sait :

• Quand utiliser ce skill (description)
• Quels outils sont autorisés
• Comment l'invoquer (nom)

Coût : ~50 tokens par skill

Avec 19 skills, le niveau 1 consomme ~950 tokens — négligeable.

Niveau 2 — Activation

Quand l'utilisateur invoque /feature, l'IA charge le corps du SKILL.md :

• Instructions étape par étape
• Flags disponibles
• Commandes rapides
• Pipeline de steps

Coût : ~500-2000 tokens par skill activé

Seul le skill invoqué est chargé.

Niveau 3 — Détails

Si un step nécessite plus de contexte, l'IA charge :

• REFERENCE.md — détails supplémentaires, edge cases, exemples
• steps/ — fichiers individuels par étape
• resources/ — assets, templates, données

Coût : variable, chargé à la demande

Seules les ressources nécessaires sont lues.

Comparaison

Approche traditionnelle :
┌────────────────────────────────────┐
│  TOUT le contexte chargé d'un coup │  ← 50K+ tokens
└────────────────────────────────────┘

Progressive Disclosure :
┌──────────┐
│ Niveau 1 │ ← ~950 tokens (tous les skills)
├──────────┤
│ Niveau 2 │ ← ~1500 tokens (skill actif)
├──────────┤
│ Niveau 3 │ ← variable (à la demande)
└──────────┘

Structure type d'un skill

skills/
└── feature/
    ├── SKILL.md           ← Niveaux 1 + 2
    ├── REFERENCE.md       ← Niveau 3
    ├── steps/
    │   ├── 01-analyze.md  ← Niveau 3 (step 1)
    │   ├── 02-architect.md
    │   ├── 03-implement.md
    │   ├── 04-review.md
    │   └── 05-commit.md
    └── resources/
        └── examples.md    ← Niveau 3 (optionnel)