Concepts
Talents
Un talent : un paquet multi-fichiers qui recentre l'agent sur les conventions du projet.
Un talent est un paquet multi-fichiers versionné. Il ne réapprend rien au
modèle : il recentre l'agent sur les conventions d'un projet. Le schéma complet est
décrit dans la référence du manifest et dans
catalog/TALENT-STRUCTURE.md.
Les fichiers d'un talent
| Fichier | Rôle |
|---|---|
manifest.yml | Identité, dépendances (requires / includes), rôles (agents), déclencheurs (activation), budget tokens, flag enforceable… |
compact.md | La version toujours injectée (300–800 tokens). |
rules.md, workflow.md, examples/<lang>.md, anti-patterns.md | Le détail, chargé à la demande. |
structure/ | Talents structurels : model.md (diagramme Mermaid) + constraints.yml (règles machine-vérifiables). |
tests/prompt-tests.yml | Les tests de conformité du talent. |
Composition : atomique → composite → persona
- Atomique : une brique (
ddd.value-object,architecture.use-case). - Composite : assemble des atomiques (
architecture.hexagonal,ddd.tactical). - Persona : un manifeste (un paquet de talents + des réglages), jamais de la connaissance nouvelle. → voir Personas.
Le graphe de dépendances sert à composer le contexte et à détecter les
incohérences — ce n'est pas un arbre de compétences à « débloquer » (le modèle
sait déjà). requires / recommends sont des indices d'assemblage, pas un curriculum.
Pour aller plus loin
- Écrire un talent — le guide pas-à-pas.
- Manifest — la référence du schéma.
- Builder vs Validator — les deux usages d'un talent.