One-Session Contract
Each session must produce one of these outcomes:
- a completed stage artifact and outcome report
- a smaller committed proof artifact plus an outcome report explaining the blocker
- a no-code research/design artifact where the stage explicitly says design only
Do not silently leave partial work. If hardware access, credentials, or a toolchain fails, capture the command, exact error, and the next concrete unblock step.
Branch And Commit Rules
Use one branch per stage:
stage/<stage-id>-short-name
Commit after the artifact and outcome report are both present. Commit messages should be factual:
Complete D3-01 surveillance probe
Document D3-04 Pi KOS blocker
Do not commit private .env, tokens, auth JSON, SSH keys,
emulator save data with credentials, or full disc images.