Humanlike

Level 2 — 12/20 | humanlike-docs.pages.dev | GitHub

Checklist

Level 1: Foundation

• [x] VitePress config
• [x] Home page
• [ ] Getting started ❌
• [x] Auto-deploy (Cloudflare Pages)
• [x] Gitignore

Level 2: Structure ✅

• [x] Auto-discovered sidebar
• [x] Subdirectories (prompts/)
• [x] Local search
• [x] Last updated

Level 3: Decisions & Diagrams ❌

• [ ] ADR directory
• [ ] At least one ADR
• [ ] Mermaid plugin
• [ ] At least one diagram
• [x] Alternatives documented (in existing pages)

Level 4: API & Types

• [ ] API reference
• [x] Data models (firestore-schema.md)
• [x] Environment variables

Level 5: Polish

• [ ] Versioned docs
• [ ] Changelog page
• [x] Access control references

What's Missing (to reach Level 3)

1. Getting started page — extract from CLAUDE.md (monorepo layout, build order, key commands)
2. Install Mermaid — pnpm add -Dw vitepress-plugin-mermaid, update config to withMermaid()
3. Create docs/adr/ directory with template
4. Record first ADR — e.g. the decision to use Firebase Functions + Cloud Run split, or the site copilot architecture
5. Add a Mermaid diagram — Twilio call flow is a perfect candidate

Stats

• 12 existing markdown pages (architecture, chat, firestore schema, prompt system, tool system, Twilio flow, etc.)
• 3 prompt templates in prompts/ subdirectory
• Rich existing content — just needs Mermaid + ADR structure