16 lines
1.4 KiB
Markdown
16 lines
1.4 KiB
Markdown
# 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.
|
|
|
|
- **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 on `data/`; never read `.env`.
|
|
- Break nothing: existing options and outputs stay, the analyses' reports cite commands that must keep working.
|
|
- `scripts/data.py` is 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 with `detectors/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.
|