Owner ruling (Moshe, 2026-11-06 18:01Z to 18:06Z, for pitboss#301 and bats#612): docs that become outdated by code are removed, not fixed; documents that stay are high level and point to the command's help text or to the package's generated docs for anything below high level; the code is the authority; docstrings and comments next to the code are updated with the code. "We need to stop with the bs 'update docs' in bats too."

Scan of repository-prototype (2026-11-06, by section headings): CLAUDE.md is 56181 bytes and has the section "## CI is pinned", which restates the repository's workflows, pins and relock behavior; the shared description lives in bats-lang/repository-prototype's CLAUDE.md and goes stale here whenever a workflow changes. README.md: 0 section heading(s), 22 bytes (headings named API, usage, functions, reference or commands).

Done-when: the "CI is pinned" section of CLAUDE.md is removed, or replaced by one line pointing to repository-prototype's CLAUDE.md ("A library's check.yml is a caller of package-check.yml" and "CI Pattern: every input is pinned"); any passage of CLAUDE.md or README.md that restates what the code does (a list of functions, their signatures, a command's flags or output) is removed or replaced by a pointer to the package's generated docs or to the command's help text; sections that state a decision, its research, or what is proved apart from what is tested stay; a comment in the PR lists each section of CLAUDE.md and README.md and what became of it (kept as a decision, pointer, removed). If this repository's CI or tests read the removed text (grep before removing), that is changed in the same PR.


---
_Generated by [Claude Code](https://claude.ai/code)_
