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

download .zip

Clone from GitHub

Prefer to clone directly from the repository?

git clone https://github.com/deMGoncalves/documentation-first-approach.git
view on GitHub

Package 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.git

2. 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 code

3. Start using

Start Claude Code and use the commands

$ claude

You: /vision Create a task management app
You: /feature User can create tasks
You: /code

System 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.