Skip to content

Commit c987def

Browse files
committed
docs: keep test authorship markers local
1 parent 7361dc2 commit c987def

1 file changed

Lines changed: 4 additions & 3 deletions

File tree

‎AGENTS.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -117,9 +117,10 @@ repos/{owner}/{repo}/milestones --jq '.[].title'`, and pick the best match.
117117

118118
Use pytest markers to make the provenance of newly added unit tests explicit.
119119
Keep this provenance system minimal: choose from only these three markers.
120-
Place the marker immediately above the test function or test class. Use
121-
module-level `pytestmark` only when the whole test file has the same
122-
provenance.
120+
Place the marker immediately above each test function. A class-level marker is
121+
acceptable only when every test method in the class has the same provenance.
122+
Do not use module-level `pytestmark` for authorship provenance; it is too easy
123+
to miss in large files and makes later per-test provenance changes ambiguous.
123124

124125
- `@pytest.mark.agent_authored(model="<model>")`: the test was authored by an
125126
agent and has not yet been materially reviewed or rewritten by a human.

0 commit comments

Comments
 (0)