Testing API docs with two cold Claude Code subagents surfaced 16 doc issues

Unusual-Albatross43 · reddit · 2026-10-27

Before documenting his open-source Angelia project (a local gateway between WhatsApp/Telegram and coding agent CLIs on Mac), the author ran two Claude Code subagents (Sonnet and Haiku) against the docs cold — only an llms.txt start link, no source code, against a real daemon. Both produced working scripts: Sonnet wrote Python in 6 tool calls, Haiku Node in 11. They surfaced 16 doc issues, 12 now fixed. Biggest traps: the core flow only lived in example code; an undocumented side effect sent task answers to the real chat; no stdlib Python Unix-socket sample (only curl); two contradictory descriptions of history paging; and links pointing to three different places. The author asks whether anyone runs cold-agent doc tests on a schedule in CI.

Original post →

More from coding & agent

coding & agent channel →