2.6 KiB
agents
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 (INSTRUCTIONS). The rules of a target the upgrader and the validator change (what may change in it, what a regression is) are the target's own CLAUDE.md: written once, read by both and by whoever edits the target by hand.
| Agent | Its trade | Request parameters | Called by |
|---|---|---|---|
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) |
upgrader |
improve a target (a git repository) on the evidence given, without overfitting, one commit per fix | Target, Evidence, Checks (or none), Base, Files already modified, output folder, INSTRUCTIONS: <file> |
Optimizer (optimize skill): the detectors (instructions/upgrader-detectors.md), then the tools (instructions/upgrader-tools.md) |
validator |
judge an upgrader's change on the checks and the code, without its diagnosis: keep, remove some fixes, cancel | Target, Modification, Base, Checks (before, after, after each fix), output, INSTRUCTIONS: <file> |
Optimizer, the detectors (instructions/validator-detectors.md) |
Launching them
The repository is a Claude Code plugin (.claude-plugin/plugin.json), loaded read-only:
claude -p "<request>" --plugin-dir ~/agents --agent agents:analyst
In a workflow, through the Agent tool: subagent_type: agents:upgrader, with --plugin-dir ~/agents when the session is launched.
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.
Taken on 2026-11-16 from Diagnostic-App (analyst, tool-builder, commit dd6f1bf) and from detectors (upgrader, validator, commit 5438b0b); the same day, the upgrader and the validator were made generic on a target and the tool-builder folded into the upgrader (docs/superpowers/specs/2026-11-16-generic-agents-design.md). The architecture of the repositories: ~/Diagnostic-App/docs/architecture.drawio.