Show HN: Dari-docs – Optimize your docs using parallel coding agents
Dari-docs is a command-line interface designed to enhance the clarity of documentation for developer agents. It tests documentation by simulating developer tasks and identifies areas where agents encounter difficulties. The tool provides feedback and proposed edits to improve documentation quality, ensuring it is agent-readable.
- ▪Dari-docs tests documentation by sending it to simulated developer agents who attempt to complete tasks using only the provided docs.
- ▪It identifies task-blocking ambiguities, such as unclear setup instructions and inconsistent terminology.
- ▪The tool can generate proposed documentation edits based on the feedback from the simulated agents.
Opening excerpt (first ~120 words) tap to expand
dari-docs Make your docs so good even the dumbest agent can ship. dari-docs is a CLI for testing whether your documentation is clear enough for agents to use. It sends your docs to simulated developer agents, asks them to complete real tasks, reports where they get stuck, and can generate proposed docs edits from that feedback. Use it to turn documentation quality from “seems understandable” into “an agent can actually complete the task.” Why dari-docs? Good docs used to mean “a developer can eventually figure this out.” That is no longer enough. When the reader is an agent, ambiguity becomes measurable.
…
Excerpt limited to ~120 words for fair-use compliance. The full article is at GitHub.