One sentence describing what this project does.
Current status: See SNAPSHOT.md for what's decided, in progress, and built.
This project uses a structured AI-assisted documentation framework built on Claude Code and VS Code. If you're new, start here:
- docs/setup/claude-code.md — Install Claude Code and set your model to Sonnet (do this first)
- docs/setup/vscode.md — VS Code extensions and workspace configuration
- docs/setup/github.md — Connect to this repository
- docs/setup/first-session.md — Your first session walkthrough and hello world steps
project_root/
├── docs/
│ ├── setup/ Environment and onboarding (start here)
│ ├── explorations/ Per-person working space (docs/explorations/{name}/)
│ ├── decisions/ Shared, stable decisions — the source of truth
│ ├── foundation/ Technical reference docs
│ ├── raw/ External reference material
│ └── _prompts/ Reusable prompt templates for AI-assisted documentation
└── temp/ Gitignored: large source files, session prompts
Explore → Document → Decide → Build
Work begins in your personal docs/explorations/{name}/ directory. Once ideas are ready to share, they cross into docs/decisions/ or docs/foundation/. The docs/_prompts/ templates help make that transition consistent.
See CLAUDE.md for the full conventions that govern this structure.
(Describe the problem this project solves.)
Each collaborator works in their own docs/explorations/{name}/ directory. Exploration disagreements are expected. Once an idea is ready to become a shared decision, use the prompts in docs/_prompts/ to formalize it.
If you're unsure whether something is settled, ask Claude Code:
"Is there a decision doc covering X? What do the explorations say about it?"