Référence
Manifest
Référence des champs de manifest.yml : identité, graphe, activation, budget.
Le manifest.yml porte l'identité et les métadonnées d'un talent. Référence complète :
catalog/TALENT-STRUCTURE.md.
Champs
id: grace.architecture.hexagonal # identifiant global, namespacé
name: Architecture hexagonale # nom lisible
version: 1.4.0 # semver
type: composite # atomic | composite
status: stable # draft | beta | stable | deprecated
summary: > # 1–2 lignes, utilisé par RAG / index
...
tags: [architecture, backend] # mots-clés de recherche
languages: [typescript, java, rust] # langages couverts par examples/ + conventions/
# ── Graphe de dépendances ──
requires: # prérequis durs, avec contrainte de version
- grace.architecture.use-case >=1.0.0
recommends: # compléments utiles, non bloquants
- grace.ddd.tactical
conflicts: # talents incompatibles
- grace.architecture.active-record
includes: # (composite uniquement) atomiques agrégés
- grace.ddd.value-object
# ── Activation par agent ──
agents: # required | recommended | optional par rôle
planner: recommended
coder: required
reviewer: required
tester: optional
architect: required
# ── Déclencheurs de chargement ──
activation:
triggers: ["hexagonal", "port"] # mots du prompt qui activent le talent
commands: ["/grace use architecture.hexagonal"]
task_types: [feature_implementation, code_review, refactoring]
# ── Budget de contexte (altitude) ──
token_budget:
compact: 500 # taille cible de compact.md
standard: 1800 # compact + rules + workflow
full: 6000 # tout
# ── Priorité de résolution ──
priority:
default: 50 # 0–100 ; arbitrage si plusieurs talents
project_override_allowed: true
# ── Face structurelle (talents enforceable uniquement) ──
structure:
model: c4-component
diagram: structure/model.md
constraints: structure/constraints.yml
enforceable: true # true = validable en CI ; false/absent = comportemental
# ── Sorties attendues ──
outputs: [architecture_decision, code_patch, review_findings]Valeurs énumérées
type:atomic|compositestatus:draft|beta|stable|deprecatedagents.<role>:required|recommended|optionalseverity(dans rules / constraints) :blocking|warning|info
Versionnage
Identifiant : grace.<domaine>.<nom>@MAJOR.MINOR.PATCH.
| Changement | Bump |
|---|---|
| Correction typo, clarification, exemple corrigé | patch |
| Ajout de règle / exemple / langage compatible | minor |
| Convention ou règle cassante (déplacement de port…) | major |
→ Voir Moteur de résolution pour les champs réellement consommés par le resolver, et Écrire un talent pour le guide pas-à-pas.