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 ».
Dans le tableau de bord, ces origines sont explicites sous le titre : Grace avec la version du
paquet pour le catalogue, et Votre organisation avec la version de travail pour un talent privé.
Le texte de cycle de vie continue de distinguer la version publiée de la version de travail.
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.