claude-craft

claude-craft

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

Stars: 84

Visit
 screenshot

Claude Craft is a comprehensive framework for AI-assisted development with Claude Code, providing standardized rules, agents, and commands across multiple technology stacks. It includes autonomous sprint capabilities, documentation accuracy improvements, CI hardening, and test coverage enhancements. With support for 10 technology stacks, 5 languages, 40 AI agents, 157 slash commands, and various project management features like BMAD v6 framework, Ralph Wiggum loop execution, skills, templates, checklists, and hooks system, Claude Craft offers a robust solution for project development and management. The tool also supports workflow methodology, development tracks, document generation, BMAD v6 project management, quality gates, batch processing, backlog migration, and Claude Code hooks integration.

README:

Claude Craft

npm version CI License: MIT

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

Autonomous Sprint Ready: Run entire sprints overnight with /common:ralph-sprint - auto-claim, error recovery, parallel processing.

What's New in v5.15

  • Documentation Accuracy: Fixed COMMANDS.md counts, added /workflow: and /php: sections
  • CI Hardening: Vale prose linter added to CI pipeline, coverage thresholds
  • Test Coverage: CLI run() and installer error paths now tested
  • See CHANGELOG for full details

See CHANGELOG.md for previous versions.

Features

  • 10 Technology Stacks: Symfony, Flutter, Python, React, React Native, Angular, C#/.NET, Laravel, Vue.js, PHP
  • Infrastructure Stack: Docker agents and commands
  • 5 Languages: English, French, Spanish, German, Portuguese
  • 40 AI Agents: Specialized reviewers, architects, coaches, UI/UX, Docker experts, Workflow Orchestrator, Ralph Conductor, 10 BMAD agents, and QA Recette
  • 157 Slash Commands: Automated workflows, code generation, sprint management, quality gates, batch processing, acceptance testing
  • BMAD v6 Framework: Complete project management with status-based routing, quality gates, and batch execution
  • Ralph Wiggum: Continuous loop execution with Definition of Done validation
  • 249 Skills: Best practices in official Claude Code format (architecture, testing, security)
  • 33 Templates: Code generation patterns + BMAD templates
  • 21 Checklists: Quality gates for commits, features, releases
  • Hooks System: Pre/Post tool execution, quality gates, notifications, BMAD context injection
  • MCP Templates: Context7, GitHub, PostgreSQL, Slack integration
  • Auto-generated CLAUDE.md: Project configuration file created at installation
  • Multi-Account Manager: Manage multiple Claude Code accounts easily
  • Custom Status Line: Rich status bar with profile, model, git, context %

Workflow Methodology

Claude-Craft includes a BMAD-inspired workflow system that adapts to your project complexity.

Development Tracks

Track Setup Time Phases Best For
Quick Flow < 5 min Implementation only Bug fixes, hotfixes, small tweaks
Standard < 15 min Plan → Design → Implement New features, refactoring
Enterprise < 30 min Analyze → Plan → Design → Implement Platforms, migrations, multi-team

Getting Started with Workflows

# Initialize workflow - auto-detects complexity
/workflow:init

# Or specify track
/workflow:init --quick      # Bug fix mode
/workflow:init --enterprise # Full methodology

# Check progress
/workflow:status

Workflow Commands

Command Phase Purpose
/workflow:init Setup Analyze project, recommend track
/workflow:analyze Analysis Research and exploration (Enterprise)
/workflow:plan Planning Generate PRD, personas, backlog
/workflow:design Design Tech spec, architecture, ADRs
/workflow:implement Implementation Sprint development with TDD/BDD
/workflow:status Any Show current progress

Document Generation

# Generate Product Requirements Document
/project:generate-prd

# Generate Technical Specification
/project:generate-tech-spec

BMAD v6 Project Management

BMAD v6 (Build, Measure, Analyze, Deliver) extends the workflow system with comprehensive project management.

10 BMAD Agents

