Download
Get everything you need to start building with the Documentation-First Approach
Get the scaffold
works with any language and stack - TypeScript, Python, Go, Rust, Java, or any other
documentation-first-approach.zip
Complete scaffold with 15 commands, 9 agents, 39 quality rules and templates
Clone from GitHub
Prefer to clone directly from the repository?
git clone https://github.com/deMGoncalves/documentation-first-approach.gitPackage contents
complete project structure with 15 commands, 9 agents, 39 quality rules and all templates
.claude/constitution.md
Governance principles and documentation-first process rules
.claude/commands/
(15) Slash commands - vision, stack, actor, container, component, plan, rule, feature, flow, build, cross, adr, code, import, stats
.claude/skills/
(9) Specialized agents - analyst, architect, orchestrator, developer, gatekeeper, reviewer, tester, documenter, guardian
.claude/templates/
Arc42 templates (12 chapters), C4 diagrams (Context, Container, Component), BDD scenarios (Given-When-Then), ADR (MADR format)
.claude/rules/
(39) Grouped quality rules - SOLID (5), Object Calisthenics (9), Clean Code (10), DDD Tactical (8), Functional Programming (7)
CLAUDE.md
Complete Claude Code usage guide and framework instructions
README.md
Quick start and project overview
What's new in v3.0.0
Added orchestrator agent (critical for task decomposition)
5 new quality rules (functional programming patterns)
Updated Arc42 templates (adaptive complexity)
Gatekeeper validation performance improvements
Dark mode support in all templates
How to install
three simple steps to get started
1. Download the scaffold
Download the .zip or clone from GitHub
# Download the scaffold
$ unzip documentation-first-approach.zip
# Clone from GitHub
$ git clone https://github.com/deMGoncalves/documentation-first-approach.git2. Copy to your project
Extract and copy the .claude/ directory to your project root
$ cp -r .claude /path/to/your/project/
$ cp CLAUDE.md /path/to/your/project/
# Your project structure:
your-project/
├── .claude/ ← New!
├── CLAUDE.md ← New!
├── specs/ ← Will be created
└── src/ ← Your code3. Start using
Start Claude Code and use the commands
$ claude
You: /vision Create a task management app
You: /feature User can create tasks
You: /codeSystem requirements
Essential
- • Claude Code CLI installed (npm install -g @anthropic/claude-code)
- • Anthropic API Key (console.anthropic.com)
- • Git 2.30+ for version control
- • Code editor of your choice
For your language/stack
- • Appropriate runtime (Node.js, Python, Go, Rust, Java, etc.)
- • Package manager for your stack (npm, pip, cargo, maven, etc.)
- • Test framework for your stack (vitest, pytest, etc.)
- • Linter/formatter for your stack (biome, black, clippy, etc.)
Documentation-First Approach is language-agnostic and works with any tech stack you use.