Claude Craft

A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects across multiple technology stacks.

What's New in v7.23

• Claude Code v2.1.61 compatibility -- Windows config corruption fix, native installer recommendation
• Deprecated npm install -- PREREQUISITES updated to recommend native installers (curl https://install.claude.com | bash)
• Context management enhancements -- compaction hints, CLAUDE.local.md, subagent model override, anti-patterns
• See CHANGELOG for full details

Install and First Result

# Install to your project (picks your tech stack interactively)
npx @the-bearded-bear/claude-craft

# Or install directly
npx @the-bearded-bear/claude-craft install ~/my-project --tech=react --lang=en

# Open Claude Code and run your first audit
claude
/team:audit

That's it. You get an architecture, security, and quality audit of your project in minutes.

See Quickstart for a step-by-step walkthrough with expected output at each stage.

Why Claude Craft?

Claude Code is powerful on its own. Claude Craft makes it consistent and team-ready:

• Standardized rules -- SOLID, Clean Architecture, TDD enforced across your team, not just suggested
• 63 specialized agents -- reviewers, architects, coaches that know your stack deeply
• 204 slash commands -- repeatable workflows for audits, code generation, sprint management
• Quality gates -- automated checks at every stage from PRD to deployment
• 5 languages -- English, French, Spanish, German, Portuguese

Supported Technologies

Stack	Version	Install Command
Symfony / PHP	8.0 / PHP 8.5	--tech=symfony
React	19.x	--tech=react
Flutter / Dart	3.38 / Dart 3.10	--tech=flutter
Python	3.13+ / FastAPI	--tech=python
Angular	19.x	--tech=angular
Vue.js	3.5+	--tech=vuejs
React Native	0.76+	--tech=reactnative
C# / .NET	10 LTS / C# 14	--tech=csharp
Laravel	12.x / PHP 8.5	--tech=laravel
PHP	8.5	--tech=php

| Docker | 27+ | --tech=docker | | Coolify | 4.x | --tech=coolify | | Kubernetes | 1.35+ | --tech=kubernetes | | OpenTofu | 1.7+ | --tech=opentofu | | Ansible | 2.18+ | --tech=ansible | | Hcloud | 1.61+ | --tech=hcloud | | PgBouncer | 1.25+ | --tech=pgbouncer | | FrankenPHP | 1.11+ | --tech=frankenphp |

See Technologies for full details.

What's Included

Category	Count	Examples
Agents	63	@tdd-coach, @api-designer, @symfony-reviewer, @kubernetes-architect, @hcloud-architect
Commands	204	/workflow:init, /team:audit, /react:generate-component
Skills	37	Architecture, testing, security best practices
Templates	21	Code generation patterns, BMAD project templates
Checklists	10	Commit, feature, release quality gates

See Agents | Commands | Skills

Workflow Tracks

Claude Craft adapts to your project complexity with three development tracks:

Track	Setup	Phases	Best For
Quick Flow	< 5 min	Implementation only	Bug fixes, hotfixes
Standard	< 15 min	Plan > Design > Implement	New features, refactoring
Enterprise	< 30 min	Analyze > Plan > Design > Implement	Platforms, migrations

/workflow:init              # Auto-detects complexity
/workflow:init --quick      # Bug fix mode
/workflow:init --enterprise # Full methodology

See BMAD Practical Guide for the complete project management framework.

Key Commands

These are the commands you'll use most:

Command	What It Does
/workflow:init	Start a development workflow (auto-detects track)
/team:audit	Full project audit (architecture, security, quality)
/common:pre-commit-check	Validate before committing
/sprint:next-story	Get next story ready for development
/qa:tdd	Test-Driven Development flow
/gate:validate-story	Check story meets Definition of Done
/{tech}:check-architecture	Verify architecture compliance
/{tech}:generate-*	Generate code following project patterns
/common:ralph-run "task"	Run Claude in continuous loop until task is done
/qa:recette	Automated acceptance testing via Chrome

See CLI Reference for all 204 commands across 26 namespaces.

Installation

NPX (Recommended)

npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=en

Clone + Makefile

git clone https://github.com/TheBeardedBearSAS/claude-craft.git
cd claude-craft
make install-symfony TARGET=~/my-project RULES_LANG=en

YAML Configuration (Monorepos)

# claude-projects.yaml
projects:
  - name: "my-monorepo"
    root: "~/Projects/my-monorepo"
    lang: "fr"
    modules:
      - path: "frontend"
        tech: react
      - path: "backend"
        tech: symfony

make config-install PROJECT=my-monorepo

See Installation Guide | Configuration

What Gets Installed

your-project/.claude/
  CLAUDE.md           # Minimal config (~200 tokens, auto-loaded)
  INDEX.md            # Quick reference summaries
  references/         # Full documentation (loaded on-demand via @)
  agents/             # AI specialist definitions
  commands/           # Slash commands
  skills/             # Best practices
  checklists/         # Quality gates
  templates/          # Code generation patterns
  hooks/              # Pre/Post tool execution scripts
  mcp/                # MCP server templates

Context usage is optimized: ~3,500 tokens always loaded vs ~70,000 if everything were inline (95% reduction).

Documentation

Document	Description
Quickstart	Get results in 10 minutes
Installation	All installation methods
Configuration	Project configuration
CLI Reference	Full CLI documentation
Commands	All 204 commands
Agents	All 63 agents
Skills	Best practices reference
Technologies	Stack-specific guides
BMAD Guide	Project management framework
Hooks	Pre/Post tool execution
MCP	Model Context Protocol integration
FAQ	Common questions
Troubleshooting	Problem solving
Migration v7	Upgrade from previous versions
Skills Publishing	Guide for publishing skills
Compatibility	Claude Code version compatibility

User Guides (Multilingual)

Step-by-step tutorials available in 5 languages:

Guide	EN	FR	ES	DE	PT
Getting Started	EN	FR	ES	DE	PT
Feature Development	EN	FR	ES	DE	PT
Bug Fixing	EN	FR	ES	DE	PT

All guides | Project Creation | Tools Reference | Troubleshooting | Backlog Management

Contributing

Contributions are welcome! Please read our Contributing Guide.

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built for Claude Code by Anthropic. Inspired by Clean Architecture and Domain-Driven Design principles.