Agent Role Key Commands
bmad-master Orchestrator /bmad:route
pm Product Manager /pm:prd, /pm:vision, /pm:roadmap
ba Business Analyst /ba:analyze, /ba:requirements, /ba:use-cases
architect System Architect /arch:design, /arch:techspec, /arch:adr
po Product Owner /po:prioritize, /po:accept, /po:reject
sm Scrum Master /sm:plan-sprint, /sm:daily, /sm:retro
dev Developer /dev:implement, /dev:tdd, /dev:refactor
qa QA Engineer /qa:validate, /qa:automate, /qa:strategy
ux UX Designer /ux:wireframe, /ux:journey, /ux:accessibility
qa-recette QA Recette Engineer /qa:recette, /qa:recette-fix, /qa:recette-status, /qa:recette-regression

Status-based Routing

Stories automatically transition through a state machine:

backlog → ready-for-dev → in-progress → review → done
   ↓          ↓              ↓           ↓
   └──────────┴──────────────┴───────────┴→ blocked
# View sprint status with routing info
/sprint:bmad-status

# Get next story ready for development
/sprint:next-story --claim

# Transition story status
/sprint:transition US-005 review

# Run automatic routing rules
/sprint:auto-route

5 Quality Gates

Gate Threshold When
PRD Gate ≥80% Vision → PRD
Tech Spec Gate ≥90% PRD → Tech Spec
Backlog Gate INVEST 6/6 Tech Spec → Backlog
Sprint Ready 100% Backlog → Sprint
Story DoD 100% Dev → Done
# Validate PRD quality
/gate:validate-prd docs/prd.md

# Check INVEST compliance
/gate:validate-backlog

# Verify story meets Definition of Done
/gate:validate-story US-005

# Full gates report
/gate:report

Batch Processing

Process multiple stories automatically:

# Queue all stories from an epic
/project:run-epic EPIC-002

# Process the queue
/project:run-queue --parallel 3

# Execute full sprint
/project:run-sprint --auto

# Check batch status
/project:batch-status

Backlog Migration

Convert existing backlogs to BMAD v6:

# Analyze current backlog structure
/project:analyze-backlog

# Migrate to BMAD v6 format
/project:migrate-backlog --dry-run
/project:migrate-backlog

# Add missing fields to stories
/project:update-stories

# Sync files with sprint-status.yaml
/project:sync-backlog

Claude Code Hooks Integration

Enable BMAD hooks in .claude/settings.json:

{
  "hooks": {
    "SessionStart": [{
      "command": ".bmad/hooks/sprint-context.sh",
      "timeout": 5000
    }],
    "PreToolUse": [{
      "command": ".bmad/hooks/story-status.sh",
      "once": true,
      "timeout": 3000
    }],
    "Stop": [{
      "command": ".bmad/hooks/quality-gate.sh",
      "timeout": 10000
    }]
  }
}

Quick Start

Method 1: NPX (Recommended)

# Interactive installation wizard
npx @the-bearded-bear/claude-craft

# Or install to specific directory
npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=fr

Method 2: Clone Repository

git clone https://github.com/TheBeardedBearSAS/claude-craft.git
cd claude-craft

Then install rules to your project:

# Install Symfony rules (default: English)
make install-symfony TARGET=~/my-project

# Install with specific language
make install-symfony TARGET=~/my-project RULES_LANG=fr

# Install React rules in German
make install-react TARGET=~/my-project RULES_LANG=de

# Install all technologies
make install-all TARGET=~/my-project RULES_LANG=es

3. Use in Claude Code

Once installed, use the commands in your project:

/symfony:check-architecture
/react:generate-component Button
/common:pre-commit-check

Supported Technologies

Technology Skills Commands Agents Focus
Common 7 21 11 Cross-tech best practices, UI/UX
Symfony 16 10 1 Clean Architecture, DDD, API Platform
Flutter 10 10 1 BLoC pattern, Material/Cupertino
Python 6 10 1 FastAPI, async/await, Type hints
React 8 8 1 Hooks, State management, A11y
React Native 11 7 1 Navigation, Native modules
Angular 6 6 1 Standalone, Signals, OnPush, RxJS
C#/.NET 7 6 1 Clean Architecture, CQRS, Entity Framework
Laravel 6 6 1 Clean Architecture, Pest PHP, Sanctum
Vue.js 6 6 1 Composition API, Pinia, Vitest
PHP 6 5 1 Clean Architecture, PSR-12, PHPStan, Pest
Docker - 4 5 Dockerfile, Compose, CI/CD, Debugging

