# `/optimize`: one analysis in, detectors and tools optimised Date: 2026-11-16. Size: a small change, across five repositories. ## Intent Everything that optimises lives in Optimizer. Today Optimizer optimises the detectors (`/improve`), while the optimisation of the reading tools is a bare `claude -p --agent agents:tool-builder` call written in Diagnostic-App's server. An analysis run by the analyst already leaves, in its folder, the two things both optimisations need: its labels (`labels.jsonl`, the truth for the detectors) and its own scripts plus what it missed (`scripts/`, `analysis.md`, the material for the tools). So the workflow takes **one analysis** and optimises **both**. ## Goals - One skill, `/optimize`, in Optimizer: input an analysis folder, output one session folder and one summary. - Diagnostic-App's "Optimize" button makes a single call, to `/optimize`. - Optimizer's scope becomes "the detectors and the tools, from an analysis". ## Non-goals - No change to the analyst: it already writes its scripts in `/scripts/` and says what it missed. - No validator for the tools; the tool-builder stays as it is in its decisions. - No toolbox for the scripts of the upgrader and validator (`sessions/*/tools/`): later. - No change to the benchmark, the agents' judgement, or the labels. ## Anti-goals - Optimizer writing in `labeling/` (read-only): the tool-builder's outputs move to the session folder. - One step's failure blocking the other. ## Approaches 1. **Extend `/improve` into `/optimize ANALYSIS: `** (picked). The skill derives its inputs from the analysis, runs the current detectors steps, then the tool-builder, then writes one summary. One file, one session, one line in Diagnostic-App. `/improve` has a single caller, so nothing needs it alone. 2. Keep `/improve`, add `/optimize` calling it then the tool-builder. Nothing existing moves, but two layers and two summaries to merge, for no caller that wants the detectors alone. 3. Two skills called in turn by Diagnostic-App. Smallest diff, but the process (the order, the session) stays in Diagnostic-App, against the intent. ## Design **Skill** `.claude/skills/optimize/SKILL.md` (moved from `improve/`). Inputs: - `ANALYSIS` (required): the analysis folder (`request.json`, `labels.jsonl`, `report.md`, `analysis.md`, `scripts/`). - `OUT` (required): the session folder, `sessions/_/`. - Defaults, relative to Optimizer's links, overridable in the request: `DETECTORS: detectors/`, `TOOLS: tools/`, `DATA: data`, `LABELS: labeling/auto` (the folder of `.jsonl`), `FAMILIES: labeling/families.md`. - Derived: `STATION` = `/`; `FROM` = the day of `start`; `TO` = the day after `end` (excluded); labels = `/.jsonl`; reference = `--labels --data `; context = `/report.md`. - `Caller's context`, passed on as today. The multi-station mode (`DATA` + `STATIONS`) is dropped: an analysis is one station and no caller uses it (my call). **Steps.** 1. Detectors: the current steps of `/improve`, unchanged (measures, upgrader, measures, validator, remove/cancel). Commits stay `improve: S` in `DETECTORS` (the agents grep it). 2. Tools, always, whatever step 1 gave: the Agent tool, `subagent_type: agents:tool-builder`, request `Analysis: /. Tools: /. Write /tools.md.` It commits in `TOOLS` itself. 3. Summary `/summary.md`: the current detectors part, then a `## Reading tools` part (the tool-builder's "Tools changed" line and its "What I decided", copied). The current `## Tools` section (the agents' scripts) is renamed `## Scripts of the agents`. **agents repository.** `tool-builder.md`: its trial figures and the reruns of the report's commands write in `/work/`, never in the analysis folder. The "improve workflow" wording of `upgrader.md`, `validator.md` and `README.md` becomes "optimize workflow"; the tool-builder's caller becomes Optimizer. **Optimizer.** Link `tools -> ~/tools`; the launch adds `--add-dir ~/tools`. `README.md` and `CLAUDE.md`: scope "the detectors and the tools", the `/optimize` request, the check command. **Diagnostic-App.** `optimize_thread`: one turn, `/optimize ANALYSIS: labeling/auto/analyses//. OUT: sessions/ _