Task: write a fact from probe or scenario output

View as Markdown Open in Claude (claude.ai) Open in ChatGPT (chatgpt.com)

Goal

One file in facts/ that states one measured finding, how it was measured, and what was not measured.

Inputs

Steps

  1. Find the next free number: the highest facts/NNN-*.md plus one.
  2. Make facts/NNN-<short-slug>.md with these headings, as in facts/README.md: Measured, What was measured, Mechanism, Incident, Screens, Not measured.
  3. Under Measured, give the date, the agent version, the OS and CPU type, how it was measured (the probe or the scenario), and one line Measured on: real machine, Measured on: CI runner <image>, or Measured on: emulation <image>.
  4. Under What was measured, write only what the output shows. Use /work/example for each path and dev for each account name. Do not copy conversation text.
  5. Under Not measured, list what a reader could expect but the run did not show: other OSes, other versions, other keys.
  6. Add the fact number to the Facts column of the probe or scenario in its README.
  7. Run sh tools/sync-go-data.sh, then the checks in AGENTS.md.
  8. Commit with feat: add fact NNN .... Open a pull request.

Done when

CI passes, and each sentence of the fact comes from the output.