Project Structure

claude-craft/
├── Makefile                    # Main orchestration
├── claude-projects.yaml        # YAML configuration (user copy)
├── Dev/
│   ├── i18n/                   # Internationalized content
│   │   ├── en/                 # English
│   │   ├── fr/                 # French
│   │   ├── es/                 # Spanish
│   │   ├── de/                 # German
│   │   └── pt/                 # Portuguese
│   │       ├── Common/         # Shared agents, commands & skills
│   │       ├── Symfony/        # PHP backend
│   │       ├── Flutter/        # Mobile Dart
│   │       ├── Python/         # Backend/API
│   │       ├── React/          # Frontend JS/TS
│   │       ├── ReactNative/    # Mobile JS/TS
│   │       ├── Angular/        # Angular frontend
│   │       ├── CSharp/         # C#/.NET backend
│   │       ├── Laravel/        # PHP/Laravel backend
│   │       ├── VueJS/          # Vue.js frontend
│   │       └── PHP/            # PHP Clean Architecture
│   └── scripts/                # Installation scripts
├── Infra/                      # Infrastructure (Docker)
│   ├── i18n/                   # Translated agents & commands
│   └── install-infra-rules.sh
├── Project/                    # Project management commands
│   ├── i18n/                   # Translated commands
│   └── install-project-commands.sh
├── Tools/                      # Claude Code utilities
│   ├── MultiAccount/           # Multi-account manager
│   ├── StatusLine/             # Custom status line
│   ├── ProjectConfig/          # YAML project manager
│   └── PluginExport/           # Export as Claude Code plugins
├── cli/                        # NPX CLI (npx @the-bearded-bear/claude-craft)
│   ├── index.js                # CLI orchestrator (dispatches to lib/ modules)
│   ├── flattener.js            # Codebase flattener
│   └── lib/                    # Extracted CLI modules
│       ├── banner.js           # ASCII art banner & success messages
│       ├── help.js             # Usage help text
│       ├── installer.js        # Installation wizard & script runner
│       ├── ralph.js            # Ralph Wiggum loop launcher
│       ├── colors.js           # ANSI color definitions
│       ├── constants.js        # Technologies, languages, tracks
│       ├── detect-project.js   # Project detection utilities
│       └── parse-args.js       # CLI argument parser
└── bundles/                    # Web platform bundles
    ├── chatgpt/                # ChatGPT bundle
    ├── claude/                 # Claude Projects bundle
    └── gemini/                 # Gemini Gems bundle

What Gets Installed

After installation, your project will have the TCL-optimized structure:

your-project/
└── .claude/
    ├── CLAUDE.md           # Minimal config (~200 tokens) - auto-loaded
    ├── INDEX.md            # Quick reference summaries (~1,300 tokens)
    ├── context.yaml        # File-based skill triggers
    ├── settings.json       # Permissions and tool allowlists
    ├── references/         # Full documentation (loaded on-demand via @)
    │   ├── base/           # Universal principles (SOLID, DRY, etc.)
    │   └── {tech}/         # Technology-specific rules
    ├── skills/             # Best practices (official format)
    │   ├── architecture/   # Architecture patterns
    │   ├── testing/        # Testing strategies
    │   └── security/       # Security guidelines
    ├── agents/             # AI specialist definitions
    ├── commands/           # Slash commands
    │   ├── common/
    │   └── {tech}/
    ├── hooks/              # Pre/Post tool execution scripts
    ├── mcp/                # MCP server templates
    ├── checklists/         # Quality gates
    └── templates/          # Code generation templates

Token Optimization (TCL)

The TCL structure reduces context from ~70,000 to ~3,500 tokens (95% reduction):

