Installer un talent

En tant que développeur, activer un talent du catalogue sur son projet, du dashboard au premier resolve.

Ce guide montre, côté développeur, comment installer un talent (l'activer) sur ton projet pour que ton assistant de code l'applique automatiquement.

Prérequis : ton repo doit déjà être branché à Grace (.mcp.json + stub CLAUDE.md). Si ce n'est pas fait, commence par Brancher un projet.

Le modèle : catalogue vs installé

Catalogue : tous les talents disponibles (lecture seule).
Installé : les talents actifs sur ton projet. Le MCP ne sert au LLM que les talents installés — c'est ce qui garde le contexte ciblé.

Installer un talent = le faire passer du catalogue à l'installé de ton projet.

Option A — depuis le dashboard (le plus simple)

Ouvre le catalogue (/catalog) et la fiche d'un talent (/catalog/:id).
Choisis ton projet, puis active le talent (bouton Installer / Activer). Tu peux aussi tout gérer depuis la page projet (onglet talents).
C'est appliqué immédiatement : la sélection est partagée entre le dashboard et le LLM.

Personas

Pour installer un ensemble cohérent de talents d'un coup, applique une persona (ex. software-craftsman, ux-designer). Voir Gérer les personas.

Option B — depuis le LLM (via MCP)

Ton agent peut installer/désinstaller un talent sans quitter l'éditeur :

grace_configure(talent: "grace.architecture.hexagonal", enabled: true)

enabled: true → installe (active) le talent ; false → le désinstalle.
La modification touche la même sélection que le dashboard (last-write-wins).
Pour découvrir un talent avant de l'installer : grace_search("hexagonal") puis grace_get(uri) sur ses détails.

Vérifier que c'est pris en compte

Au prochain appel, l'agent ne reçoit que les talents installés :

grace_resolve_context(task: "implémente l'annulation d'une souscription", agent: "coder", language: "typescript")
→ talents actifs : N   (#... hexagonal, use-case, …)

Tu peux aussi lancer un doctor (dashboard ou MCP) : il liste la sélection résolue, les manquants (un requires non installé) et les conflits.

Bonnes pratiques

Installe ce dont le projet a besoin, pas tout : la force de Grace est un contexte ciblé.
Respecte les dépendances : un talent peut en requérir d'autres (requires) et en recommander (recommends). Le dashboard et le doctor signalent les prérequis manquants.
Tu peux désinstaller à tout moment (enabled: false ou depuis le dashboard) — sans toucher au catalogue.

→ Référence des outils : Outils MCP · Concept : Qu'est-ce qu'un talent.