@the-bearded-bear/claude-craft 8.7.1-next.c01d0bb → 8.7.1-next.cd47b2d

package/README.md

@@ -1,6 +1,23 @@
 # Claude Craft — Sprint workflow, multi-stack reviewers, and browser QA for Claude Code teams
 
-> **The most complete framework for tech leads adopting Claude Code with their team — 19 stacks, 5 languages, BMAD v6 sprint lifecycle, browser-based acceptance testing.**
+> **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](https://img.shields.io/npm/v/@the-bearded-bear/claude-craft)](https://www.npmjs.com/package/@the-bearded-bear/claude-craft)
 [![npm downloads](https://img.shields.io/npm/dm/@the-bearded-bear/claude-craft)](https://www.npmjs.com/package/@the-bearded-bear/claude-craft)
@@ -9,7 +26,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Mutation testing badge](https://img.shields.io/endpoint?style=flat&url=https%3A%2F%2Fbadge-api.stryker-mutator.io%2Fgithub.com%2FTheBeardedBearSAS%2Fclaude-craft%2Fmain)](https://dashboard.stryker-mutator.io/reports/github.com/TheBeardedBearSAS/claude-craft/main)
 
-A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks — **31 specialized agents (+39 infra agents on-demand), 125 commands across 26 namespaces, 48 skills**, all token-optimized via `context: fork` and sub-agent model routing.
+A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks — **31 specialized agents (+39 infra agents on-demand), 125 commands across 15 namespaces, 48 skills**, all token-optimized via `context: fork` and sub-agent model routing.
 
 ## What's New in v8.3 (Audit-driven release: tokens + security)
 
@@ -25,7 +42,7 @@ A comprehensive framework for AI-assisted development with [Claude Code](https:/
 ## 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)
+- **Claude Code 2.1.154 recommended** -- Opus 4.8 (`claude-opus-4-8`, defaults to high effort + `/effort xhigh`), Dynamic Workflows (orchestrate tens-to-hundreds of background agents, capped at 1000), `/goal`, `claude agents` view, 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`).
@@ -67,7 +84,7 @@ Claude Code is powerful on its own. Claude Craft makes it **consistent and team-
 
 - **Standardized rules** -- SOLID, Clean Architecture, TDD enforced across your team, not just suggested
 - **31 default agents + 39 infra agents on-demand** -- reviewers, architects, coaches that know your stack deeply (70 total potentially installable)
-- **125 slash commands across 26 namespaces** -- repeatable workflows for audits, code generation, sprint management
+- **125 slash commands across 15 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
 
@@ -103,7 +120,7 @@ See [Technologies](docs/TECHNOLOGIES.md) for full details.
 | Category | Count | Examples |
 |----------|-------|---------|
 | **Agents** | 31 default (+ 39 infra on-demand) | `@tdd-coach`, `@api-designer`, `@symfony-reviewer`, `@kubernetes-architect`, `@hcloud-architect` |
-| **Commands** | 125 across 26 namespaces | `/workflow:init`, `/team:audit`, `/react:generate-component` |
+| **Commands** | 125 across 15 namespaces | `/workflow:init`, `/team:audit`, `/react:generate-component` |
 | **Skills** | 48 | Architecture, testing, security best practices |
 | **Templates** | 21 | Code generation patterns, BMAD project templates |
 | **Checklists** | 10 | Commit, feature, release quality gates |
@@ -145,7 +162,7 @@ These are the commands you'll use most:
 | `/common:ralph-run "task"` | Run Claude in continuous loop until task is done |
 | `/qa:recette` | Automated acceptance testing via Chrome |
 
-See [CLI Reference](docs/CLI-REFERENCE.md) for all 125 commands across 26 namespaces.
+See [CLI Reference](docs/CLI-REFERENCE.md) for all 125 commands across 15 namespaces.
 
 ## Installation
 

package/bundles/cursor/.cursorrules

@@ -10,7 +10,7 @@
 
 **Version:** 8.7.1 | **Languages:** en, fr, es, de, pt
 
-A comprehensive AI-assisted development framework for Claude Code with 19 technology stacks, 72 agents, 211 commands across 26 namespaces, and BMAD v6 project management.
+A comprehensive AI-assisted development framework for Claude Code with 11 technology stacks, 31 specialized agents (+39 infra agents on-demand), 125 commands across 15 namespaces, and BMAD v6 project management.
 
 ---
 
@@ -20,7 +20,7 @@ A comprehensive AI-assisted development framework for Claude Code with 19 techno
 |-------|---------|--------------|--------------|
 | **.NET / C#** | 10 LTS / C# 14 | Clean Architecture | CQRS, MediatR (ou alternative), EF Core |
 | **Symfony / PHP** | 8.0 / PHP 8.4+ | Clean Architecture | DDD, Hexagonal, API Platform, JsonStreamer |
-| **Flutter / Dart** | 3.41 / Dart 3.11 | Clean Architecture | BLoC v9, Riverpod 3, Material 3, Impeller |
+| **Flutter / Dart** | 3.44 / Dart 3.12 | Clean Architecture | BLoC v9, Riverpod 3, Material 3, Impeller |
 | **React** | 19.2 + Compiler 1.0 | Feature-based | Hooks, Zustand, React Query, Server Components |
 | **React Native** | 0.85 (New Architecture) | Feature-based | Navigation 7, Reanimated 4, TurboModules |
 | **Angular** | 20 LTS (ou 21) | Domain-driven | Signals, Standalone, Zoneless, httpResource |
@@ -53,7 +53,7 @@ See `@.claude/INDEX.md` for condensed checklists and patterns.
 
 ---
 
-## Available Commands (26 namespaces, 211 commands)
+## Available Commands (15 namespaces, 125 commands)
 
 Core: `/common:*`, `/workflow:*`, `/team:*`, `/qa:*`, `/uiux:*` | Tech: `/symfony:*`, `/react:*`, `/flutter:*`, `/python:*`, `/angular:*`, `/vuejs:*`, `/laravel:*`, `/reactnative:*`, `/csharp:*`, `/php:*`, `/paperclip:*` | Infra (via `@devops-engineer`): Docker 29.4.3, Coolify v4.0.0 (stable), K8s 1.36.1, OpenTofu 1.12.0, Ansible 2.21.0, FrankenPHP 1.12.1, PgBouncer 1.25.2 (CVE-2026-6664/6667 patched) | Project: `/sprint:*`, `/gate:*`, `/project:*`
 
@@ -61,7 +61,7 @@ Full reference: [Commands](../docs/COMMANDS.md) | [CLI Reference](../docs/CLI-RE
 
 ---
 
-## Available Agents (72 agents)
+## Available Agents (31 specialized + 39 infra on-demand)
 
 **Common** (20): `@api-designer`, `@database-architect`, `@devops-engineer`, `@performance-auditor`, `@refactoring-specialist`, `@tdd-coach`, `@uiux-orchestrator`, `@ui-designer`, `@ux-ergonome`, `@accessibility-expert`, `@research-assistant`, `@ralph-conductor`, `@security-auditor`, `@data-analyst`, `@migration-specialist`, `@cost-optimizer`, `@chaos-engineer`, `@devex-engineer`, `@mlops-engineer`, `@observability-engineer` | **Tech Reviewers** (11): `@{symfony,flutter,react,python,angular,laravel,vuejs,reactnative,csharp,php,paperclip}-reviewer` | **Infrastructure** (39): Docker, Coolify, K8s, OpenTofu, Ansible, Hcloud, PgBouncer, FrankenPHP — see [Agents](../docs/AGENTS.md) | **Project** (2): `@product-owner`, `@tech-lead`
 
@@ -169,7 +169,7 @@ make install-symfony TARGET=. RULES_LANG=en
 
 ## Claude Code Compatibility
 
-**Minimum Version:** 2.1.97 (CVE-2025-59536 patched) | **Recommended:** 2.1.118 — See `@.claude/COMPATIBILITY.md` for full changelog (v2.1.20+).
+**Minimum Version:** 2.1.97 (CVE-2025-59536 patched) | **Recommended:** 2.1.154 (Opus 4.8 + Dynamic Workflows) — See `@.claude/COMPATIBILITY.md` for full changelog (v2.1.20+).
 
 ---
 

package/bundles/windsurf/.windsurfrules

@@ -10,7 +10,7 @@
 
 **Version:** 8.7.1 | **Languages:** en, fr, es, de, pt
 
-A comprehensive AI-assisted development framework for Claude Code with 19 technology stacks, 72 agents, 211 commands across 26 namespaces, and BMAD v6 project management.
+A comprehensive AI-assisted development framework for Claude Code with 11 technology stacks, 31 specialized agents (+39 infra agents on-demand), 125 commands across 15 namespaces, and BMAD v6 project management.
 
 ---
 
@@ -20,7 +20,7 @@ A comprehensive AI-assisted development framework for Claude Code with 19 techno
 |-------|---------|--------------|--------------|
 | **.NET / C#** | 10 LTS / C# 14 | Clean Architecture | CQRS, MediatR (ou alternative), EF Core |
 | **Symfony / PHP** | 8.0 / PHP 8.4+ | Clean Architecture | DDD, Hexagonal, API Platform, JsonStreamer |
-| **Flutter / Dart** | 3.41 / Dart 3.11 | Clean Architecture | BLoC v9, Riverpod 3, Material 3, Impeller |
+| **Flutter / Dart** | 3.44 / Dart 3.12 | Clean Architecture | BLoC v9, Riverpod 3, Material 3, Impeller |
 | **React** | 19.2 + Compiler 1.0 | Feature-based | Hooks, Zustand, React Query, Server Components |
 | **React Native** | 0.85 (New Architecture) | Feature-based | Navigation 7, Reanimated 4, TurboModules |
 | **Angular** | 20 LTS (ou 21) | Domain-driven | Signals, Standalone, Zoneless, httpResource |
@@ -53,7 +53,7 @@ See `@.claude/INDEX.md` for condensed checklists and patterns.
 
 ---
 
-## Available Commands (26 namespaces, 211 commands)
+## Available Commands (15 namespaces, 125 commands)
 
 Core: `/common:*`, `/workflow:*`, `/team:*`, `/qa:*`, `/uiux:*` | Tech: `/symfony:*`, `/react:*`, `/flutter:*`, `/python:*`, `/angular:*`, `/vuejs:*`, `/laravel:*`, `/reactnative:*`, `/csharp:*`, `/php:*`, `/paperclip:*` | Infra (via `@devops-engineer`): Docker 29.4.3, Coolify v4.0.0 (stable), K8s 1.36.1, OpenTofu 1.12.0, Ansible 2.21.0, FrankenPHP 1.12.1, PgBouncer 1.25.2 (CVE-2026-6664/6667 patched) | Project: `/sprint:*`, `/gate:*`, `/project:*`
 
@@ -61,7 +61,7 @@ Full reference: [Commands](../docs/COMMANDS.md) | [CLI Reference](../docs/CLI-RE
 
 ---
 
-## Available Agents (72 agents)
+## Available Agents (31 specialized + 39 infra on-demand)
 
 **Common** (20): `@api-designer`, `@database-architect`, `@devops-engineer`, `@performance-auditor`, `@refactoring-specialist`, `@tdd-coach`, `@uiux-orchestrator`, `@ui-designer`, `@ux-ergonome`, `@accessibility-expert`, `@research-assistant`, `@ralph-conductor`, `@security-auditor`, `@data-analyst`, `@migration-specialist`, `@cost-optimizer`, `@chaos-engineer`, `@devex-engineer`, `@mlops-engineer`, `@observability-engineer` | **Tech Reviewers** (11): `@{symfony,flutter,react,python,angular,laravel,vuejs,reactnative,csharp,php,paperclip}-reviewer` | **Infrastructure** (39): Docker, Coolify, K8s, OpenTofu, Ansible, Hcloud, PgBouncer, FrankenPHP — see [Agents](../docs/AGENTS.md) | **Project** (2): `@product-owner`, `@tech-lead`
 
@@ -169,7 +169,7 @@ make install-symfony TARGET=. RULES_LANG=en
 
 ## Claude Code Compatibility
 
-**Minimum Version:** 2.1.97 (CVE-2025-59536 patched) | **Recommended:** 2.1.118 — See `@.claude/COMPATIBILITY.md` for full changelog (v2.1.20+).
+**Minimum Version:** 2.1.97 (CVE-2025-59536 patched) | **Recommended:** 2.1.154 (Opus 4.8 + Dynamic Workflows) — See `@.claude/COMPATIBILITY.md` for full changelog (v2.1.20+).
 
 ---
 

package/cli/lib/constants.js

@@ -5,9 +5,14 @@
 
 import { TECH_REGISTRY } from './tech-registry.js';
 
-/** Available technologies with display name and description (derived from tech-registry.js SSOT). */
+/**
+ * Selectable technologies with display name and description (derived from tech-registry.js SSOT).
+ * Base-layer techs (e.g. php) are excluded — they are auto-included with their framework.
+ */
 const TECHNOLOGIES = Object.fromEntries(
-  Object.entries(TECH_REGISTRY).map(([key, entry]) => [key, { name: entry.displayName, desc: entry.desc }])
+  Object.entries(TECH_REGISTRY)
+    .filter(([, entry]) => !entry.baseLayer)
+    .map(([key, entry]) => [key, { name: entry.displayName, desc: entry.desc }])
 );
 
 /** Available UI languages. */

package/cli/lib/installer.js

@@ -8,6 +8,7 @@ import fs from 'fs';
 import { spawnSync } from 'child_process';
 import c from './colors.js';
 import { TECHNOLOGIES, LANGUAGES } from './constants.js';
+import { getBaseLayerTechsFor } from './tech-registry.js';
 import { printBanner, printSuccess } from './banner.js';
 import { assertSafeTarget } from './path-safety.js';
 
@@ -247,11 +248,19 @@ export async function autoInstall(cli, { CLI_ROOT, VERSION }) {
 export async function runInstallation(cli, { CLI_ROOT }) {
   console.log(`\n${c.bold}Installing Claude-Craft...${c.reset}\n`);
 
+  // Auto-include base-layer techs (e.g. php is pulled in by symfony/laravel — audit DA-PM-03).
+  // Computed into a local list so the user's selection (cli.config.technologies) stays untouched.
+  const baseLayers = getBaseLayerTechsFor(cli.config.technologies);
+  const installTechs = [...new Set([...cli.config.technologies, ...baseLayers])];
+  if (baseLayers.length > 0) {
+    console.log(`  ${c.cyan}Base layer:${c.reset} auto-including ${baseLayers.join(', ')} (PHP framework selected)`);
+  }
+
   const scriptsDir = path.join(CLI_ROOT, 'Dev', 'scripts');
   const langArg = `--lang=${cli.config.language}`;
-  const hasDocker = cli.config.technologies.includes('docker');
+  const hasDocker = installTechs.includes('docker');
   const includeInfra = cli.config.includeInfra || hasDocker;
-  const techsWithoutDocker = cli.config.technologies.filter((t) => t !== 'docker');
+  const techsWithoutDocker = installTechs.filter((t) => t !== 'docker');
   // 1 base step (common rules) + installable tech scripts + optional infra + optional project + optional rtk
   const totalSteps =
     1 +
@@ -265,9 +274,9 @@ export async function runInstallation(cli, { CLI_ROOT }) {
     console.log(`${c.cyan}[1/${totalSteps}]${c.reset} Installing common rules...`);
     runScript(path.join(scriptsDir, 'install-common-rules.sh'), [langArg, cli.config.targetPath], CLI_ROOT);
 
-    // Install technology-specific rules
+    // Install technology-specific rules (incl. auto-included base layers)
     let step = 2;
-    for (const tech of cli.config.technologies) {
+    for (const tech of installTechs) {
       if (tech === 'docker') continue; // Handled by infra
       const scriptName = `install-${tech}-rules.sh`;
       const scriptPath = path.join(scriptsDir, scriptName);

package/cli/lib/tech-registry.js

@@ -113,6 +113,10 @@ const TECH_REGISTRY = {
     installScript: 'install-php-rules.sh',
     version: '8.5',
     tier: 2,
+    // Base layer: not offered standalone in the menu; auto-included when a PHP
+    // framework (Symfony/Laravel) is selected. Avoids triple PHP coverage (audit DA-PM-03).
+    baseLayer: true,
+    baseLayerFor: ['symfony', 'laravel'],
   },
   python: {
     name: 'python',
@@ -146,8 +150,10 @@ const TECH_REGISTRY = {
   },
 };
 
-/** All tech keys (excluding docker which is infra) */
-const INSTALLABLE_TECHS = Object.keys(TECH_REGISTRY).filter((k) => k !== 'docker' && k !== 'coolify');
+/** Standalone-selectable tech keys (excludes infra and base-layer techs like php). */
+const INSTALLABLE_TECHS = Object.keys(TECH_REGISTRY).filter(
+  (k) => k !== 'docker' && k !== 'coolify' && !TECH_REGISTRY[k].baseLayer
+);
 
 /** Get display name for a tech key */
 function getDisplayName(tech) {
@@ -166,4 +172,19 @@ function getTechsByTier(tier) {
     .map(([key]) => key);
 }
 
-export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys, getTechsByTier };
+/**
+ * Base-layer techs that must be auto-included given a list of selected techs.
+ * E.g. selecting `symfony` or `laravel` pulls in `php`.
+ * @param {string[]} selectedTechs
+ * @returns {string[]} base-layer tech keys to add (not already in selectedTechs)
+ */
+function getBaseLayerTechsFor(selectedTechs) {
+  const selected = new Set(selectedTechs);
+  return Object.entries(TECH_REGISTRY)
+    .filter(
+      ([key, entry]) => entry.baseLayer && !selected.has(key) && (entry.baseLayerFor || []).some((t) => selected.has(t))
+    )
+    .map(([key]) => key);
+}
+
+export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys, getTechsByTier, getBaseLayerTechsFor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-bearded-bear/claude-craft",
-  "version": "8.7.1-next.c01d0bb",
+  "version": "8.7.1-next.cd47b2d",
   "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
   "type": "module",
   "main": "cli/index.js",
@@ -70,6 +70,8 @@
     "@commitlint/cli": "20.0.0",
     "@commitlint/config-conventional": "20.0.0",
     "@eslint/js": "^10.0.0",
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
     "@sveltejs/vite-plugin-svelte": "^5.1.1",
     "@vitest/coverage-v8": "4.0.0",
     "cytoscape": "^3.33.2",
@@ -93,12 +95,12 @@
     "Tools/"
   ],
   "dependencies": {
-    "@hono/node-server": "^1.19.14",
-    "chokidar": "^4.0.3",
+    "@hono/node-server": "^2.0.4",
+    "chokidar": "^5.0.0",
     "gray-matter": "^4.0.3",
     "hono": "^4.12.14",
     "js-yaml": "^4.1.1",
-    "marked": "^14.1.4",
-    "zod": "^3.25.76"
+    "marked": "^18.0.4",
+    "zod": "^4.4.3"
   }
 }