Skip to content
Projects

TheBeardedBearSAS/claude-craft has 108 GitHub stars and 12 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-12 17:08 UTC. Last push 2026-11-11.

How these counts are measured

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.

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Claude Craft — Sprint workflow, multi-stack reviewers, and browser QA for Claude Code teams

The AI framework where bugs don't come back. Sprint workflow, a continuous build loop, browser-based acceptance testing, and token-optimized multi-stack reviewers for tech leads adopting Claude Code with their team. 11 stacks, 5 languages, BMAD v6.

Why teams pick Claude Craft

Four things Claude Code + an Anthropic cookbook won't give you — they're workflow and orchestration, not prompts:

Differentiator What it does
🏆 QA Recette (browser-based) /qa:recette drives Chrome to run acceptance tests and auto-generates a regression test for every bug you fix — the Golden Rule: a fixed bug never comes back. No other Claude Code framework does this.
🚀 BMAD v6 sprint workflow Analyze → Plan → Design → Implement → QA, executed by Claude Code directly with quality gates. Quick Flow < 5 min, Standard < 15 min, Enterprise < 30 min.
🔁 Ralph Wiggum loop /common:ralph-run runs Claude in a continuous loop until your Definition of Done holds — adaptive circuit breaker, native /goal integration, DoD validators.
⚡ RTK token optimization Forked sub-agents, context: fork on heavy skills, 1h prompt caching, Haiku/Sonnet/Opus routing per task. Target 55-65% token savings vs raw Claude Code.

Plus 11 stack-specific reviewers (@symfony-reviewer, @react-reviewer, @python-reviewer…) that enforce SOLID/TDD/Clean Architecture so you don't re-type your conventions every sprint.

Why not just Claude Code + a cookbook? Claude already knows React, Symfony, and Flutter patterns — so Claude Craft's value isn't the prompts, it's the workflow and orchestration around them: a sprint lifecycle with gates, a continuous loop with a real DoD, browser-based regression capture, and per-task token routing. Those are the parts a per-stack cookbook doesn't cover.

npm version npm downloads Claude Code 2.1.321+ CI License: MIT Mutation testing badge

A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects across multiple technology stacks — 33 specialized agents (+39 infra agents on-demand), 143 commands across 18 namespaces, 55 skills, all token-optimized via context: fork and sub-agent model routing.

What's New in v9.2.1

