Claude Craft

⚠ Warranty Disclaimer

THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. See LICENSE for full terms.

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 v8.2 (Claude Code 2.1.117 + Opus 4.7)

Opus 4.7 as default flagship (v8.2.2) -- model ID claude-opus-4-7, 1M context GA (no pricing premium), new xhigh effort level, adaptive thinking only (extended thinking removed), same $5/$25 per M tokens as Opus 4.6
Claude Code 2.1.117 recommended (v8.2.2) -- new commands /btw, /hooks, /reload-plugins, /proactive, /ultrareview, /tui, /recap, /undo, /effort slider, native CLI binary (v2.1.113), forked subagents (CLAUDE_CODE_FORK_SUBAGENT=1, v2.1.117), prompt caching env vars (ENABLE_PROMPT_CACHING_1H, v2.1.108)
Fast Mode preserved on Opus 4.6 -- /fast reste Opus 4.6 exclusif (2.5x speed, 6x cost). Opus 4.7 n'a pas de Fast Mode.
Node.js 22 LTS migration (v8.2.1) -- CI workflows migrés, élimine les deprecation warnings GitHub Actions (Node 20 EOL avril 2026). Minimum utilisateur reste Node.js 20+.
CI repair (v8.2.3) -- Deploy Documentation (Playwright strict mode), Generate SBOM (migration vers @cyclonedx/cyclonedx-npm CLI), SLSA workflow retiré (redondant avec npm publish --provenance).
Documentation sync (v8.2.4) -- formations claude-code + claude-craft, settings sub-agent model, README, CLI-REFERENCE.md alignés sur l'écosystème actuel.
See CHANGELOG and .claude/COMPATIBILITY.md 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.

New to Claude Craft? Run /getting-started in Claude Code for a 10-minute guided tour that shows you the 3 most valuable commands for YOUR project.

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`
Paperclip	2026.403.0	`--tech=paperclip`

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 211 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 211 commands
Agents	All 72 agents
Skills	Best practices reference
Technologies	Stack-specific guides
BMAD Guide	Project management framework
Hooks	Pre/Post tool execution
MCP	Model Context Protocol integration
Privacy Policy	Data protection and GDPR compliance
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.

tooling