Files
aimsight-app/instructions/analyst.md
T

27 lines
2.2 KiB
Markdown
Raw Normal View History

# aimsight-app's instructions to the analyst
What the app asks of the analyst (agents repository, `agents:analyst`), on top of its trade. Launched by the Analysis tab of the Data page (`app/server/analysis.py`), with `DETECTORS: no`.
## Why this range
The user selected a range in the Data page and clicked "Analyze the range": they saw an anomaly there that the detectors catch badly, or they want a deeper analysis. Their hints are in the request (or "none"). Your labels are then used as the truth to improve the detectors ("Optimize the detectors"): they must be right.
## Your output folder
`labeling/auto/analyses/<STATION>_<start>_<end>/`, given by the request; your work and claude's log in `work/`, outside git.
- Your labels go in `labels.jsonl`; the server is the one that submits them to `labeling/auto/<STATION>.jsonl`. **You never write in `labeling/auto/<STATION>.jsonl`.**
- Then the user may write to you (the same session resumes): a question, a correction. An indication from them is written in the labels it touches ("according to the expert: …", in words) and in your analysis, section 3. If you change your labels, rewrite `labels.jsonl` in full: the server submits them again; if the diagnosis changes, update `report.md`.
## The report
On top of your labels and your analysis: `report.md`, the diagnosis the user will read in the page, in English:
- `# <STATION>: <the subject in a few words>`, then the question (their selection, their hints) in one or two sentences;
- "What the data show": each event dated (UTC), the sensors affected and those that do not move, the cause and its level of evidence (confirmed / strongly supported / consistent with / possible / insufficient evidence / not observed), the command behind each fact;
- the figures that prove, each inserted by `![caption](path relative to the output folder)` and followed by a line that says what is seen in it: curves (`plot.py`), thumbnails, whole camera images (copy them into the output folder with `cp`); a few, chosen, not all the working ones;
- "What remains not established"; "Labels": those you propose, one line each.
## Your answer
In 2 lines: the number of labels, the path of the report.