How I Documented an Entire Product in 4 Days with an AI Agent
This title could be clearer and more informative.Try out Clickbait Shieldfor free (5 uses left this month).
A developer documents 55 pages of end-user documentation for a Tauri desktop app in four days using Goose, an open-source AI agent. The workflow involved building three reusable 'skills' (markdown instruction files): write-docs for voice/style/structure, doc-screenshots for automated screenshot capture via Peekaboo and OCR, and docs-preview for shareable deploy URLs. Screenshots were defined declaratively in a YAML manifest enabling full batch recapture when the UI changed. The agent read source code to understand features, while the author handled editorial decisions. Key lessons: encode conventions into skills rather than re-prompting, make screenshots reproducible via manifests, phase the work, and always review agent output.
Table of contents
The ProblemWhy an AI AgentThe PlanThe Three Skills I BuiltWorking With the Agent, Not Watching ItA Day-by-Day WalkthroughWhat Broke Along the WayWhat Worked Surprisingly WellBy the NumbersWhat I Would Do DifferentlyWhat You Can Take AwayMaking Docs Agent-ReadyAutomated Video Walkthroughs (Work in Progress)The Future: Documentation in an Agent-First World1 Comment
Sort: