DOC
Audit Boilerplate agents/ — ULK-045
Audit Boilerplate agents/ — ULK-045
Résumé exécutif
Analyse de 84 fichiers agents (hors _shared/, checklists/, fichiers méta) pour détecter les n-grams dupliqués ≥10 lignes dans ≥3 agents.
Verdict : le système _shared/ fonctionne bien. Pas d’extraction urgente nécessaire.
Méthode
- Extraction du corps (sans frontmatter) de 84 fichiers agents
- Recherche de blocs de 10 lignes identiques dans ≥3 agents (exact match)
- Recherche de blocs de 5 lignes normalisés (whitespace ignoré) dans ≥3 agents
- Analyse sémantique par mots-clés
Résultats
N-grams exacts ≥10 lignes dans ≥3 agents
0 patterns trouvés. Les agents ne copient pas de blocs verbatim — ils font référence aux fichiers _shared/.
N-grams normalisés (5 lignes) dans ≥3 agents
3 patterns trouvés, tous mineurs :
| # | Agents | Contenu |
|---|---|---|
| 1 | visual-auditor, task-runner, brigitte, marketing-maestro | Section “Commandes utilisateur” (table Markdown structurelle) |
| 2 | obsidian-vault, lovecraft, deploy/vercel | JSON/arrays structurels (bruit) |
| 3 | robocop, blackemperor, bruce | command -v <tool> vérification CLI |
Le pattern #3 est le plus pertinent : vérification CLI (command -v) présente dans 3 orchestrateurs. Ce protocole est déjà documenté dans _shared/cli-tools-protocol.md — les agents y font référence mais répètent parfois l’exemple localement.
Références _shared/ par popularité
Fichier _shared/ | Agents l’utilisant | Couverture |
|---|---|---|
base-rules.md | 43 agents | 51% |
stack-detection.md | 20 agents | 24% |
context-protocol.md | 14 agents | 17% |
auditor-base.md | 10 agents | 12% |
cli-tools-protocol.md | 9 agents | 11% |
update-protocol.md | 8 agents | 10% |
claude-code-mastery.md | 5 agents | 6% |
agent-teams.md | 4 agents | 5% |
memory-protocol.md | 4 agents | 5% |
simplify-principles.md | 2 agents | 2% |
discovery-protocol.md | 1 agent | 1% |
Taille des agents
| Agent | Taille | Note |
|---|---|---|
| lovecraft.md | 50 KB | Trop grand — candidat à découpage |
| steve.md | 31 KB | Acceptable (multi-plateforme) |
| agamotto.md | 31 KB | Acceptable (Figma complexe) |
| bruce.md | 28 KB | Récemment réduit (-35%) |
| pencil-generator.md | 25 KB | Candidat refactoring |
Conclusions
Ce qui fonctionne bien
- La modularisation via
_shared/évite le copier-coller massif - Les références
_shared/sont cohérentes dans les agents majeurs - Aucun bloc de 10+ lignes copié dans 3+ agents simultanément
Opportunités d’amélioration (non bloquantes)
lovecraft.md(50 KB) — Trop grand, candidat à un découpage en modes séparéscommand -vpattern — Présent dans le corps de robocop, blackemperor, bruce malgrécli-tools-protocol.md— remplaçable par une référence purebase-rules.mdmanquant — Quelques agents récents (analyze/, deploy/) ne référencent pas_shared/base-rules.mdalors qu’ils devraient
Convention extends: (nouvelle)
Ajoutée dans .claude/rules/agents-authoring.md : champ frontmatter documentaire pour déclarer explicitement les _shared/ dont hérite un agent. Permet l’audit automatique via le générateur de registre.
Actions recommandées (prochaine session)
| Priorité | Action | Effort |
|---|---|---|
| P3 | Découper lovecraft.md en modes (orchestrate/memory/harmonize) | M |
| P3 | Ajouter extends: dans les 5 agents principaux (bruce, blackemperor, lovecraft, shuri, task-runner) | XS |
| P3 | Vérifier que les agents analyze/ et deploy/ référencent _shared/base-rules.md | XS |