1.5 KiB
1.5 KiB
CLAUDE.md
tools: the reading harness of the AIMsight agents (README.md), and nothing else. The user guide is GUIDE.md; a new tool or a new option goes into it in the same change. DATA.md (what the data are) is maintained by hand by the user; GUIDE.md is the tool-builder's.
- Checking a change: rerun the touched tool from a calling repository (Diagnostic-App:
python3 tools/scripts/<tool>.py data/<STATION> --start … --end …), and the commands of the guide that use it;python3 scripts/quality.py --self-test.
Rules:
- A tool returns values: no threshold, no category, no "anomaly", no "normal"; the analyst judges.
- Nothing specific to a station, a sensor or a date.
- No import from the detectors (
detectors/). - Standard library; matplotlib, through the caller's
.venv/bin/python, for the figures only. - Never a value from
metrics/that is an identifier (SIM_CCID,ip*); read-only ondata/; never read.env. - Break nothing: existing options and outputs stay, the analyses' reports cite commands that must keep working.
scripts/data.pyis the common reader of the app and the tools: touch it only to fix a reading error. The app passes these measurements to the detectors (the events of the Data page), which otherwise read withdetectors/scripts/data.py(benchmark, Optimizer): a reading fix here is carried over there, otherwise the page and the benchmark diverge silently.- Every time is in UTC. Commits by path, never
git add -A. Language: English.