Add the releveur agent for difficulties in automatic processes (D-060)
Each /boucle subagent now ends its output with a Difficultés section; at the end of a session the orchestrator calls the releveur once, which locates the instruction or file at fault and records it in docs/ameliorations-processus.md, without fixing anything. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3281f5c601
commit
260d7f70fc
10 files changed
+91
-10
No files matched your search
@@ -0,0 +1,15 @@
|
||||
# Améliorer les processus automatiques
|
||||
|
||||
Carnet des difficultés rencontrées par les processus automatiques du projet (aujourd'hui `/boucle`), tenu par l'agent `releveur` (D-060). Chaque sous-agent finit son rendu par une section `## Difficultés` ; en fin de processus, l'orchestrateur les transmet au releveur, qui les note ici. Les corrections se font ensuite, dans une conversation à part, à partir de ce carnet.
|
||||
|
||||
## Comment noter une difficulté
|
||||
|
||||
Une entrée par cause, sous la rubrique du processus :
|
||||
|
||||
- **Titre court** (AAAA-MM-JJ, *consigne floue* | *contradiction* | *consigne absente* | *chemin* | *format* | *commande* | *autre*) : ce qui s'est passé, en une ou deux phrases. *En cause* : `fichier:ligne` (la consigne, le fichier ou la commande). *Occurrences* : séance, lot, agent ; une par ligne ou séparées par « ; ». *Piste* (facultative) : une phrase.
|
||||
|
||||
Une même cause revue ajoute une occurrence, pas une entrée. Quand le processus est corrigé, l'entrée prend la mention **traité**.
|
||||
|
||||
## /boucle
|
||||
|
||||
- **Nom de la branche de séance** (2026-10-24, *contradiction*) : le skill nomme la branche avec l'heure (`boucle/<SEANCE>_<STATION>`, `SEANCE` = `date -u +%Y-%m-%dT%H%MZ`), la spec avec le jour seul (`boucle/<AAAA-MM-JJ>_<STATION>`), alors qu'elle donne l'heure au dossier de la séance ; l'orchestrateur a suivi le skill. *En cause* : `.claude/skills/boucle/SKILL.md:16-17` et `:57` contre `vues-deplacements/contexte/boucle-automatique.md:44` et `:115` (le plan `docs/superpowers/plans/2026-10-24-boucle-automatique.md:195` et `vues-deplacements/CLAUDE.md:23` suivent le skill). *Occurrences* : essai du releveur, sans séance, orchestrateur. *Piste* : aligner la spec sur le skill (avec le jour seul, deux séances le même jour sur la même station tomberaient sur la même branche).
|
||||
@@ -663,3 +663,14 @@ Règles du journal :
|
||||
- **Pourquoi** : demande de l'utilisateur, qui est l'expert : les détecteurs calculent sans finesse, l'agent sait raisonner avec une base de connaissances. Sur CLARIDEN, avant C-004 (rapport `2026-10-15T1346Z_CLARIDEN_19-09-matin`), l'agent avait relevé les faits mais conclu à un mouvement de caméra mal compensé, conséquence indéterminée ; l'expert y voit un mouvement réel : toutes les cibles corrigées vont dans le même sens au même moment, aucune anomalie documentée ne l'explique, et des références réparties ne bougent pas toutes ensemble.
|
||||
- **Options écartées** : un nouvel agent à côté de `diagnostic` (le même outil, à faire évoluer) ; écrire pour lui le raisonnement de l'expert sur les références (refus de l'utilisateur : c'est à l'agent de comprendre) ; fusionner avec l'analyste (l'analyste critique la méthode et nourrit la base ; l'agent de diagnostic sert un cas).
|
||||
- **Conséquence** : ses outils propres, pour plus de précision, restent à faire (autre conversation) ; vérification proposée, non lancée : CLARIDEN repassé sans C-004 ni `incident-de-barcelone.md`. Spec : `docs/agents/agent-diagnostic.md`.
|
||||
|
||||
## D-060 — 2026-10-24 — Processus automatiques : un releveur des difficultés
|
||||
- **Statut** : active ; complète D-057.
|
||||
- **Décision** :
|
||||
- dans un processus automatique à plusieurs agents, où l'utilisateur n'est pas là pour voir ce qui coince (aujourd'hui `/boucle`), chaque sous-agent finit son rendu par une section `## Difficultés` : consigne floue, contradictoire ou absente qui l'a fait deviner, fichier ou chemin introuvable, format inattendu, commande qui échoue ; « aucune » sinon ; seulement le processus, pas les données ni les détecteurs ;
|
||||
- en fin de processus, l'orchestrateur appelle une fois l'agent `releveur` (`.claude/agents/releveur.md`) avec ces rendus et ses propres difficultés ; le releveur retrouve la consigne ou le fichier en cause (`fichier:ligne`), regroupe les occurrences d'une même cause et note tout dans `docs/ameliorations-processus.md`, une rubrique par processus ; il ne corrige rien ;
|
||||
- les corrections se font ensuite, à la main, dans une conversation à part qui part de ce carnet : pas d'agent pour elles ;
|
||||
- les conversations ordinaires, où l'utilisateur suit l'agent en direct, n'ont pas ce mécanisme.
|
||||
- **Pourquoi** : demande de l'utilisateur : les processus sont perfectionnables (prompts, chemins, formats, contradictions), mais personne ne lit tout ce que font les agents ; le seul moyen de les améliorer est qu'une difficulté soit relevée et centralisée au moment où elle arrive.
|
||||
- **Options écartées** : relire après coup les transcriptions des séances (l'utilisateur veut un agent à l'écoute, à qui l'on transmet ; un agent qui fouille le projet de lui-même reste une piste) ; laisser chaque sous-agent appeler le releveur (un sous-agent ne peut pas lancer d'agent : tout passe par l'orchestrateur) ; un appel à chaque difficulté (plus cher, inutile puisque rien n'est corrigé sur le moment).
|
||||
- **Conséquence** : un processus automatique nouveau reprend le même circuit (section `## Difficultés`, appel du releveur en fin de processus). Le nom de l'agent est un choix de Claude.
|
||||
Reference in new issue
Block a user