refactor(agents): Découpage de consolidateur-wiki en sous-agents à responsabilité unique
Provenance : adapté depuis
fyl-guidelines#15. Fait partie de l'EPIC #3. Dépend des sous-issues "Linter mécanique" et "Workflow de dédoublonnage".
Contexte
agents/consolidateur-wiki/consolidateur-wiki.md couvre aujourd'hui, en un seul agent et une seule passe, l'intégrité structurelle (liens, orphelins, frontmatter), la redondance, les contradictions et la complétude. Une fois le linter mécanique en place, l'intégrité structurelle n'a plus besoin d'un agent LLM — ce qui reste (redondance, contradictions, complétude) est du jugement sémantique irréductible à un script, mais un agent unique qui doit tout couvrir en une passe sur un wiki de taille croissante est un mode d'échec connu (couverture partielle, décisions laissées en attente).
Détails d'implémentation
Créer 4 agents à responsabilité unique dans agents/, en remplacement (ou déprécation progressive) de consolidateur-wiki :
| Sous-agent | Responsabilité | Déclenchement |
|---|---|---|
glossaire-curateur |
Reçoit les nouveaux concepts proposés par ingest, lance le check embeddings, décide auto-approve / flag humain |
Inline, juste après chaque ingestion |
consolidateur-redondance |
Pages à contenu dupliqué/chevauchant | Batch périodique |
consolidateur-contradictions |
Contradictions factuelles cross-pages, utilise les paires candidates générées par similarité d'embeddings de glossaire-curateur pour limiter la comparaison |
Batch périodique |
consolidateur-completude |
Stubs, sections incomplètes, sources raw/ non encore ingérées |
Batch, peu coûteux, peut tourner plus souvent |
- Chaque agent suit la convention existante du repo (
metadata.json+ fichier.mdde persona/workflow). - Documenter les cadences de déclenchement recommandées dans
docs/llm-wiki-STRUCTURE_MAP.md. - Décision à documenter : suppression complète de
consolidateur-wiki.mdou conservation comme routeur d'entrée vers les 4 sous-agents.
Critères d'acceptation
-
4 fichiers agents créés avec persona/workflow propres à chacun -
glossaire-curateurintégré au pipeline inline deingest -
Cadences de déclenchement documentées -
Décision documentée sur le sort de consolidateur-wiki.md