1 month ago
Mon Dec 29, 2025 8:00pm PST
Show HN: I built an AI that generates clean docs for vibe-coded apps
I love vibe coding. I hate writing docs.

Every time I shipped something fast with Cursor / Replit / Antigravity, docs became the bottleneck. GitBook felt heavy, manual writing felt dishonest (the code kept changing), and most AI doc tools wanted me to “explain” my own code.

So I built a small tool that does the opposite:

Connects to a repo

Reads the code + structure

Infers architecture, flows, APIs, and components

Outputs GitBook-style documentation automatically

This started as a personal hack while shipping a side project. The first version was rough (hallucinated edge cases, weak on frontend state), but it already saved me hours per project.

What surprised me:

Repo structure matters more than comments

Vibe-coded apps are harder to document than “clean” ones

Docs don’t need to be perfect to be useful—they need to be current

What’s still broken:

Complex monorepos

Heavy frontend logic

Long-running background jobs

I’m sharing this mostly to learn: How are others handling documentation for fast, AI-assisted builds? Do you write docs manually, skip them, or automate somehow?

Link is in the comments for anyone curious.

read article
comments:
add comment
loading comments...