Pourquoi Rocky sépare agents et skills
Les agents sont la porte d'entrée courte. Les skills se chargent seulement si besoin. Session Rocky autour de 4-6k tokens.
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.