Audit de fraîcheur du 2026-11-11 (v9.2.1) :

  • Sécurité : PgBouncer 1.26.1 (CVE-2026-107350, usurpation d'un utilisateur SCRAM), FrankenPHP 1.13.5 (PHP2Shell), Docker Engine 29.9.3, OpenTofu 1.13.9 ; règle 11 alignée sur NIST SP 800-63B-4 (15 caractères pour un mot de passe seul facteur, blocklist) ; types de serveurs Hetzner retirés remplacés.
  • Exemples corrigés : array_first() PHP 8.5, Laravel AI SDK (laravel/ai), Signal Forms Angular, configuration Vitest projects.
  • Versions vérifiées sur registres : React Native 0.88 / Expo SDK 58, Vercel CLI 65, Paperclip 2026.1106.0, Coolify 4.7.5, Kubernetes 1.37.2, ansible-core 2.22, Helm 4.3.1 ; Node 26 Active LTS, testé en CI (22 / 24 / 26).
  • Aussi dans cette version : stack WordPress 7.1 (--tech=wordpress), hooks installés par défaut (--hooks=default|full|none), Fable 5.2 et Claude Code 2.1.322 recommandé. Détails : CHANGELOG.

What's New in v9.2.0

Deux nouveaux stacks (2026-11-09, v9.2.0) : Rust / Axum (15e) et Tauri (16e), Claude Code recommandé : 2.1.319. Détails : CHANGELOG.

Nouveau stack WordPress (2026-11-10) : --tech=wordpress (communautaire) installe WordPress 7.1 pour plugins et thèmes blocs : 6 règles en anglais (architecture plugin/thème, hooks, block.json/render.php, REST permission_callback, WP-CLI, WPCS/PHPStan, wp-env, tests WP_UnitTestCase / Playwright), l'agent @wordpress-reviewer et /wordpress:check <axe> dans les 5 langues. Modulaire : WooCommerce 11.2 (HPOS, Store API, blocs Cart/Checkout) est livré comme skill woocommerce chargé à la demande, absent du contexte d'un WordPress simple. Détails : CHANGELOG.

Nouveau stack Tauri v2 (2026-11-09) : --tech=tauri (communautaire) installe Tauri 2.12 pour applications desktop et mobile (cœur Rust, front web agnostique) : 6 règles en anglais (architecture src-tauri/, commands/IPC, capabilities et permissions, CSP, pattern Isolation, updater signé, tests mock runtime / mockIPC / WebdriverIO), l'agent @tauri-reviewer et /tauri:check <axe> dans les 5 langues. Détails : CHANGELOG.

Nouveau stack Rust / Axum (2026-11-08) : --tech=rust installe Rust 1.99 (édition 2024) + Axum 0.8 (workspace en couches, Tokio, Tower, SQLx, thiserror + RFC 9457, cargo-nextest, Clippy, cargo-deny) dans les 5 langues : 6 règles, l'agent @rust-reviewer et /rust:check <axe>. Détails : CHANGELOG.

What's New in v9.1.0

Nouveau stack Ruby / Rails (2026-11-01, v9.1.0) : --tech=ruby installe Ruby 4.0 + Rails 8.1 (Rails Way, service/form/query objects, Hotwire, Solid Queue, RSpec ou Minitest, RuboCop, Brakeman) dans les 5 langues : 6 règles, l'agent @ruby-reviewer et /ruby:check <axe>. Claude Code recommandé : 2.1.316. Détails : CHANGELOG.

What's New in v9.0.0

BREAKING — retrait des commandes dépréciées (2026-10-29, v9.0.0) : les 54 stubs de redirection (PM, /common:research-context7, /uiux:orchestrator) et le namespace /sprint: sont supprimés ; claude-craft update les efface des projets. Table de correspondance : MIGRATION-v9. Détails : CHANGELOG.

Un seul /<tech>:check <axe> par stack (v9.0.0) : /react:check architecture|code-quality|security|testing|all remplace les 5 check-* de chaque stack (all = audit noté sur 100) ; /team:sprint devient /team:delivery --phase=implementation. Les anciens noms restent des stubs de redirection jusqu'en 10.0. Table : MIGRATION-v9.

What's New in v8.27.0

Les commandes /team:* sans Agent Teams (2026-10-28, v8.27.0) : /team:audit, /team:security, /team:sprint et /team:delivery délèguent par défaut à des sous-agents (--engine=subagents, compatible claude -p et CI) ; Agent Teams devient optionnel (--engine=teams, repli automatique si CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS est absent). /common:research-context7 et /uiux:orchestrator sont dépréciées au profit du MCP context7 / /deep-research et de l'agent @uiux-orchestrator. Ralph est fiabilisé en mode parallèle (sessions et worktrees isolés). Claude Code recommandé : 2.1.312. Dernière version 8.x avant la 9.0. Détails : CHANGELOG.

What's New in v8.26.0

Un parcours principal pour la gestion de projet (2026-10-26, v8.26.0) : /workflow:init → plan → design → start → implement → review → retro (+ /workflow:status à tout moment, /workflow:auto-sprint de bout en bout). Le namespace /sprint: et les générateurs /project:* deviennent des stubs de redirection jusqu'en 9.0. Il reste 35 commandes de gestion de projet actives au lieu de 86. Guide : Quel parcours ?. Détails : CHANGELOG.

What's New in v8.25.0

Fusion des commandes /project: et /gate: (2026-10-26, v8.25.0) : 5 commandes /project: (backlog, reverse, trace, report, migrate) et une seule /gate:check remplacent 41 commandes ; les anciennes restent des stubs de redirection jusqu'en 9.0. Détails : CHANGELOG.

What's New in v8.24.0

Source de vérité unique du statut (2026-10-26, v8.24.0) : .bmad/sprint-status.yaml porte désormais seul le statut des stories et des tâches. Les fichiers markdown ne portent que le contenu, et le Kanban écrit les déplacements dans la YAML. Nouveau guide Quel parcours ?. Les commandes retirées sont désormais supprimées à l'upgrade (config/removed-commands.yaml), et les commandes mainteneur ne sont plus installées dans les projets. Détails : CHANGELOG.

What's New in v8.23.4

Cohérence des commandes de gestion de projet (2026-10-26, v8.23.4) : 65 références vers des commandes inexistantes corrigées dans les 5 langues (nouveau garde-fou CI command-refs.test.mjs) ; gates alignées sur project-management/ ; arborescence de sprint unique (board.md + tasks/TASK-*.md) ; /workflow:init crée .bmad/sprint-status.yaml ; /workflow:auto-sprint démarre un sprint inexistant. Détails : CHANGELOG.

What's New in v8.23.3

Maintenance sécurité (2026-10-26, v8.23.3) : 30 alertes Dependabot résolues, toutes en dépendances de développement (dompurify 3.4.17 — critical, vite, vitest 4.1.12, devalue…). npm audit à 0 à la racine et dans website/. Détails : CHANGELOG.

What's New in v8.23.2

Correctif de sécurité (2026-10-26, v8.23.2) :

  • zod 4.6.7 : corrige GHSA-mrhx-c7xc-m3w5 (high, épuisement mémoire à la validation).
  • Précédence modèle des sous-agents bornée à Claude Code 2.1.251+ dans la règle 12 (5 langues) et la FAQ, avec un garde-fou CI (claimDenylist) contre le retour d'affirmations périmées sur les modèles. Détails : CHANGELOG.

What's New in v8.23.1

Correctifs d'installation, Kanban et workflow (2026-10-22, v8.23.1) :

  • Installation adaptée à la stack : --tech=a,b,c rend le CLAUDE.md racine, AGENTS.md et .claude/settings.json selon les technos réellement installées ; install-project-commands.sh n'écrase plus les fichiers existants ; @tech-lead agnostique de la stack ; make config-* et check-config.sh réparés.
  • Kanban : lecture des backlogs générés depuis les templates (métadonnées en liste Markdown), plus de documents dupliqués, retrait complet des commentaires HTML imbriqués (alerte CodeQL).
  • Workflow : /workflow:start crée .bmad/sprint-status.yaml, /gate:check sprint fonctionne sans lui. Dépendances et GitHub Actions à jour. Détails : CHANGELOG.

What's New in v8.23.0

Audit de fraîcheur + alignement Claude (2026-10-13, v8.23.0) :

  • Sécurité : classement OWASP Top 10:2025 officiel (A01–A10) dans la règle 11 et ses miroirs, avec test de régression ; FrankenPHP 1.13.0 et PgBouncer 1.26.0 (versions précédentes vulnérables) ; types de serveurs Hetzner et datacenter retirés corrigés.
  • Versions vérifiées sur registres : React 19.3, Flutter 3.47, React Native 0.87 / Expo 57, Pinia 4, Vite 8.3 (rolldownOptions), Vercel CLI 63, Python 3.15, Paperclip 2026.1012.0, Docker 29.9, Kubernetes 1.37 (Gateway API), Vitest 5, Pest 5, pytest 9, PER-CS 3.0.
  • Claude Code : minimum 2.1.260, recommandé 2.1.312, modèles 5.5. Détails : CHANGELOG.

What's New in v8.18.0

Nouvelle commande /workflow:auto-sprint (2026-06-27, v8.18.0) :

  • Orchestrateur de sprint de bout en bout : une seule commande joue le rôle Product Owner / Scrum Master et enchaîne start → decompose → validate → implement → PR → CI watch → review → retro → merge. Chaque cérémonie tourne dans un sous-agent au contexte isolé — l'isolation remplace le /clear manuel entre étapes ; la phase d'implémentation assume le rôle conductor inline (réutilise /team:sprint).
  • PR + CI + merge intégrés (gh) : --auto-merge opt-in (défaut : pause + GO humain) ; échec de gate (validate KO / CI rouge / DoD miss) → auto-fix loop borné (--max-fix-attempts).
  • 5 langues (Dev/i18n/{en,fr,es,de,pt}) ; compteurs réalignés 126 core / 220 total commandes.

What's New in v8.17.2

Revue documentation (2026-06-26, v8.17.2) :

  • Nouveau tutoriel phare : docs/guides/*/10-complete-workflow.md réécrit en walkthrough narré de bout en bout (idée → backlog → sprint → livraison) pour grands débutants — glossaire, modes d'exécution, gates, discipline /clear, exemple TaskFlow + annexe multi-stack. Disponible en 5 langues, lié depuis le README et guides/index.md.
  • Fraîcheur : compteurs et versions réalignés sur le SSOT (125 core / 219 total commandes, 70 agents, 55 skills, 11 stacks ; versions Claude Code min/recommandée ; Flutter 3.44, RN 0.85, Symfony 8.1). Suppression de /bmad:init (→ /workflow:init).
  • Sans doublon : index des guides de migration, en-têtes « narré vs full » (COMMANDS/AGENTS), bannière PLANNED sur MCP-SERVERS, cross-links entre docs concurrentielles, stub docs/SECURITY.md supprimé.

What's New in v8.17.1

Correctifs tests (2026-06-26, v8.17.1) :

  • tests/scripts/ sous docker sans bash : les 12 fichiers shell-out bash "*.sh" échouaient en /bin/sh: bash: not found sous busybox/alpine. Nouveau target make test-scripts-docker (image bash, node:24) + garde tests/scripts/bash-available.test.mjs.

Audit exhaustif multi-agents + mises à jour 2026-06-24 (v8.17.0) :

  • Versions infra : Docker 29.6.1, OpenTofu 1.12.2, Ansible 2.21.1, Helm 4.2.2, Node.js 24.x Active LTS.
  • Sécurité : OWASP Top 10:2025 complet (10/10 catégories dans la règle 11) ; RS256 marqué DEPRECATED ; guidance Argon2id précisée ; hook templates protect-files.json / quality-gate.json corrigés (anti-pattern $TOOL_INPUT → lecture stdin JSON).
  • Modèles : IDs canoniques dans la table d'effort (Opus 4.8 / Sonnet 5 sorti 2026-06-30, intro $2/$10 / Haiku 4.5). Sonnet 5 remplace 4.6 comme Sonnet courant. Fable 5 / Mythos 5 alors retirés des recommandations (note corrigée par l'audit d'alignement du 2026-10-13 : Fable 5.1 est courant, Mythos réservé au Cyber Verification Program).
  • CLI : /goal, /usage, /workflows documentés dans CLI-REFERENCE.md.
  • Optimisation tokens : ENABLE_PROMPT_CACHING_1H et fallbackModel activés dans settings.json distribué.
  • Docs : compteur commandes corrigé (133 → 125 core / 219 total) ; TROUBLESHOOTING, FAQ, CHEAT-SHEET, COMPETITIVE-ANALYSIS enrichis.

Dépendances et supply chain (v8.16.0 / v8.16.1) :

  • Trivy action : aquasecurity/trivy-action mis à jour (v8.16.0) — scan CVE supply chain.
  • Download artifact : actions/download-artifact bumped de 4.2.1 à 8.0.1 (v8.16.0).
  • CodeQL action : github/codeql-action mis à jour (v8.16.0) — analyse SAST.
  • Playwright : @playwright/test mis à jour de 1.60.0 à 1.61.0 dans /website (v8.16.0).
  • Patch de stabilité : correctifs de dernière minute (v8.16.1).

Refonte du design de l'interface web Kanban (v8.15.0) :

  • Thème dark-only opiniâtre d'après une maquette Claude Design : accent acid-lime (oklch, distinct des six teintes de statut), typographie Space Grotesk + JetBrains Mono auto-hébergée via @fontsource (CSP font-src 'self').
  • Panneau Tweaks : code couleur des cartes (statut / priorité / TDD / epic), accent et densité, persistés en localStorage.
  • Les 6 vues restylées (board, backlog, sprints, burndown, deps, docs) ; drag&drop, navigation clavier, <dialog> natifs et a11y préservés. Coloration en helpers JS purs testés.

Interface web Kanban — accès à tous les artefacts BMAD v6 (v8.14.0) :

  • Vue Sprints dédiée : navigation listant tous les sprints (points, stories, badges goal/review/retro) ; le détail rend le Goal, les Stories avec leurs Tasks dépliables, et les sections Review et Retro en markdown (GET /api/sprints, GET /api/sprints/:id).
  • Docs élargis : les corps markdown des EPIC, US, sprint-goal/board/review/retro sont désormais navigables dans le DocsView.
  • Détail US enrichi : la modale du board affiche la liste des tâches associées et la description de la story (/api/stories/:id renvoie body). Tests RED-first, suite complète verte.

Corrections de l'interface web Kanban (v8.13.1) :

  • Dashboard Kanban réparé : 4 bugs corrigés en TDD sur le SPA Svelte 5 (claude-craft kanban) — vue Backlog vide (stories à epic_id inconnu désormais regroupées au lieu d'être perdues), raccourcis clavier inopérants (synchronisation focus + reducer pur), détails de carte inaccessibles (modale au clic/Entrée), et feedback visible (toast) au lieu d'un échec silencieux sur les cartes read-only sprint-status.yaml.

Fiabilité BMAD + distribution AgentTeams (v8.13.0) :

  • /gate:* réparé : ((var++)) sous set -e avortait les scripts de gate/hook après le 1er check (post-incrément = exit 1 quand le compteur vaut 0). 68 occurrences corrigées sur 6 fichiers + tests de non-régression (make test-bmad).
  • Scripts AgentTeams livrés : Tools/AgentTeams/lib/*.sh désormais installés automatiquement avec les commandes /team:* (fini le warning « scripts MISSING » ; dashboard coût et --ralph-mode disponibles out-of-the-box). Install/refresh manuel : make install-agentteams TARGET=..

Audit exhaustif + durcissement (v8.12.0) :

  • Audit multi-domaines (sécurité, DX, concurrentiel, fiabilité, tokens/modèles, docs, architecture) mené par une équipe d'agents avec devil's advocates et vérification de fraîcheur des 14 stacks -- 80 findings, tous les P0/P1/P2 corrigés.
  • Sécurité : CVE FrankenPHP (CVE-2026-45062) et Docker (CVE-2026-33997) patchées ; hook de sécurité distribué corrigé (exit 2) ; durcissement Kanban (CSRF, COEP) et CI supply chain (digests épinglés, SHA256).
  • Optimisation tokens : templates settings.json distribués corrigés (IDs de modèles valides + CLAUDE_CODE_FORK_SUBAGENT).
  • 988 Vitest tests green, mutation testing bloquant sur PRs.

Kanban BMAD v6 integration (v8.11.0):

  • Kanban ingère .bmad/sprint-status.yaml -- le board Kanban lit les sprints directement depuis le fichier YAML BMAD v6 en lecture seule (icône verrou), sans dépendance SaaS. Les projets BMAD v6 n'ont plus le board vide.

Releases 8.8.x → 8.10.x :

  • MIT-only strict (v8.8.0) -- Claude Craft est 100 % open-source MIT, aucune licence commerciale ou enterprise. Stratégie open-core abandonnée.
  • Parité i18n stricte (v8.8.2) -- la CI bloque désormais si un fichier traduit est à < 80 % de la taille de l'anglais. Dette i18n résorbée (gap 101 → 0).
  • Branding the-bearded-bear.com (v8.10.1) -- migration complète des domaines vers the-bearded-bear.com, normalisation de l'organisation GitHub.
  • 126 commandes sur 15 namespaces (v8.10.x) (220 total avec infra/projet) -- namespace /paperclip:* (8 commandes) ajouté, 55 skills disponibles.
  • Claude Code 2.1.322 -- version recommandée (minimum sécurité 2.1.321 ; Opus 5.5 / Sonnet 5.5 / Haiku 5.5, MCP 2026-07-28, hooks onFailure: "block").

← Versions antérieures (v8.0 → v8.7) : voir le CHANGELOG et .claude/COMPATIBILITY.md.

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

# Zero-prompt install (auto-detects your stack + locale, target < 2 min)
npx @the-bearded-bear/claude-craft install --auto

# Install from a team config URL (Gist or internal endpoint)
npx @the-bearded-bear/claude-craft install --from=https://org.example/cc-team.json

# Add a community skill from npm (claude-craft-skill-* convention)
npx @the-bearded-bear/claude-craft skill add claude-craft-skill-foo

# 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 /common: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
  • 33 default agents + 39 infra agents on-demand -- reviewers, architects, coaches that know your stack deeply (72 total potentially installable)
  • 143 slash commands across 18 namespaces -- 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.1 / PHP 8.4+ --tech=symfony
React 19.3 + Compiler 1.0 --tech=react
Flutter / Dart 3.47 / Dart 3.13 --tech=flutter
Python 3.15 / 3.14+ / FastAPI --tech=python
Angular 22 --tech=angular
Vue.js 3.5+ (3.6 RC Vapor) --tech=vuejs
Vite (community) 8.3 --tech=vite
Vercel (community) 65.14.0 --tech=vercel
Tauri (community) 2.12 (desktop + mobile) --tech=tauri
WordPress (community) 7.1 (plugins + block themes, WooCommerce opt-in) --tech=wordpress
React Native 0.88 (New Architecture) --tech=reactnative
C# / .NET 10 LTS / C# 14 --tech=csharp
Laravel 13.x / PHP 8.3+ (8.5 recommandé) --tech=laravel
PHP 8.5 --tech=php
Ruby / Rails Rails 8.1 / Ruby 4.0 --tech=ruby
Rust / Axum Axum 0.8 / Rust 1.99 --tech=rust
Paperclip 2026.1106.0 --tech=paperclip

| Docker | 29.9.3 | --tech=docker | | Coolify | v4.7.5 | --tech=coolify | | Kubernetes | 1.37.2 | --tech=kubernetes | | OpenTofu | 1.13.9 | --tech=opentofu | | Ansible | 2.22.0 | --tech=ansible | | Hcloud | provider 1.70+ / CLI 1.70.2 | --tech=hcloud | | PgBouncer | 1.26.1 (security fixes over 1.26.0) | --tech=pgbouncer | | FrankenPHP | 1.13.5 (PHP2Shell and later security fixes) | --tech=frankenphp |

See Technologies for full details.

What's Included

Category Count Examples
Agents 31 default (+ 39 infra on-demand) @tdd-coach, @api-designer, @symfony-reviewer, @kubernetes-architect, @hcloud-architect
Commands 143 across 18 namespaces (201 total with infra/project, including 66 redirect stubs kept until 10.0) /workflow:init, /team:audit, /react:generate-component
Skills 55 Architecture, testing, security, DDD 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)
/gate:check commit Validate before committing
/project:backlog next story Get next story ready for development
/qa:tdd Test-Driven Development flow
/gate:check story Check story meets Definition of Done
/{tech}:check <axis> Audit architecture, code-quality, security, testing, or all (scored)
/{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 143 commands across 18 namespaces (201 total including infra, project management and the redirect stubs kept until 10.0).

Installation

Platform: Linux and macOS. Windows is not tested and not officially supported.

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

Use Claude Craft Without Claude Code

Claude Craft's principles and rules are available as pre-built bundles for other AI surfaces. No installation required — paste and go.

Surface Bundle Doc
ChatGPT / GPT-5 bundles/chatgpt/claude-craft-bundle.md Multi-IDE Guide
Claude.ai (Web) / Claude Projects bundles/claude/claude-craft-bundle.md Multi-IDE Guide
Gemini / Cursor / Windsurf bundles/gemini/claude-craft-bundle.md Multi-IDE Guide
Codex CLI / other agents bundles/claude/claude-craft-bundle.md Multi-IDE Guide

See bundles/README.md for platform-specific installation instructions and token budgets.

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
Tutorial: Complete Workflow End-to-end narrated walkthrough: idea → backlog → sprint → ship
Which path? Decision page: greenfield, brownfield, bugfix or autonomous sprint
Learning Paths Beginner → Intermediate → Advanced progression
Installation All installation methods
Configuration Project configuration
CLI Reference Full CLI documentation
Commands All 143 commands
Agents All 31 default agents (+ 39 infra on-demand)
Skills Best practices reference
Technologies Stack-specific guides
BMAD Guide Project management framework
Hooks Pre/Post tool execution
MCP Model Context Protocol integration
Ecosystem Curated third-party token/context/review tools
Privacy Policy Data protection and GDPR compliance
FAQ Common questions
Troubleshooting Problem solving
Migration Guide Format migration + version-upgrade index (v3→v8)
Migration v6→v7 Upgrade from v6 to v7
Migration v7→v8 Upgrade from v7 to v8
Agent Teams Guide Multi-agent team orchestration
Cheat Sheet Quick command reference card
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

Project Governance & Sustainability

Claude Craft is maintained by The Bearded CTO, a solo founder with deep involvement in the AFUP and Symfony French ecosystem.

Item Status
Funding model Bootstrapped, community-driven — no VC. 100% open-source MIT, sustained by community contributions.
Maintenance commitment Active development since 2026-01. Targeting weekly minor releases, monthly minor versions.
Bus factor Currently 1 (solo maintainer). Co-maintainer search open — looking for one tech lead from the AFUP / Symfony / Flutter / React community.
Succession plan Documented in CHARTER.md. MIT license guarantees indefinite community fork rights if maintainer disappears.
Roadmap visibility GitHub Issues + CHANGELOG.md + recurring audit/YYYY-MM-DD-* reports
Decision process RFC via GitHub Discussions for breaking changes. ADRs in docs/adr/ for architectural choices.
Security disclosure See SECURITY.md. 90-day disclosure timeline, GPG-signed advisories.
License MIT (free, perpetual). Claude Craft is and remains 100% open-source — no commercial, enterprise, or proprietary tier. See CHARTER.md.

Contributing

Contributions are welcome! Please read our Contributing Guide.

License

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

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.


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

Explore related projects