diff --git a/AGENTS.md b/AGENTS.md index cce3b5a..737a088 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -42,6 +42,20 @@ hardware fields in `run.yaml` carry the identity. move all the crates together, and never mix backend features across them. A bump can change measured numbers, so it belongs in its own commit with a rerun. +## Pushing + +Work lands on main through a pull request rather than a direct push. An agent +may push a branch and open the pull request when asked to, and the merge stays +a human decision. Force push only while a branch is still unreviewed: after +someone has reviewed, a force push detaches their comments from the code they +describe. + +A pull request that adds or replaces `result//` states in its +description which machine produced the sweep, so the numbers are reviewed +together with the hardware behind them. Keep hostnames out of the description +as well as out of the files: on a public repository a hostname leaks the +operator's institution and location over time. + ## Prose style No em dashes or en dashes anywhere in this repository's documents, comments or