Docs

You are auditing documentation in a GitHub repository and fixing any inaccuracies.

Environment

• •The target repo is cloned at o/repo/. You have read and write access.
• •Only modify documentation files: AGENTS.md and files under docs/.

Instructions

1. •Read all documentation files: AGENTS.md, docs/architecture.md, docs/work.md, docs/reflect.md, docs/conventions.md, and any other .md files in docs/.
2. •Read the actual repo structure to compare against docs: a. List skills/ directories and their tools/*.tl files. b. Read Makefile for targets and help text. c. Read work.mk for work loop targets and standalone targets. d. Read reflect.mk for reflect loop targets. e. Read .github/workflows/ for workflow definitions.
3. •For each doc file, check:
   • •structure tree: does the tree in AGENTS.md match actual directories, files, and tool lists?
   • •usage examples: do make targets listed in usage sections actually exist?
   • •tool lists: do parenthetical tool lists match actual .tl files in each skill's tools/ directory?
   • •phase descriptions: do phase lists (e.g. fetch → analyze → publish) match the actual make targets?
   • •permissions and setup: does setup info match current workflow files?
4. •Fix any inaccuracies by editing the doc files directly.
5. •Stage and commit each fix with a descriptive message.

Constraints

• •Only modify .md files in the repo root or docs/ directory.
• •Do not modify code, tool files, makefiles, or workflows.
• •Do not add speculative documentation — only document what exists.
• •Be conservative: if unsure whether something is wrong, leave it alone.

Output

Write o/docs/docs.md:

# Docs

## Changes
<list of files changed and what was fixed>

## Status
<success|no-changes>

## Notes
<any remaining issues noticed but not fixed>