ArchAgent

Level 3 — 16/20 | archagent-docs.pages.dev | GitHub

Checklist

Level 1: Foundation ✅

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

Level 2: Structure ✅

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

Level 3: Decisions & Diagrams ✅

• [x] ADR directory with template
• [ ] At least one real ADR (only template exists)
• [x] Mermaid plugin
• [x] Architecture diagram (platform vs runtimes)
• [x] Alternatives documented (in getting-started)

Level 4: API & Types

• [ ] API reference
• [x] Data models (platform vs runtime boundary table)
• [x] Environment variables

Level 5: Polish

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

What's Missing

1. First real ADR — record the platform-vs-runtime boundary decision, or the Cloud Run deployment choice
2. API reference — document the Firebase Functions API endpoints
3. Migrate content from docs-legacy/ — the old HTML docs have architecture, billing, data model, topology pages that should be converted to markdown

Stats

• 3 pages + ADR template
• 1 Mermaid diagram
• 26 legacy HTML docs in docs-legacy/ awaiting migration