CLI that sends your docs to simulated developer agents, has them attempt real tasks, and reports where they fail or get stuck.
Key Takeaways
dari-docs check bundles a local docs directory or public URL and submits it to hosted tester agents on dari.dev; --wait streams results inline.
dari-docs optimize goes further: an editor agent proposes file-level rewrites downloaded to .dari-docs/updated/ for manual review before any repo changes.
Managed mode needs only dari-docs auth login and uses a separate credit balance (new accounts get $5 free); self-managed mode runs agents inside your own dari.dev org with custom prompts and dari.yml.
Targets four specific doc failure modes: inconsistent terminology, hidden assumptions, scattered context, and missing setup steps – all quantified via agent task-completion rate.
Ships as a single CLI binary via curl install script; agents are plain dari.dev projects (prompt folders plus a dari.yml manifest), so the tester and editor are fully inspectable.
Hacker News Comment Review
No substantive HN discussion yet; one commenter flagged that agent-driven testing is more actionable than manual doc review, but no technical depth or caveats surfaced.
