Task: write a fact from probe or scenario output
Goal
One file in facts/ that states one measured finding, how it was
measured, and what was not measured.
Inputs
- Probe output (from the kit) or scenario output (from
out/). - The agent version and the OS of the run.
Steps
- Find the next free number: the highest
facts/NNN-*.mdplus one. - Make
facts/NNN-<short-slug>.mdwith these headings, as infacts/README.md:Measured,What was measured,Mechanism,Incident,Screens,Not measured. - Under
Measured, give the date, the agent version, the OS and CPU type, how it was measured (the probe or the scenario), and one lineMeasured on: real machine,Measured on: CI runner <image>, orMeasured on: emulation <image>. - Under
What was measured, write only what the output shows. Use/work/examplefor each path anddevfor each account name. Do not copy conversation text. - Under
Not measured, list what a reader could expect but the run did not show: other OSes, other versions, other keys. - Add the fact number to the
Factscolumn of the probe or scenario in its README. - Run
sh tools/sync-go-data.sh, then the checks inAGENTS.md. - Commit with
feat: add fact NNN .... Open a pull request.
Done when
CI passes, and each sentence of the fact comes from the output.