Show HN: Dari-docs – Optimize your docs using parallel coding agents
By
byhong03
It’s well known at this point that documentation needs to be optimized for AI agents - we’re all pointing our Claude Code / Codex / Pi agents at documentation, and expecting the models to figure out how to implement a product.
This, however, changes the entire optimization problem when writing documentation. Good documentation now becomes more objective - you are solving the very concrete problem: can a dumb harness running the dumbest model implement this reliably?
Humans can typically compensate for inconsistent terminology or scattered context across pages, but for agents, this often will waste time (or even just completely confuse the agent).
We’ve been building a small project around this called dari-docs: users can upload their documentation via website or CLI and run agents across different providers to see where they falter. You can upload your documentation, feed a list of tasks, and ask agents with varying intelligence / cost levels to complete those tasks in parallel. When a run is complete, you get back a list feedback markdown files from each agent run and can apply changes based on agent feedback.
Managed service: https://optimize.dari.dev/, repo link: https://github.com/mupt-ai/dari-docs
The agents actually try to use the product end-to-end. They search through the docs, follow instructions, run commands, try examples, and attempt to debug failures. Importantly, this is not a static LLM review of the documentation. The agents are actually attempting the integration.
You can also enable live verification with test credentials so the agents can actually verify workflows against real APIs:
dari-docs check . --live-verify --secret-env DARI_TEST_API_KEY --task "Create a checkout session"
If you’re building a CLI, API, MCP server, or SDK and actively maintaining docs for humans or agents, we’d love to work with you and test this on real workflows!
Comments URL: https://news.ycombinator.com/item?id=48210615
Points: 5
# Comments: 1
You might also wanna read
Stoicism and Overthinking: How Marcus Aurelius' Private Writings Offer Ancient Tools for Modern Anxiety
This article from "The Examined Life" newsletter (Issue #4) explores Stoic philosophy through the lens of Marcus Aurelius, who wrote his fam
From Bottleneck to Empowerer: Applying the Leader-Leader Model in Engineering Management
The article discusses the common challenge engineers face when transitioning from individual contributor roles to engineering leadership pos
Sergey Brin tells Google AI staff 60-hour workweek is the 'sweet spot' for productivity
Sergey Brin, Google cofounder, wrote an internal memo to employees working on the Gemini AI products recommending a 60-hour workweek as the
Solar desalination system eliminates toxic brine while producing fresh water
Scientists have developed a solar-powered desalination system that converts seawater into fresh water without producing toxic brine, a major
A design engineer's crisis: Quitting tech amid AI disillusionment
A design engineer reflects on quitting their stable, well-paying tech job amid growing disillusionment with the industry's direction, partic
Why being skeptical of AI is a rational and necessary choice
This opinion piece argues that skepticism and criticism of AI is a healthy, rational response rather than a sign of ignorance. It pushes bac
