project-docs

Project Documentation Generator

Generate structured project documentation by analysing the codebase. Produces docs that reflect the actual code, not aspirational architecture.

When to Use

• New project needs initial documentation
• Docs are missing or stale
• Onboarding someone to the codebase
• Post-refactor doc refresh

Workflow

1. Detect Project Type

Scan the project root to determine what kind of project this is:

Indicator	Project Type
wrangler.jsonc / wrangler.toml	Cloudflare Worker
vite.config.ts + src/App.tsx	React SPA
astro.config.mjs	Astro site
next.config.js	Next.js app
package.json with hono	Hono API
src/index.ts with Hono	API server
drizzle.config.ts	Has database layer
schema.ts or schema/	Has database schema
pyproject.toml / setup.py	Python project
Cargo.toml	Rust project

2. Ask What to Generate

Which docs should I generate?
1. ARCHITECTURE.md — system overview, stack, directory structure, key flows
2. API_ENDPOINTS.md — routes, methods, params, response shapes, auth
3. DATABASE_SCHEMA.md — tables, relationships, migrations, indexes
4. All of the above

Only offer docs that match the project. Don't offer API_ENDPOINTS.md for a static site. Don't offer DATABASE_SCHEMA.md if there's no database.

3. Scan the Codebase

For each requested doc, read the relevant source files:

ARCHITECTURE.md — scan:

• package.json / pyproject.toml (stack, dependencies)
• Entry points (src/index.ts, src/main.tsx, src/App.tsx)
• Config files (wrangler.jsonc, vite.config.ts, tsconfig.json)
• Directory structure (top 2 levels)
• Key modules and their exports

API_ENDPOINTS.md — scan:

• Route files (src/routes/, src/api/, or inline in index)
• Middleware files (auth, CORS, logging)
• Request/response types or Zod schemas
• Error handling patterns

DATABASE_SCHEMA.md — scan:

• Drizzle schema files (src/db/schema.ts, src/schema/)
• Migration files (drizzle/, migrations/)
• Raw SQL files if present
• Seed files if present