Pourquoi Rocky sépare agents et skills
Les agents sont la porte d'entrée courte. Les skills sont la référence profonde chargée seulement si besoin. Cette séparation garde une session Rocky disciplinée autour de 4-6k tokens handbook.
Ici on parle de comment le handbook Rocky est construit, pas de si MCP économise des tokens sur votre app. Pour ça, voir le rapport de valeur.
Source: why-agents-and-skills-are-split.md.
L'idée en une phrase
Les agents sont la porte d'entrée courte. Les skills sont la référence profonde que vous chargez seulement quand la tâche a besoin de templates ou de longues checklists.
Pourquoi on sépare
| Si tout vivait dans le fichier agent | Ce qui se passe |
|---|---|
| Longs templates (Vitest, Jest, Playwright, checklists hexagonales) | Chaque invoke charge des milliers de tokens avant que le modèle lise votre code |
| Agents en double | Deux portes d'entrée, drift, contexte gaspillé |
| Prompt qui dump toutes les URI handbook | Le modèle traite l'index comme une liste de lecture |
| Avec split agent + skill | Ce qui se passe |
|---|---|
| Agent environ 40-60 lignes | Rôle, discovery, routing |
Skill SKILL.md | Exemples et checklists seulement si besoin |
Règle: environ 1 244 lignes sur 24 agents. Une session disciplinée lit environ 4k-6k tokens de handbook, pas tout le corpus.
Prompts et routing
devkit-start-task utilise une table router et un plafond: lire au plus 2-3 ressources handbook. Il n'embarque pas les 37 URI.
devkit-review-code pointe exactement trois ressources: code-reviewer, human-readable-code, tests.