English: the analyst (agents:analyst; DETECTORS, Events, INSTRUCTIONS) and the tool-builder; label keys start/end/family

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-16 12:40:03 +01:00
1 parent 53d8e64415
commit cd569cbe96
7 files changed
+160 -159

No files matched your search

+12 -12
View File
@@ -1,24 +1,24 @@
# agents
Les agents génériques AIMsight, un seul exemplaire de chacun. Un agent ne dit ici que son métier ; tout ce qui est propre à un appelant (ses chemins de sortie, le format de son rapport, ses règles git) lui arrive dans la requête, ou par un fichier de consignes que la requête nomme.
The generic AIMsight agents, one copy of each. An agent states only its trade here; everything specific to a caller (its output paths, its report format, its git rules) reaches it in the request, or through an instruction file the request names.
| Agent | Son métier | Paramètres de la requête | Appelé par |
| Agent | Its trade | Request parameters | Called by |
|---|---|---|---|
| `analyste` | lire une plage comme l'expert et l'étiqueter, avec une analyse qui justifie chaque étiquette | station, plage, indices, dossier de sortie, `DETECTEURS : oui \| non`, `CONSIGNES : <fichier>` | Diagnostic-App (`consignes/analyste.md`, `DETECTEURS : non`) |
| `tool-builder` | faire entrer les scripts utiles d'une analyse dans le harnais de lecture (dépôt tools) | l'analyse, le dépôt tools, le chemin de son rendu | Diagnostic-App, après l'optimisation |
| `upgrader` | corriger les détecteurs sur une plage, sans sur-apprentissage | celle du skill `improve` (en anglais) | Optimizer |
| `validator` | juger la modification de l'upgrader sur toutes les stations et familles | celle du skill `improve` (en anglais) | Optimizer |
| `analyst` | read a range like the expert and label it, with an analysis that justifies each label | station, range, hints, output folder, `DETECTORS: yes \| no` (with `yes`, `Events: <command>`), `INSTRUCTIONS: <file>` | Diagnostic-App (`instructions/analyst.md`, `DETECTORS: no`) |
| `tool-builder` | bring the useful scripts of an analysis into the reading harness (tools repository) | the analysis, the tools repository, the path of its report | Diagnostic-App, after the optimisation |
| `upgrader` | fix the detectors on a range, without overfitting | that of the `improve` skill | Optimizer |
| `validator` | judge the upgrader's modification on every station and family | that of the `improve` skill | Optimizer |
## Les lancer
## Launching them
Le dépôt est un plugin Claude Code (`.claude-plugin/plugin.json`), chargé en lecture :
The repository is a Claude Code plugin (`.claude-plugin/plugin.json`), loaded read-only:
```bash
claude -p "<requête>" --plugin-dir ~/agents --agent agents:analyste
claude -p "<request>" --plugin-dir ~/agents --agent agents:analyst
```
Dans un workflow, par l'outil Agent : `subagent_type: agents:upgrader`, avec `--plugin-dir ~/agents` au lancement de la session.
In a workflow, through the Agent tool: `subagent_type: agents:upgrader`, with `--plugin-dir ~/agents` when the session is launched.
L'appelant lance depuis sa racine, qui porte les liens `data/` (les stations, `~/aimsight-data/data`), `labeling/` (`~/labeling`), `tools/` (`~/tools`), et `detectors/` (`~/detectors`) quand l'agent en a besoin ; il donne `--add-dir` sur leurs cibles réelles pour que l'agent y lise ou y écrive. Claude n'écrit pas dans un plugin chargé : ce qui s'écrit (les outils, les détecteurs, les séances) vit dans les autres dépôts, jamais ici.
The caller launches from its root, which carries the links `data/` (the stations, `~/aimsight-data/data`), `labeling/` (`~/labeling`), `tools/` (`~/tools`), and `detectors/` (`~/detectors`) when the agent needs it; it gives `--add-dir` on their real targets so that the agent can read or write there. Claude does not write into a loaded plugin: what gets written (the tools, the detectors, the sessions) lives in the other repositories, never here.
Repris le 2026-11-16 de Diagnostic-App (`analyste`, `tool-builder`, commit dd6f1bf) et de detectors (`upgrader`, `validator`, commit 5438b0b). L'architecture des dépôts : `~/Diagnostic-App/docs/architecture.drawio`.
Taken on 2026-11-16 from Diagnostic-App (`analyst`, `tool-builder`, commit dd6f1bf) and from detectors (`upgrader`, `validator`, commit 5438b0b). The architecture of the repositories: `~/Diagnostic-App/docs/architecture.drawio`.