Grace
Guides

Gérer les personas

Composer une sélection de talents par projet depuis le dashboard.

Le dashboard pilote quels talents un projet expose au LLM. Ce guide couvre l'installation, l'activation et l'application d'un persona.

Trois états par talent

Dans un projet, chaque talent passe par trois états :

  1. Non installé — présent au catalogue, absent du projet.
  2. Installé mais désactivé — dans le projet, mais non servi au LLM.
  3. Installé et actif — servi au LLM par le MCP.

La page projet n'affiche que les talents installés ; le catalogue présente tout. Le MCP ne sert au LLM que les talents actifs.

Page projet

  • Schéma des talents installés — graphe Mermaid (activé / désactivé / requis non installé / manquant), nœuds cliquables vers la fiche talent, avec les stats Installés / Actifs / Manquants.
  • Liste des installés — toggle activer/désactiver, désinstaller, « voir le modèle » (rendu du diagramme structurel des talents enforceable).
  • État vide — « Démarrer avec un persona » (applique un paquet en un clic) ou le catalogue.
  • Connexion MCP (repliable) — retrouve ou régénère le .mcp.json et le stub CLAUDE.md (token révélé une seule fois à la régénération).
  • Validation CI (repliable) — config dependency-cruiser générée depuis les talents.
  • Pertinence (repliable) — règle par projet les paramètres du filtrage sémantique (floor, beta, margin, budget) ; effectif si GRACE_RELEVANCE=embeddings. Voir Activer la pertinence.
  • Onglet Activité — journal des actions tracées + tendance des tokens (voir Tracing & activité).

Appliquer un persona

Un persona applique en un clic un paquet de talents et de réglages (voir Concepts → Personas). Depuis l'état vide d'un projet ou le bouton dédié, choisis un persona : ses talents sont installés et activés ensemble.

Un visualiseur permet d'inspecter en lecture seule les talents d'un persona avant de l'appliquer.

Créer un persona custom

La page Personas (/personas) liste les personas builtin (YAML) et custom (base). Tu peux créer, éditer, dupliquer et supprimer un persona custom (les builtin sont en lecture seule, mais duplicables comme point de départ). Un persona custom n'est qu'un paquet de talents required / recommended — aucune connaissance neuve (voir Concepts → Personas).

Boucle bidirectionnelle

grace_configure(talent, false) depuis le LLM désactive un talent ; le resolve suivant ne le renvoie plus ; le dashboard reflète le changement (même base). La sélection est pilotable des deux côtés, en temps réel.

→ Détail des outils dans Outils MCP ; détail de l'app dans Dashboard.

On this page