Concepts
Talents
Les expertises codifiées que Grace transmet aux assistants, depuis le catalogue ou une organisation.
Un talent est une expertise codifiée que Grace transmet à l’agent au moment utile. Il ne réapprend rien au modèle : il recentre l’agent sur les conventions d’un projet.
Deux origines existent :
- un talent du catalogue est un paquet multi-fichiers versionné et partagé ;
- un talent de l’organisation est une règle privée, détenue par l’organisation active et limitée à ses projets. L’API conserve le terme historique « expertise privée ».
Le schéma de paquet décrit ci-dessous concerne les talents du catalogue. Il est détaillé dans la
référence du manifest et dans catalog/TALENT-STRUCTURE.md.
Les fichiers d’un talent du catalogue
| 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 → spécialisation
- Atomique : une brique (
ddd.value-object,architecture.use-case). - Composite : assemble des atomiques (
architecture.hexagonal,ddd.tactical). - Spécialisation : un manifeste (un paquet de talents + des réglages), jamais de la connaissance nouvelle. → voir Spécialisations.
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.