Analyst knowledge: reading-rules.md, stations.md, a phenomenon catalogue in families.md; the label map and knowledge/ archived

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-16 12:47:01 +01:00
1 parent 1c8479d962
commit 4688d8ab9e
16 files changed
+201 -17

No files matched your search

+2 -2
View File
@@ -3,9 +3,9 @@
labeling: the AIMsight displacement labels and the knowledge to place them, in a single copy on the workstation (`README.md`). Diagnostic-App reads and writes there, Optimizer only reads, both through a link `labeling -> ~/labeling`; commits are made here.
- **The labels**: `manual/<STATION>.jsonl` (the expert, for him alone), `auto/<STATION>.jsonl` (the agents, reviewed by `review`), one per line, `{"id", "start", "end", "family", "description", ...}`. The Diagnostic-App analyses: `auto/analyses/<STATION>_<start>_<end>/`.
- **The knowledge**: `families.md` (the families, their boundaries), `labeling-rules.md` (bounds, a single event, description, stated cause), `label-map.md` (the phenomena, via its summary), `knowledge/`.
- **The knowledge**, one source per kind (`README.md`), maintained by hand: `families.md` (the families, their boundaries, the catalogue of phenomena), `labeling-rules.md` (bounds, a single event, description, stated cause), `reading-rules.md` (what the data mean), `stations.md` (the installations); the cases are the labels, through `precedents.py`; what the data are: `tools/DATA.md`. A piece of knowledge lives in one of them only.
- **The tools**, standard library: `python3 validate.py [STATION | file.jsonl]` (the rules), `python3 ids.py [STATION]` (the stable id of new labels), `python3 precedents.py "<text>" [--exclude STATION START END] [--family F] [--k N]` (the RAG; it starts the Ollama container `ollama-bge-m3` by itself if it does not answer; `--check` without it).
- **Verify**: `python3 validate.py` (today 18 expected errors: the labels submitted by the app without `review`) and `python3 precedents.py --check`.
- **Verify**: `python3 validate.py` (today 19 expected errors: the labels submitted by the app without `review`) and `python3 precedents.py --check`.
Rules:
- **`manual/` is the expert's, for him alone**: no agent and no process reads or writes there; the whole project (analyst, precedents, benchmark, optimization) uses only `auto/`.