Repository navigation
Remove the three retired conventions from every AGENTS.md #93
Description
Why
Three paragraphs were pasted into most AGENTS.md files and have since been dropped from the standard: they are process notes, not facts an agent needs before its first edit.
- "Real work not scheduled becomes a GitHub issue" (26 repos)
- the
INVARIANT:docstring convention (25 repos) - the
# ty: ignorenote (18 repos;tyhonours# type: ignoretoo, and every ty repo already uses# ty: ignoreuniformly, so the note enforces nothing)
Change
Delete those paragraphs from each AGENTS.md. Nothing else changes: repos that use INVARIANT: docstrings (modern-di, faststream-outbox) keep them as local practice, and faststream-outbox keeps its test_invariant_census.py.
Done when
grep -l 'not scheduled\|INVARIANT:\|# ty: ignore' */AGENTS.md across the org checkouts returns nothing.
Activity
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
10 remaining items
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
docs(agents): drop the retired paragraphs and keep the canonical ones…
lesnik512 commentedon Sep 13, 2026
Done across all 28 repos, one PR each on branch
agents-md-canonical(the org repo's own in #99).grep -l 'not scheduled\|INVARIANT:\|# ty: ignore' */AGENTS.mdacross the org checkouts onmainreturns nothing.Where a retired token sat inside a sentence stating a repo fact (chat-app, httpware, modern-di, faststream-outbox, lite-bootstrap, litestar-sqlalchemy-template, that-depends), the sentence was reworded rather than deleted. faststream-outbox keeps
test_invariant_census.pyand a one-line pointer to it. compose2pod also lost the sametynote spelled without the#, which the grep does not catch.