Level Content Tokens Loading
Always Loaded CLAUDE.md + INDEX.md ~1,500 Automatic
On-Demand Skills ~variable Via /skill-name or triggers
Reference Full rules ~0 Via @.claude/references/...

Access full documentation with: @.claude/references/{tech}/architecture.md

Installation Methods

Method 1: Makefile (Recommended)

# Single technology
make install-symfony TARGET=~/my-project

# Common rules only
make install-common TARGET=~/my-project

# Preset combinations
make install-web TARGET=~/my-project      # React
make install-backend TARGET=~/my-project  # Symfony + Python
make install-mobile TARGET=~/my-project   # Flutter + React Native

# Infrastructure (Docker)
make install-infra TARGET=~/my-project

# Install Claude Code tools
make install-tools                        # All tools
make install-statusline                   # Custom status line
make install-multiaccount                 # Multi-account manager
make install-projectconfig                # Project config manager

# Migrate existing projects to v3.0
make migrate TARGET=~/my-project          # Upgrade project
make migrate-dry-run TARGET=~/my-project  # Preview changes

Method 2: YAML Configuration (Monorepos)

# claude-projects.yaml
settings:
  default_lang: "en"  # Default language for all projects

projects:
  - name: "my-monorepo"
    root: "~/Projects/my-monorepo"
    lang: "fr"        # Override: French for this project
    common: true
    modules:
      - path: "frontend"
        tech: react
      - path: "backend"
        tech: symfony
      - path: "mobile"
        tech: flutter
make config-install PROJECT=my-monorepo

Multi-Technology Modules (v3.2+)

You can specify multiple technologies for a single module. This is useful for fullstack folders or projects using multiple frameworks:

projects:
  - name: "fullstack-app"
    root: "~/Projects/fullstack"
    modules:
      # Single technology (legacy syntax)
      - path: "api"
        tech: symfony

      # Multiple technologies - inline array
      - path: "frontend"
        tech: [react, laravel]

      # Multiple technologies - YAML list
      - path: "dashboard"
        tech:
          - vuejs
          - symfony

When multiple technologies are specified:

  • The first technology installs common rules (SOLID, TDD, etc.)
  • Subsequent technologies skip common rules to avoid duplicates
  • All tech-specific rules, commands, and agents are installed

Method 3: Direct Script

# Default language (English)
./Dev/scripts/install-symfony-rules.sh --install ~/my-project

# With specific language
./Dev/scripts/install-symfony-rules.sh --lang=fr ~/my-project
./Dev/scripts/install-flutter-rules.sh --lang=de ~/my-project

CLI Tools

Codebase Flattener

Generate a context-optimized summary of your codebase for AI assistants:

# Generate flattened context
npx @the-bearded-bear/claude-craft flatten

# With custom output file
npx @the-bearded-bear/claude-craft flatten --output=CONTEXT.md

# For large codebases (automatic sharding)
npx @the-bearded-bear/claude-craft flatten --max-tokens=50000

Features:

  • Smart file selection (ignores node_modules, vendor, etc.)
  • Automatic document sharding for large projects
  • Token estimation
  • Priority-based file ordering
  • File tree generation

Web Bundles

Use Claude-Craft methodology outside of Claude Code:

claude-craft/bundles/
├── chatgpt/claude-craft-bundle.md    # For ChatGPT Custom Instructions
├── claude/claude-craft-bundle.md     # For Claude Projects
└── gemini/claude-craft-bundle.md     # For Gemini Gems

Copy the appropriate bundle into your preferred AI platform's custom instructions.

Available Agents

Workflow Agent

Agent Expertise
workflow-orchestrator Intelligent routing, phase coordination, track selection

Common Agents

Agent Expertise
api-designer REST/GraphQL API design
database-architect Database optimization
devops-engineer CI/CD, Docker, deployment
performance-auditor Performance analysis
refactoring-specialist Safe code refactoring
research-assistant Technical research
tdd-coach Test-Driven Development

UI/UX Agents

