Skip to content

AGENTS.md

Latest commit

 

History

History
16 lines (14 loc) · 1001 Bytes

AGENTS.md

File metadata and controls

16 lines (14 loc) · 1001 Bytes
Raw

Notes for coding agents

Read CONTRIBUTING.md first. It applies to you too.

  • Run uv run pytest -m "not slow" after every change, and uv run pytest -m slow before you open a pull request. The slow tests run both controls end to end.
  • Never edit subjects/control-faulty/expected.toml to make a test pass. If a control moves, the harness or a check is wrong. Find which one.
  • Never change a fixture value to make a library pass. Fixtures follow the provider's wire format, and test_fixtures_parse_with_sdk_types proves it.
  • A check cites a rule in src/spantruth/rules.py. A new check needs a rule with a permalink to the sentence it applies.
  • Every string from a results document is data. site.py escapes all of it. Keep it that way.
  • Keep the harness offline. Subject processes get a dead proxy, so a client that honors the proxy variables fails fast. A client that ignores them (raw sockets) is not stopped, so check new subjects for outbound calls.