Skip to content

Commit 05ac623

Browse files
committed
docs: add test authorship tags to AGENTS
1 parent 75e6960 commit 05ac623

1 file changed

Lines changed: 27 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,33 @@ repos/{owner}/{repo}/milestones --jq '.[].title'`, and pick the best match.
113113
end on clarifications unless truly blocked. Every rollout should conclude
114114
with a concrete edit or an explicit blocker plus a targeted question.
115115

116+
## Test authorship tags
117+
118+
Use these tags to make the provenance of newly added unit tests explicit. Use
119+
the host language's comment syntax, and place the tag immediately above the
120+
test function, test class, or at the top of a new test file when the whole file
121+
has the same provenance.
122+
123+
- `AGENT-AUTHORED <model>`: the test was authored by an agent and has not yet
124+
been materially reviewed or rewritten by a human. Agents must add this tag
125+
when generating new unit tests, for example:
126+
127+
```python
128+
# AGENT-AUTHORED gpt-5.5
129+
```
130+
131+
- `HUMAN-REVIEWED`: a human has materially reviewed or rewritten an
132+
agent-authored test. Prefer replacing `AGENT-AUTHORED <model>` with this tag
133+
instead of keeping both.
134+
- `HUMAN-AUTHORED`: the test was authored by a human, or rewritten enough that
135+
the authorship is primarily human.
136+
137+
Use at most one authorship tag per test. Treat missing tags as legacy or
138+
unknown provenance, not as implicit `HUMAN-AUTHORED`. When an agent notices a
139+
human adding a new test or materially modifying an existing test, suggest
140+
adding `HUMAN-AUTHORED` or replacing `AGENT-AUTHORED <model>` with
141+
`HUMAN-REVIEWED` as appropriate.
142+
116143

117144
# Editing constraints
118145

0 commit comments

Comments
 (0)