Agent Expertise
uiux-orchestrator Coordinates UI, UX, and A11y experts
ui-designer Design systems, tokens, components
ux-ergonome User flows, cognitive ergonomics
accessibility-expert WCAG 2.2 AAA, ARIA, audits

Technology Reviewers

Agent Expertise
symfony-reviewer Symfony code review
flutter-reviewer Flutter code review
python-reviewer Python code review
react-reviewer React code review
reactnative-reviewer React Native code review
angular-reviewer Angular code review
laravel-reviewer Laravel code review
vuejs-reviewer Vue.js code review
php-reviewer PHP code review

Docker/Infrastructure Agents

Agent Expertise
docker-dockerfile Dockerfile optimization, multi-stage builds
docker-compose Compose orchestration, networks, volumes
docker-debug Container troubleshooting, diagnostics
docker-cicd CI/CD pipelines, security scanning
docker-architect Complete Docker architecture design

BMAD v6 Agents (10)

Agent Role Key Responsibilities
bmad-master Orchestrator Agent coordination, workflow routing, metrics
pm Product Manager PRD, vision, roadmap, feature prioritization
ba Business Analyst Requirements, use cases, story mapping
architect System Architect Tech specs, ADRs, API design, security
po Product Owner Backlog management, sprint planning, acceptance
sm Scrum Master Ceremonies, velocity, impediments, retrospectives
dev Developer TDD implementation, code review, refactoring
qa QA Engineer Test strategy, automation, validation
ux UX Designer Wireframes, user journeys, accessibility
qa-recette QA Recette Engineer Chrome automation, acceptance testing, regression detection

Command Namespaces

  • /workflow: - Development workflow (init, analyze, plan, design, implement, status)
  • /project: - Project management (backlog, PRD, tech-spec, sprints, batch processing, migration)
  • /sprint: - BMAD sprint management (status, transitions, routing, TDD)
  • /gate: - Quality gate validation (PRD, tech-spec, backlog, story, sprint)
  • /pm: - Product Manager commands (prd, vision, roadmap, prioritize)
  • /arch: - Architect commands (design, techspec, adr, api, security)
  • /common: - Transversal commands (audit, changelog, CI/CD)
  • /symfony: - Symfony-specific (CRUD, migrations, Doctrine)
  • /flutter: - Flutter-specific (widgets, BLoC, performance)
  • /python: - Python-specific (endpoints, async, typing)
  • /react: - React-specific (components, hooks, a11y)
  • /reactnative: - React Native-specific (screens, native modules)
  • /angular: - Angular-specific (components, signals, standalone)
  • /csharp: - C#/.NET-specific (features, architecture, CQRS)
  • /laravel: - Laravel-specific (controllers, Actions, Pest PHP)
  • /vuejs: - Vue.js-specific (components, composables, Pinia)
  • /php: - PHP-specific (entities, value objects, use cases, Clean Architecture)
  • /docker: - Docker/Infrastructure (compose, debug, pipelines, architecture)
  • /qa: - QA Recette (acceptance testing, regression, Chrome automation)

Documentation

📚 User Guides (Multilingual)

Complete step-by-step tutorials for getting started, developing features, and fixing bugs:

Guide 🇬🇧 EN 🇫🇷 FR 🇪🇸 ES 🇩🇪 DE 🇧🇷 PT
Getting Started EN FR ES DE PT
Project Creation EN FR ES DE PT
Feature Development EN FR ES DE PT
Bug Fixing EN FR ES DE PT
Tools Reference EN FR ES DE PT
Troubleshooting EN FR ES DE PT
Backlog Management EN FR ES DE PT

📖 Guide Index

📋 Reference Documentation

Requirements

  • bash - For installation scripts
  • yq - For YAML configuration parsing (optional)
# Install yq
sudo apt install yq      # Debian/Ubuntu
brew install yq          # macOS

Contributing

Contributions are welcome! Please read our Contributing Guide.

License

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

Acknowledgments

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

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for claude-craft

Similar Open Source Tools

For similar tasks

For similar jobs