# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [8.2.5] - 2026-04-23

### Security

Multi-agent security audit performed on 2026-04-23 identified 2 CRITICAL, 6 HIGH, 7 MEDIUM, 4 LOW findings. This release fixes all CRITICAL and 5 of 6 HIGH findings. Full report: `docs/security/audit-2026-04-23.md`.

**CRITICAL fixes:**
- **Shell injection via `eval` (CWE-78, `Dev/scripts/pack-repo-fallback.sh:58`)** — Replaced `eval "find ... $FIND_EXCLUDES"` with a `find` argv array. A crafted `--exclude` argument could previously achieve full local code execution.
- **Command injection via string interpolation (CWE-78, `cli/lib/update.js:64,88`)** — Switched `execSync(\`bash "${script}" --lang="${lang}" --force "${targetPath}"\`)` to `spawnSync('bash', [script, \`--lang=${lang}\`, '--force', safeTarget])`. Added `--lang` allowlist (`/^[a-z]{2}$/`) and target-path validation rejecting system directories (`/`, `/etc`, `/usr`, `/bin`, `/sbin`, `/boot`, `/lib`, `/var`, `/root`, `/proc`, `/sys`, `/dev`).

**HIGH fixes:**
- **Path traversal / arbitrary write (CWE-22, `pack-repo-fallback.sh`)** — Added validation on `--output` (relative path, no `..`, no shell metacharacters), `--exclude` and `--include` (no shell metacharacters). Added `timeout 5` on `grep -E` against ReDoS via user-supplied regex.
- **Path traversal to system directories (CWE-22, `cli/lib/update.js`)** — Addressed by the `assertSafeTarget` guard added for the CRITICAL fix.
- **Hook command injection (CWE-78, `.claude/settings.json` + `settings.local.json.example`)** — Rewrote all 7 hooks from `echo '$TOOL_INPUT' | jq -r '.command // empty'` to `jq -r '.tool_input.command // empty'` (reads hook-input JSON from stdin instead of interpolating a shell variable). This eliminates the CVE-2025-59536 injection class entirely.
- **GitHub Actions supply chain (CWE-494, `.github/workflows/cla.yml`)** — SHA-pinned `contributor-assistant/github-action` to `ca4a40a7d1004f18d9960b404b97e5f30a505a08` (v2.6.1). Removed `actions: write` permission (not needed for a CLA bot).

**Dependencies:** `npm audit --omit=dev` → 0 vulnerabilities. All production deps (`hono@4.12.14`, `@hono/node-server@1.19.14`, `dompurify@3.4.0`, `marked@14.1.4`, `js-yaml@4.1.1`) are patched against recent CVEs (CVE-2026-29045, CVE-2026-29085, CVE-2026-29087, CVE-2026-0540, CVE-2025-15599). 6 vulnerabilities remain in devDependencies (eslint/vitest transitives: flatted, minimatch, picomatch, rollup, ajv, brace-expansion) — not shipped to users; fixable with `npm audit fix`.

**Tests:** update.test mocks migrated from `execSync` to `spawnSync`. Added 2 new security tests (invalid `--lang` rejection, system-directory target rejection). 787 tests pass total (up from 785).

### Out-of-scope / deferred (tracked in audit report)
- 7 MEDIUM findings (CLI hardening: `tryExec`, `openBrowser` URL allowlist, `ralph.js` argument passing, `--output` validation in `parse-args.js`, `$BINARY_EXTS` quoting, `post-tool-filter.sh` integrity, RTK `RTK_SKIP_CHECKSUM` bypass).
- 4 LOW findings (minor defensive hardening, dependabot coverage extension).

## [8.2.4] - 2026-04-23

### Changed — Documentation and training sync

Comprehensive documentation and training refresh to align with the current Claude ecosystem (Claude Code 2.1.117, Opus 4.7, Sonnet 4.6 default). Covers every documentation file that was lagging on prior model/version references.

**Settings (`.claude/`):**
- `settings.json` and `settings.local.json.example` — `CLAUDE_CODE_SUBAGENT_MODEL` updated from `claude-sonnet-4-5` to `claude-sonnet-4-6`.
- `.claude/references/laravel/laravel13-features.md` — Prism AI SDK examples updated from `claude-sonnet-4.5` to `claude-sonnet-4-6` (and to the hyphenated model ID convention).

**Training (`docs/training/claude-code/` and `docs/training/claude-craft/`):**
- All PLAN-FORMATION, PROPOSITION-COMMERCIALE, README, CAHIER-PARTICIPANT, GUIDE-FORMATEUR files updated: Claude Code 2.1.105 → 2.1.117, Claude-Craft 7.26.0 → 8.2.3.
- Model references updated: `Sonnet 4.5` → `Sonnet 4.6` (default), `Opus 4.6 flagship` → `Opus 4.7 flagship` (new), `Opus 4.6` kept as Fast Mode model.
- Cheatsheets (essentiel, avance, claude-code, claude-craft, symfony-commands, bmad-ralph) — model tables, pricing tables, command tables refreshed; new commands `/ultrareview`, `/tui`, `/recap`, `/undo`, `/effort` slider documented; `xhigh` effort level added.
- Training modules (Jour 1-2) — introductions, workshops, exercises, quiz questions updated to reflect current models and features.
- Metadata YAML files (`*.yaml` in `metadata/`) — titles and subtitles synchronized.

**Reference docs (`docs/`):**
- `docs/CLI-REFERENCE.md` — added `/ultrareview` (v2.1.111), `/tui` (v2.1.110), `/recap` (v2.1.108), `/undo` (v2.1.108), `/effort` slider (v2.1.111), Native CLI binary (v2.1.113), `CLAUDE_CODE_FORK_SUBAGENT=1` (v2.1.117), `ENABLE_PROMPT_CACHING_1H`/`FORCE_PROMPT_CACHING_5M` (v2.1.108) env vars.

**Project root:**
- `README.md` — "What's New in v8.0" section replaced by "What's New in v8.2" highlighting the Opus 4.7 / Claude Code 2.1.117 ecosystem and the v8.2.1-v8.2.3 release cycle.

### Preserved — Historical references unchanged

- `docs/audit/` and `docs/marketing/` — historical snapshots kept as-is.
- `CHANGELOG.md` prior entries (v5.5.0, v8.0.0, etc.) — not touched.
- Historical `Nouveautés v2.1.32` sections describing Opus 4.6 as new flagship at the time — kept as historical record.
- Fast Mode references — remain on Opus 4.6 across all documentation (Fast Mode is unavailable on Opus 4.7).

## [8.2.3] - 2026-04-22

### Fixed — CI workflows repaired

**Deploy Documentation (`.github/workflows/docs.yml`):**
- Fixed Playwright E2E strict mode violation in `website/tests/e2e/landing.spec.ts:45` — `a[href*="getting-started/quickstart"]` locator now uses `.first()` to disambiguate between navigation and main content matches (both point to the same href with identical text).

**Generate SBOM (`.github/workflows/sbom.yml`):**
- Replaced deprecated GitHub Action `CycloneDX/gh-node-module-generatebom` (unresolvable SHA, last release 2023) with the official `@cyclonedx/cyclonedx-npm` CLI. Output format and artifact name unchanged.

**SLSA Provenance (`.github/workflows/slsa-provenance.yml`) — REMOVED:**
- Upgrading `slsa-framework/slsa-github-generator` to v2.1.0 and setting `private-repository: false` did not resolve an upstream bug where the generator's repo-privacy detection incorrectly classified this public repo as private despite the GitHub API returning `"private": false`.
- Removed the standalone SLSA Provenance workflow entirely. NPM packages continue to receive SLSA Build L3 provenance via `npm publish --provenance` in `.github/workflows/npm-publish.yml`, which uses npm's native Sigstore/OIDC integration. The removed workflow was generating redundant attestations for a local `npm pack` tarball that no downstream consumer was using.

These 3 workflows had been failing on every commit since at least 2026-04-15. The NPM publish workflow (with `--provenance` flag) was unaffected and continues to sign releases via npm's native OIDC integration.

## [8.2.2] - 2026-04-22

### Changed — Opus 4.7 as Default Model

- **Default Opus references** updated from Opus 4.6 to **Opus 4.7** (released 2026-04-16, model ID `claude-opus-4-7`). Affects `/model opus` recommendation, agent leaders (product-owner, tech-lead), training materials, and StatusLine example.
- **Recommended Claude Code version** 2.1.107 → **2.1.117** in `.claude/CLAUDE.md`, `.claude/COMPATIBILITY.md`, and `docs/AGENT-TEAMS-GUIDE.md`. Minimum stays `2.1.47`.

### Added — COMPATIBILITY.md Enrichment

- **Claude Opus 4.7 Support** section — model ID, 1M context GA, `xhigh` effort level, new tokenizer (1.0–1.35x tokens), adaptive thinking only, sampling params removed, image resolution 2576px, Fast Mode unavailable.
- **Claude Code v2.1.108–v2.1.117** entries — prompt caching env vars, `/tui`, `/recap`, `/undo`, `/effort` slider, `/ultrareview`, `/less-permission-prompts`, `/btw`, `/hooks`, `/reload-plugins`, `/proactive`, native CLI binary, forked subagents (`CLAUDE_CODE_FORK_SUBAGENT=1`), embedded `bfs`/`ugrep`, security fixes.

### Preserved — Fast Mode remains on Opus 4.6

Fast Mode (`/fast`) is **not available on Opus 4.7**. All Fast Mode references (COMPATIBILITY.md Fast Mode section, AGENT-TEAMS-GUIDE cost tables, training docs, `.claude/commands/team/*`) continue to reference Opus 4.6.

## [8.2.1] - 2026-04-22

### Changed — Node.js 22 LTS Migration

**CI Workflows (eliminates GitHub Actions deprecation warnings):**
- `.github/workflows/mutation.yml` — `node-version: '20'` → `'22'`
- `.github/workflows/docs.yml` — `node-version: 20` → `22` (build + e2e test jobs)

**Documentation Examples (33 files updated):**
- CI examples: `node-version: '20'` → `'22'` in React, Angular, Vue.js references and commands (all i18n variants: de, en, es, fr, pt)
- Docker examples: `FROM node:20-alpine` → `node:22-alpine` in React tooling and Infra Docker commands (all i18n variants)

**Context:** Node.js 20 reaches EOL on 2026-04-30. Migration to Node.js 22 LTS (EOL 2027-04) eliminates deprecation warnings in GitHub Actions and aligns documentation examples with current best practices.

**Preserved (backward compatibility):**
- `package.json` engines field kept at `>=20.0.0` to not break existing installations
- Documentation prerequisites continue to list "Node.js 20+" as minimum requirement

## [8.2.0] - 2026-04-17

### Added — Audit Phase Actions (5 phases implemented)

**New Agents (4):** `@chaos-engineer`, `@devex-engineer`, `@mlops-engineer`, `@observability-engineer`.

**New Skills (7):** `api-gateway`, `edge-computing`, `event-driven`, `graphql`, `monorepo`, `observability`, `wasm`.

**New Commands:** `/common:search` (fuzzy search across skills/commands/agents), `/common:aliases` (CLI aliases), `/common:getting-started` (interactive guided tour).

**Shell Completions:** Bash, Zsh, Fish completions for `claude-craft` CLI.

**Documentation:**
- Shell completions README (`completions/README.md`)
- Cheat sheet (`docs/CHEAT-SHEET.md`) and learning paths (`docs/LEARNING-PATHS.md`)
- ISO 27001 gap analysis and SOC 2 gap analysis (`docs/compliance/`)
- Enterprise features and pricing (`docs/enterprise/`)
- MCP servers guide (`docs/mcp/MCP-SERVERS.md`)
- Autonomous sprint guide (`docs/guides/AUTONOMOUS-SPRINT.md`)
- RFC-001 QA Recette Standalone (`docs/rfc/`)
- Eval framework for research (`docs/research/EVAL-FRAMEWORK.md`)

**New Technology:** Paperclip reviewer agent added.

### Changed

- **Rules → Skills refactoring:** Moved detailed content from 6 rules into dedicated skills (async, cqrs, multitenant, workflow-analysis, git-workflow, documentation). Rules now contain concise quick references (~2.5K tokens) instead of full content (~20K tokens). Significant context window savings.
- **Makefile slimmed** (~70% LOC reduction) — extracted infra targets to `Infra/Makefile`.
- **INDEX.md** refactored for conciseness.
- GitHub issue templates expanded (i18n, ADR, test types).
- CI workflows added (e2e-tools, i18n-parity, mutation, sbom, slsa-provenance).

### Fixed

- Settings.json schema, spinnerVerbs and hooks corrected.

### Removed

- Internal audit documents removed from version control (added to `.gitignore`).

## [8.1.0] - 2026-04-15

### Added — `claude-craft kanban` (Kanban UI locale pour BMAD v6)

Nouvelle commande CLI qui lance un serveur local (bind `127.0.0.1` exclusivement) et une UI web pour visualiser et piloter le répertoire `project-management/` généré par BMAD v6.

**Usage :**

```bash
npx @the-bearded-bear/claude-craft kanban [chemin] [--port=3737] [--open] [--readonly] [--no-watch]
```

**Vues :**

- **Kanban** — 6 colonnes (backlog, ready-for-dev, in-progress, review, done, blocked), drag-and-drop avec validation serveur des transitions (state machine + gates INVEST / tasks-complete / DoD).
- **Backlog tree** — arbre Epic → Stories avec progression par epic.
- **Burndown** — courbes ideal vs actual du sprint actif (uPlot), badge on-track / at-risk / behind.
- **Dependencies graph** — graphe orienté (Cytoscape + Dagre) avec détection de cycles.
- **Docs viewer** — PRD, tech-spec, personas, architecture/* rendus en markdown (marked + DOMPurify). Liens internes `[US-XXX]` cliquables vers la carte Kanban.

**Backend :**

- Serveur Hono + `@hono/node-server`, API REST + endpoint SSE `/api/events` pour la propagation des mises à jour.
- Watcher chokidar (debounce 200 ms) qui détecte les éditions externes et pousse aux clients.
- Cache sprint-status.yaml regénéré au boot (fichiers `.md` = source of truth).
- Écriture atomique du frontmatter : lock exclusif + backup `.bak` + rollback + contrôle `mtime` ETag-like.

**Sécurité :**

- Bind 127.0.0.1 uniquement, aucune exposition LAN.
- CSRF same-origin (Origin/Referer) sur chaque PATCH → 403 cross-origin.
- Path traversal bloqué sur l'endpoint docs.
- CSP stricte (`script-src 'self'`, `connect-src 'self'`).
- Mode `--readonly` qui bloque toutes les mutations.

**Bundle client :**

- Main : 52 KB (19.6 KB gzip) — chargé toujours.
- Vues lourdes (Burndown uPlot, Docs marked+DOMPurify, Deps Cytoscape) en **code-splitting dynamique** : téléchargées seulement à la visite de leur route.

**Tests :** 154 tests unitaires + intégration (schémas Zod, state machine, file-scanner, frontmatter, file-writer atomique, routes API, CSRF, file-watcher, sprint cache, burndown, E2E server boot).

**Nouvelles dépendances :** `hono`, `@hono/node-server`, `gray-matter`, `js-yaml`, `chokidar`, `zod`, `marked`, `dompurify`, `cytoscape`, `cytoscape-dagre`, `uplot` (prod) ; `svelte@^5.37`, `vite@^6`, `@sveltejs/vite-plugin-svelte@^5` (dev).

**Documentation :** section "Kanban Command" ajoutée à `docs/CLI-REFERENCE.md` et ses 4 traductions (fr, es, de, pt).

---

## [8.0.1] - 2026-04-15

### Documentation sync (post-release v8.0.0)

Mise à jour exhaustive de la documentation, formations et pages web pour refléter l'état réel du framework après le cycle v7.31 → v8.0.0. **38 fichiers mis à jour.**

#### Compteurs synchronisés (partout)

- 63 agents → **67 agents** (16 Common + 10 Tech Reviewers + 41 Infra)
- 37 Skills → **41 Skills**
- 204 commands → **214 commands**
- 26 namespaces → **27 namespaces**
- 18 stacks → **19 stacks** (+ Paperclip)

#### Versions hardcoded → v8.0.0

- `README.md` : section "What's New" entièrement réécrite pour v8.0
- `website/.vitepress/theme/LandingPage.vue` : 5 locales (EN, FR, ES, DE, PT) hero_badge + FeatureCards
- `docs/index.html` : 6 hero_badges + 3 div badges
- `.claude/context-essentials.md`, `.claude/SKILLS-SPEC.md`, `.claude/commands/common/audit-freshness.md`

#### Nouveau contenu documenté

- `docs/AGENTS.md` : Common Agents (12) → (16), entrées complètes pour `@security-auditor`, `@data-analyst`, `@migration-specialist`, `@cost-optimizer`
- `docs/AGENTS-FULL-REFERENCE.md` : section Common (16) avec model/effort/tools/exemples pour les 4 nouveaux agents
- `docs/COMMANDS.md` : entrées détaillées pour `/common:pack-repo` (Codebase Packing) et `/uiux:generate-design-md` (UI/UX Commands)

#### Guides i18n synchronisés (5 langues)

- `docs/guides/{en,fr,es,de,pt}/01-getting-started.md`
- `docs/guides/{fr,es,pt}/02-project-creation.md`
- `docs/guides/fr/{03-feature-development,07-backlog-management,08-setup-new-project,10-complete-workflow}.md`
- `docs/i18n/fr/QUICKSTART.md`
- `website/{en,fr,es,de,pt}/guides/*.md` (compteurs et version)

### Notes

- Aucun changement de comportement, aucune nouvelle feature
- Validation `Dev/scripts/validate-skills-spec.sh` continue de passer (41/41 conformes)
- CHANGELOG historique préservé (feature markers `v7.28.0+` non touchés)

## [8.0.0] - 2026-04-15

### 🚨 BREAKING CHANGES

**Alignement strict sur la [spec officielle Anthropic Agent Skills](https://github.com/anthropics/skills/blob/main/spec/agent-skills-spec.md).**

Guide de migration complet : [docs/MIGRATION-v7-to-v8.md](docs/MIGRATION-v7-to-v8.md).

#### Changements bloquants

- **Fusion `remotion-best-practices` → `remotion`**
  - Le symlink `.claude/skills/remotion-best-practices` (pointant vers `.agents/`, gitignored) a été supprimé
  - Contenu consolidé dans `.claude/skills/remotion/`
  - Frontmatter normalisé (retrait de `metadata:`, ajout de `triggers:` + `auto_suggest:`)
  - **Action utilisateur :** remplacer les références `remotion-best-practices` par `remotion`

- **Validation CI obligatoire**
  - Nouveau script `Dev/scripts/validate-skills-spec.sh`
  - Vérifie 5 règles : structure dossier, frontmatter YAML, match name/dir, naming kebab-case, pas de chemins absolus
  - Script pre-commit / CI GitHub Actions recommandé (voir MIGRATION guide)

#### Conformité atteinte

- 41/41 skills passent le validator (100% conforme)
- Frontmatter minimal `name` + `description` normalisé sur tous les skills
- Interopérabilité garantie avec marketplace Anthropic et superpowers-marketplace

### Added

- `docs/MIGRATION-v7-to-v8.md` — guide complet de migration
- `Dev/scripts/validate-skills-spec.sh` — script de validation CI (exit 1 si non-conforme)

### Changed

- `.claude/skills/remotion/SKILL.md` — frontmatter conforme spec (name: remotion + triggers + auto_suggest)

### Removed

- `.claude/skills/remotion-best-practices` (symlink obsolète)
- Champ `metadata:` dans frontmatter remotion (non spec)

### Récapitulatif — Mission accomplie

Claude Craft v8.0.0 clôture l'intégration des 12 ressources LinkedIn Claude Code identifiées en début de cycle :

| # | Ressource | Status | Version |
|---|-----------|--------|---------|
| 1 | Everything Claude Code | ✅ Équivalent framework | Base |
| 2 | claude-code-best-practices | ✅ Rules + skills | Base |
| 3 | Superpowers | ✅ 3 skills | v7.32 |
| 4 | claude-mem | ✅ Memory lifecycle | v7.35 |
| 5 | Karpathy Guidelines | ✅ Rule 23 | v7.31 |
| 6 | Awesome Claude Code | ✅ Veille continue | Base |
| 7 | Repomix | ✅ /common:pack-repo | v7.33 |
| 8 | Get Shit Done (GSD) | ✅ atomic-tasks | v7.31 |
| 9 | Prompt Engineering Guide | ✅ Docs (rule 12) | Base |
| 10 | Agent Skills Anthropic | ✅ Spec conforme 100% | v8.0.0 |
| 11 | Awesome Subagents | ✅ 4 agents ajoutés | v7.34 |
| 12 | Awesome DESIGN.md | ✅ Skill + template + cmd | v7.31 + v7.34 |

## [7.35.0] - 2026-04-15

### Added — Phase 5 : Memory lifecycle hooks (claude-mem inspired)

- **Template hook `memory-lifecycle.json`** (`.claude/templates/hooks/memory-lifecycle.json`)
  - 5 hooks (SessionStart, UserPromptSubmit, PostToolUse, PreCompact, SessionEnd)
  - Storage SQLite local dans `.claude/memory.db` (gitignored)
  - 100% local, zéro télémétrie, zéro network
  - Inspiré de [thedotmack/claude-mem](https://github.com/thedotmack/claude-mem) (49.6k stars)

- **Scripts lifecycle** (`Dev/scripts/memory-lifecycle/`)
  - `_db.sh` — helpers SQLite (init schema, sessions, prompts, tool_events, compactions)
  - `session-start.sh` — ouvre session + rappelle résumé session précédente
  - `prompt-submit.sh` — log previews des prompts (200 chars max)
  - `post-tool.sh` — log Edit/Write/Bash events (path + summary 300 chars)
  - `pre-compact.sh` — préserve context essentials + recent events, re-injection
  - `session-end.sh` — computer résumé session (prompts/tools/top files)
  - `README.md` — guide d'installation + usage + queries SQL

### Changed

- `.gitignore` — ajout `.claude/memory.db`, `.claude/memory.db-*`, `.claude/scheduled_tasks.lock`

### Récapitulatif des 5 phases (v7.31 → v7.35)

| Version | Phase | Apport |
|---------|-------|--------|
| v7.31.0 | Phase 1 | Karpathy principles + GSD atomic-tasks + DESIGN.md convention |
| v7.32.0 | Phase 2 | Skills Superpowers (architect, debug-methodical, socratic-brainstorm) |
| v7.33.0 | Phase 3 | Command `/common:pack-repo` (Repomix wrapper + fallback shell) |
| v7.34.0 | Phase 4 | Audit spec + 4 agents + `/uiux:generate-design-md` |
| v7.35.0 | Phase 5 | Memory lifecycle hooks (claude-mem inspired, 100% local) |

Prochaine étape majeure : **v8.0.0** — refonte complète alignement spec officielle Agent Skills Anthropic (breaking change).

## [7.34.0] - 2026-04-15

### Added — Phase 4 : Spec alignment audit + subagents + generate-design-md

- **`.claude/SKILLS-SPEC.md`** — Audit de conformité des 42 skills vs spec officielle Anthropic
  - 40/42 skills conformes à la spec
  - 2 écarts mineurs identifiés (`remotion`, `remotion-best-practices`)
  - Plan de migration stricte prévu en v8.0.0 (breaking)
  - Tests de conformité CI documentés

- **4 nouveaux agents** (`.claude/agents/`)
  - `@security-auditor` — OWASP Top 10:2025, SAST, SBOM, supply chain (model: sonnet)
  - `@data-analyst` — SQL, metrics design, BI, observability (model: sonnet)
  - `@migration-specialist` — zero-downtime, expand-contract, framework upgrades (model: sonnet)
  - `@cost-optimizer` — FinOps, LLM cost reduction, prompt caching (model: haiku)

- **Command `/uiux:generate-design-md`** (`.claude/commands/uiux/generate-design-md.md`)
  - Génère DESIGN.md à la racine depuis template
  - Options `--from-tailwind`, `--from-tokens`, `--interactive`
  - Auto-détection des sources UI (Tailwind, W3C tokens, SCSS)

### Changed

- `.claude/CLAUDE.md` : 16 agents Common (au lieu de 12), version 7.34.0

## [7.33.0] - 2026-04-15

### Added — Phase 3 : Repomix integration

- **Command `/common:pack-repo`** (`.claude/commands/common/pack-repo.md`)
  - Pack la codebase en un seul fichier AI-friendly (XML, Markdown, Plain, JSON)
  - Wrapper [Repomix](https://github.com/yamadashy/repomix) (npm) par défaut
  - Token counting (encoding o200k_base)
  - Options : `--format`, `--output`, `--compress`, `--include`, `--exclude`, `--mcp`, `--fallback`
  - Intégration `/workflow:init`, `/common:setup-project-context`, `/team:audit`

- **Script fallback shell** (`Dev/scripts/pack-repo-fallback.sh`)
  - Bash autonome, zéro dépendance npm
  - Respect automatique de `.gitignore` (via `git ls-files`)
  - Exclusion binaires + caches (node_modules, vendor, dist, __pycache__, etc.)
  - Skip fichiers > 500KB (générés/volumineux)
  - Estimation tokens (4 chars ≈ 1 token, avertissement si > 200k)
  - Fallback automatique si `repomix` et `npx` absents

## [7.32.0] - 2026-04-15

### Added — Phase 2 : Skills Superpowers

- **Skill `architect`** (`.claude/skills/architect/SKILL.md`)
  - Phase d'architecture systématique avant TDD (5 étapes : boundaries → contrats → dépendances → trade-offs → tests d'archi)
  - Livrables : diagramme, contrats, ADR court, tests d'architecture, découpage atomique
  - Source : [obra/superpowers](https://github.com/obra/superpowers)

- **Skill `debug-methodical`** (`.claude/skills/debug-methodical/SKILL.md`)
  - Debugging en 4 phases strictes (reproduce → isolate → fix → verify)
  - Techniques bisect, binary search, 5 Whys, flaky detection
  - Test de régression obligatoire (règle d'or QA)
  - Source : [obra/superpowers](https://github.com/obra/superpowers)

- **Skill `socratic-brainstorm`** (`.claude/skills/socratic-brainstorm/SKILL.md`)
  - 5 familles de questions (problème, contraintes, alternatives, hypothèses, conséquences)
  - Variante rapide 5 Whys pour causes racines
  - Source : [obra/superpowers](https://github.com/obra/superpowers)

### Changed

- `.claude/commands/workflow/analyze.md` : skills recommandés `socratic-brainstorm` + `atomic-tasks`
- `.claude/commands/workflow/design.md` : skills recommandés `architect` + `atomic-tasks`
- `.claude/commands/qa/tdd.md` : skills recommandés `debug-methodical` + `atomic-tasks`
- `.claude/CLAUDE.md` : skills list mise à jour (13 skills exposés au total)

## [7.31.0] - 2026-04-15

### Added — Phase 1 : Enrichissement issu de l'analyse des 12 ressources LinkedIn Claude Code

- **Rule 23 — Karpathy Principles** (`.claude/rules/23-karpathy-principles.md`)
  - 3 principes AI-first : state assumptions explicitly, minimal code (no speculation), surface confusion
  - Workflow Karpathy 80% agent-driven coding
  - Anti-bloat checklist
  - Source : [forrestchang/andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills)

- **Skill `atomic-tasks`** (`.claude/skills/atomic-tasks/SKILL.md`)
  - Pattern GSD (Get Shit Done) : split → small plans → fresh subagent contexts → atomic commits → verify goals
  - Combat le context rot (dégradation au-delà de 50% de contexte)
  - Source : [gsd-build/get-shit-done](https://github.com/gsd-build/get-shit-done)

- **Skill `design-md-convention`** (`.claude/skills/design-md-convention/SKILL.md`)
  - Convention DESIGN.md pour design systems AI-friendly (7 sections obligatoires)
  - Template associé : `.claude/templates/DESIGN.md.template`
  - Source : [VoltAgent/awesome-design-md](https://github.com/VoltAgent/awesome-design-md)

### Changed

- `.claude/CLAUDE.md` : références aux nouveaux skills + section AI-First (Karpathy) + Design System Convention
- `.claude/rules/05-kiss-dry-yagni.md` : extension AI-Era avec cross-ref vers rule 23
- `.claude/rules/01-workflow-analysis.md` : intégration pattern GSD atomic tasks

### Roadmap

Phases 2-5 à venir (v7.32 à v8.0.0) :
- **v7.32.0** : Skills Superpowers (architect, debug-methodical, socratic-brainstorm)
- **v7.33.0** : Command `/common:pack-repo` (Repomix wrapper + fallback shell)
- **v7.34.0** : Audit subagents + `/uiux:generate-design-md`
- **v7.35.0** : Hook lifecycle mémoire inspiré claude-mem
- **v8.0.0** : Alignement spec officielle Agent Skills (Anthropic) — **breaking change**

## [7.30.0] - 2026-04-15

### Added

- **Paperclip** AI-workforce orchestration stack (v2026.403.0+) as Tier 2 Supported technology across all 5 languages (en, fr, es, de, pt).
  - Install script `Dev/scripts/install-paperclip-rules.sh` (TCL-optimized)
  - 29 files per language: 7 rules, 8 commands, 6 skills, 3 checklists, 1 reviewer agent, 2 templates, CLAUDE.md.template, README.md
  - New slash-command namespace `/paperclip:*` (8 commands: check-compliance, check-architecture, check-code-quality, check-testing, check-security, generate-adapter, generate-agent-config, setup-company)
  - New agent `@paperclip-reviewer`
  - Makefile target `install-paperclip` + `install-all` loop updated
- Documentation updated across `README.md`, `docs/index.html` (Tech Stacks 18→19), `docs/COMMANDS.md`, `docs/TECHNOLOGIES.md`, `.claude/CLAUDE.md`

### Changed

- `.claude/CLAUDE.md` counts: 19 technology stacks (was 18), 212 commands (was 204), 27 namespaces (was 26)

## [7.29.0] - 2026-04-14

### Changed

- **Framework versions alignment (2026-04 freshness audit)** -- All 10 technology stacks and transverse rules updated to match April 2026 stable releases
  - **Symfony** : PHP 8.5 → PHP 8.4+ (corrected prerequisite; added JsonStreamer, JsonPath, ObjectMapper, Wizard Forms patterns)
  - **Angular** : 19.x → **20 LTS (or 21)** with zoneless by default, `httpResource`, Signal Forms, `afterNextRender`/`PendingTasks`
  - **React Native** : 0.76+ → **0.85** (New Architecture); Reanimated 3 → **4.x** mandatory; Bridge legacy removed, TurboModules, Shared Animation Backend
  - **PHP** : Pest 3 → **Pest 4.5** (browser testing), PHPStan Level 9 → **Level 10**, documented Property Hooks and Asymmetric Visibility (PHP 8.4)
  - **Laravel** : 12.x → **13.x** with AI SDK, Vector Search (pgvector/RAG), Passkey Authentication, Pest 3 Mutation Testing, Arch Presets
  - **Flutter** : 3.38/Dart 3.10 → **3.41/Dart 3.11** with Riverpod 3 Mutations API, BLoC v9, Impeller by default, `dart:js_interop`
  - **Python** : 3.13+ → **3.14+** with free-threading, JIT, PEP 649 deferred annotations, pytest-asyncio auto mode, Ruff 0.8
  - **React** : Documented **React Compiler 1.0** (auto-memoization), Server Components, `use()` Hook, `useOptimistic`

### Added

- **Security -- OWASP Top 10:2025** -- New categories (Software Supply Chain Failures, Mishandling of Exceptional Conditions), SSRF consolidated into Broken Access Control
- **Supply chain security** -- SLSA 1.0, SBOM (SPDX 3/CycloneDX), Sigstore keyless signing, reproducible builds
- **Modern auth/crypto patterns** -- EdDSA (Ed25519) preferred for JWT, DPoP (RFC 9449), Argon2id with OWASP 2026 params (128 MiB RAM, t=3-5, p=1), HTTP-only cookies
- **Cross-origin security headers** -- COOP, COEP, CORP, Permissions-Policy, CSP Level 3
- **Testing transverse 2026** -- Vitest 4 Browser Mode, Playwright component testing, Pest 4 browser testing, mutation testing (Stryker/Infection/Mutmut), property-based testing (fast-check, Hypothesis)
- **Docker/K8s 2026** -- Compose Spec v5 "Mont Blanc" (dropped `version:` field), BuildKit cache/secret mounts, distroless/Chainguard images, Kubernetes 1.35, Gateway API v1.4+, sidecar-less architectures (Istio Ambient, Cilium)
- **OpenAPI 3.0 → 3.2** -- JSON Schema 2020-12, tag metadata, streaming (SSE/JSON Lines), OAuth 2.0 device flow
- **Architecture principles 2026** -- Cognitive Complexity (< 7-10) as primary metric, Vertical Slice Architecture, Modular Monolith as pragmatic alternatives
- **ADR tooling** -- Log4brains (CLI + web + diagrams), adr-log (policy enforcement), ADR Manager VS Code, AI generators
- **Multitenant tiered approach** -- Tier 1 shared schema, Tier 2 dedicated schema, Tier 3 dedicated DB; RBAC/ABAC per tenant; field-level encryption
- **CQRS** -- "When NOT to use CQRS" section with trade-offs
- **Async patterns** -- Competing Consumers (Symfony Messenger), Lifecycle Tracking (Laravel), Ecotone framework-agnostic abstraction
- **Infrastructure versions pinned** -- FrankenPHP 1.12.1 (Worker Mode, HTTP/3), PgBouncer 1.25.1 (prepared statements), OpenTofu 1.11.6, Ansible-core 2.20.4, Coolify v4.0.0-beta.470
- **Hetzner Cloud migration** -- `datacenter` → `location` across all 30 Hcloud docs (5 languages) with mandatory-migration warning before 2026-07-01

### Fixed

- **Docker Compose** -- Removed obsolete `version: '3.8'` in `.claude/references/symfony/docker.md`
- **Hadolint** -- Pinned to `hadolint/hadolint:v2.12.0` instead of unpinned image

## [7.28.0] - 2026-04-14

### Added

- **Claude Code v2.1.106 compatibility** -- Internal improvements and bug fixes
- **Claude Code v2.1.107 compatibility** -- Show thinking hints sooner during long operations
- **Enhanced `/doctor` layout documentation** -- Status icons, categorized output, action hints (v2.1.105+)
- **New commands documentation** -- `/btw`, `/hooks`, `/reload-plugins`, `/proactive` in CLI reference, FAQ, and context management rules
- **PreCompact blocking documentation** -- Exit code 2 support fully documented in HOOKS.md
- **Stalled stream handling** -- 5-minute auto-retry documentation in TROUBLESHOOTING.md
- **WebFetch token optimization** -- Strips `<style>`/`<script>` contents documentation (50-80% token reduction)
- **New environment variables** -- `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD`, `MAX_THINKING_TOKENS`, `SLASH_COMMAND_TOOL_CHAR_BUDGET`, OTEL tracing vars (beta)
- **Advanced skills documentation** -- `context: fork`, `disable-model-invocation: true`, `claudeMdExcludes`, auto-compaction skill reload (5K/skill, 25K total)

### Changed

- **Recommended Claude Code version** -- 2.1.105 → 2.1.107 (minimum stays 2.1.47)
- **Documentation URLs** -- Migrated all references from docs.anthropic.com to code.claude.com (14 files)
- **Context management rules** -- Added new commands, environment variables, and skills sections (all 5 languages)
- **Version references** -- 7.27.0 → 7.28.0 across all docs, guides, and configuration files

## [7.27.0] - 2026-04-14

### Added

- **PostCompact hook** -- Context reinjection after compaction via `context-essentials.md` (previously only at session restart)
- **`.claudeignore` template** -- Generated during install to exclude `node_modules/`, `website/`, `Dev/i18n/`, lock files (40-70% reduction in file search operations)
- **`install_config()` in install scripts** -- Installs `settings.json`, `settings.local.json`, `.claudeignore`, and `context-essentials.md` during project setup
- **Agent memory frontmatter** -- 18 agents now have `memory: user` (6 cross-project) or `memory: project` (12 tech reviewers) for cross-session knowledge persistence
- **`effort:` field on all 22 agents** -- `low` for Haiku auditors, `medium` for Sonnet reviewers, `high` for Opus orchestrators
- **RTK `--ultra-compact` mode** -- Patched automatically during install for +5-10% additional token savings
- **MultiAccount `sync` command** -- Synchronizes hooks and settings from `~/.claude` to isolated profiles (`claude-accounts sync`)
- **BATS tests in CI** -- Shell script tests (MultiAccount, RTK, StatusLine, AgentTeams) now run in GitHub Actions via Docker
- **i18n parity check in CI** -- `npm run lint:i18n` added to build pipeline
- **66 new tests** -- `install-config` (11), `agents-optimization` (19), `templates` (19), `project-settings` (17), plus BATS for RTK ultra-compact (3) and MultiAccount sync (5)
- **`test-bats` and `test-all` Makefile targets** -- Run all BATS tests or combined vitest + BATS

### Changed

- **`settings.local.json` consolidated** -- 49KB (480+ accumulated permissions) → ~1KB (wildcard patterns), 98% reduction per session
- **`CLAUDE_CODE_SUBAGENT_MODEL` enforced** -- Set to `claude-sonnet-4-5` in `settings.json` (was only documented, not applied)
- **`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` removed** -- No longer always-on; teams overhead eliminated when not using `/team:*`
- **`api-designer` and `database-architect` downgraded** -- `opus` → `sonnet`, `maxTurns: 8` → `6` (~5x cost reduction per invocation)
- **INDEX.md trimmed** -- 358 → 215 lines, removed redundant Claude Code changelog and duplicated skills list
- **4 rules files condensed** -- `04-solid-principles` (17KB→1KB), `05-kiss-dry-yagni` (14KB→1KB), `07-testing` (11KB→1.3KB), `11-security` (10KB→1.6KB); full content preserved in `references/base/`
- **`settings.json.template` updated** -- Now includes `env` block, `PostCompact` hook, `SessionStart(compact)`, output filters for Bash/Grep, security hooks for Edit/Write
- **`settings.local.json.template` updated** -- Consolidated wildcard permissions instead of empty file
- **CI pipeline** -- `publish` now requires both `build` AND `bats` jobs; i18n parity check added to build

### Fixed

- **RTK integrity hash** -- `install-rtk.sh` now updates `.rtk-hook.sha256` after patching `--ultra-compact`
- **Version references** -- 7.26.0 → 7.27.0 across all docs, guides, and configuration files

## [7.26.0] - 2026-04-14

### Added

- **RTK setup command** -- `/common:setup-rtk` configures all token optimizations in one step (RTK proxy, PostToolUse hooks, PreCompact hooks, sub-agent model)
- **PostToolUse output-filtering hooks** -- Grep and Glob large output notices (>50KB) to guide context-efficient summarization
- **Enriched context-essentials.md** -- Architecture rules, stack detection, common test commands, active workflow state, key index pointers

### Changed

- **CLAUDE.md trimmed** -- 221 → 173 lines (-22%): commands/agents/skills tables replaced with compact summaries
- **Rules files condensed** -- 4 largest rules reduced by 54% (2,510 → 1,152 lines), verbose examples moved to `references/base/`
- **5 agents downgraded Opus → Sonnet** -- devops-engineer, ui-designer, ux-ergonome, uiux-orchestrator, refactoring-specialist (cost reduction, no quality loss for their task profiles)
- **maxTurns added to all 22 agents** -- Reviewers: 6, Orchestrators: 10, Specialists: 8, Auditors: 4, Designers: 6 (prevents runaway sessions)
- **Token savings** -- estimated 55-65% reduction per session from combined optimizations

### Fixed

- **Version references** -- 7.25.0 → 7.26.0 across CLAUDE.md, context-essentials.md, docs, and training materials

## [7.25.0] - 2026-04-14

### Added

- **Claude Code v2.1.63-v2.1.105 compatibility** -- 43 new versions documented with 12 feature sections
- **Auto Mode documentation** -- AI-powered permission classifier for Team plans (v2.1.94+)
- **New slash commands** -- /loop, /effort, /context, /powerup, /proactive, /color, /rename, /team-onboarding
- **8 new hook events** -- PostCompact, StopFailure, TaskCreated, CwdChanged, FileChanged, PermissionDenied, Elicitation, ElicitationResult
- **Hook enhancements** -- conditional `if` field (v2.1.85), `defer` permission (v2.1.89), PreCompact blocking (v2.1.105)
- **MCP enhancements** -- Elicitation, Tool Search lazy loading (95% context reduction), result persistence (500K), OAuth RFC 9728
- **Agent frontmatter** -- effort, maxTurns, disallowedTools fields for custom agents (v2.1.78+)
- **Security advisories** -- 7 new CVE fixes documented (v2.1.97-v2.1.101), source code leak incident (v2.1.88)
- **Subprocess sandboxing** -- PID namespace isolation, CLAUDE_CODE_SUBPROCESS_ENV_SCRUB (v2.1.98+)
- **Managed settings** -- managed-settings.d/ drop-in directory for enterprise config (v2.1.83+)
- **Context management updates** -- /context suggestions, /effort levels, idle-return prompt, /loop scheduling, MCP Tool Search, --bare flag, Monitor tool

### Changed

- **Recommended Claude Code version** -- 2.1.62 → 2.1.105 (minimum stays 2.1.47)
- **Security minimum** -- 2.1.51 → 2.1.97 (critical Bash tool hardening)
- **SECURITY.md** -- supported versions updated to 7.25.x/7.24.x

## [7.24.0] - 2026-02-27

### Added

- **Claude Code v2.1.62 compatibility** — Prompt suggestion cache regression fix
- **CLAUDE.md authoring best practices** — pointers over code copies, emphasis for critical rules, file placement hierarchy in context management rule
- **Performance optimization guide** — CLI tools over MCPs, model switching mid-session, PreToolUse output filtering in context management rule
- **Communication patterns** — Interview pattern, CIF structure, Writer/Reviewer pattern in context management rule

### Changed

- **Recommended Claude Code version** — 2.1.61 → 2.1.62 (minimum stays 2.1.47)
- **CVE-2026-21852 severity** — "High" → 5.3/10 CVSS in MCP.md and security rule
- **Agent Teams Guide** — Added ~7x token cost warning, recommended version bumped to 2.1.62
- **SECURITY.md** — supported versions updated to 7.24.x/7.23.x

## [7.23.0] - 2026-02-27

### Added

- **Claude Code v2.1.61 compatibility** — Windows config file corruption fix for concurrent writes
- **Native installer documentation** — PREREQUISITES (EN, FR) updated: `npm install -g` deprecated, recommend `curl https://install.claude.com | bash`
- **Context management best practices** — compaction hints in CLAUDE.md, CLAUDE.local.md for personal preferences, `CLAUDE_CODE_SUBAGENT_MODEL` env var, anti-patterns reference table
- **CVE severity scores** — CVE-2025-59536 (8.7/10 CVSS) and CVE-2026-21852 severity added to MCP.md and security rule

### Changed

- **Recommended Claude Code version** — 2.1.59 → 2.1.61 (minimum stays 2.1.47)
- **Agent Teams Guide** — `CLAUDE_CODE_SUBAGENT_MODEL` tip for cost optimization, recommended version bumped
- **SECURITY.md** — supported versions updated to 7.23.x/7.22.x

## [7.22.0] - 2026-02-27

### Added

- **Claude Code v2.1.48-v2.1.59 compatibility** — ConfigChange/WorktreeCreate/WorktreeRemove hooks, remote-control, /memory, /copy, --worktree flag, Opus 4.6 1M context, Ctrl+F bulk agent kill
- **Security CVE documentation** — CVE-2025-59536 (hook command injection) and CVE-2026-21852 (path traversal) documented in HOOKS.md, MCP.md, and security rule
- **Context management best practices** — proactive /compact at 70%, PreCompact hooks, /memory command, multi-session strategy (55% token reduction)

### Changed

- **Recommended Claude Code version** — 2.1.59 (minimum stays 2.1.47)
- **Hook event count** — 13 → 16 in HOOKS.md (added ConfigChange, WorktreeCreate, WorktreeRemove)
- **Agent Teams pricing corrected** — Opus $5/$25 (was $15/$75), Haiku $1/$5 (was $0.25/$1.25), Sonnet 4.5 → Sonnet 4.6
- **SECURITY.md** — supported versions updated to 7.22.x/7.21.x, minimum recommended version 2.1.38 → 2.1.51

## [7.21.0] - 2026-02-20

### Added

- **Full infrastructure install support** — all 8 infrastructure technologies (Docker, Coolify, Kubernetes, OpenTofu, Ansible, Hcloud, PgBouncer, FrankenPHP) now fully integrated in `install-from-config.sh` with generalized infra handling and `claude-projects.sh` available techs list
- **Complete technology catalog in example** — `claude-projects.yaml.example` updated with all 18 technologies organized by category (App/Infra/Other)

### Fixed

- **RTK multi-account profiles** — `install-rtk.sh` now respects `CLAUDE_CONFIG_DIR` environment variable, enabling RTK hook installation per profile in multi-account setups

## [7.20.0] - 2026-02-20

### Added

- **FrankenPHP infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **PgBouncer infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **Kubernetes infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **OpenTofu infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **Ansible infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **Hcloud infrastructure** — 5 agents, 5 commands, install script, 5 languages
- **12 project management commands** — `/project:burndown`, `/project:checkpoint`, `/project:coverage-map`, `/project:critical-path`, `/project:dependencies`, `/project:gap-analysis`, `/project:generate-constitution`, `/project:metrics`, `/project:reverse-prd`, `/project:reverse-stories`, `/project:scan`, `/project:trace` (5 languages each)
- **Spec alignment gate** — `/gate:validate-alignment` command + `spec-alignment-gate.yaml` with 85% threshold and 6 weighted criteria (5 languages)
- **Constitution template** — project governance template `constitution.md` (5 languages)
- **BMAD metrics** — `.bmad/metrics/` directory for sprint velocity and burndown tracking
- **RTK integration** — Rust Token Killer install script, i18n, BATS tests, CLI registry, `/common:setup-rtk` command. Reduces LLM token consumption by 60-90%
- **10 reviewer agents v2.0** — all reviewers (Angular, Vue.js, Laravel, React Native, PHP, C#, Symfony, React, Python, Flutter) propagated to 5 languages with scoring /100 and decision trees

### Changed

- **Infrastructure expanded** — from 2 stacks (Docker, Coolify) to 8 (+ Kubernetes, OpenTofu, Ansible, Hcloud, PgBouncer, FrankenPHP). Total tech stacks: 18
- **BMAD gates updated** — `prd-gate.yaml`, `sprint-ready-gate.yaml`, `story-gate.yaml` enhanced with improved validation criteria
- **Project templates updated** — `prd.md`, `tech-spec.md`, `user-story.md` improved across 5 languages
- **Sprint next-story command** — enhanced across 5 languages
- **Training materials** — updated to reflect 63 agents, 204 commands, 26 namespaces, 18 stacks
- **Documentation** — RTK added to INSTALLATION.md, CLI-REFERENCE.md, SCRIPTS-REFERENCE.md, FAQ.md, index.html

### Fixed

- **4 failing test suites** — fs mock and `process.exitCode` issues in installer, check, ralph, and interactive tests
- **Command counts corrected** — propagated accurate counts across all documentation surfaces
- **Coolify missing from index.html** — added to landing page with correct i18n translations
- **Context essentials stale** — updated from 33/161/20 to 63/204/26 (agents/commands/namespaces)

## [7.19.0] - 2026-02-19

### Added

- **Active hooks (dogfooding)** — `.claude/settings.json` with 6 hooks: security-block (Bash), protect-files (Edit/Write), auto-format (prettier PostToolUse), context-reinject (SessionStart compact). The project now practices what it preaches: "Hooks = requirements"
- **Context essentials** — `.claude/context-essentials.md` for automatic context re-injection after compaction (version, structure, conventions, test commands)
- **New hook templates** — `quality-gate.json` (blocks git commit if tests fail) and `block-dangerous-commands.json` (blocks rm -rf /, sudo, chmod 777) in `.claude/templates/hooks/`
- **Agent validation tests** — 3 new tests: all agents must have `model:` field, Tier 1 reviewers must use sonnet, all reviewers must have scoring system (/100 or points)
- **CONTRIBUTING quick navigation** — table at top linking to common contributor paths (add stack, improve reviewer, fix bug, add translations, write skill)

### Changed

- **6 reviewer agents upgraded to v2.0** — angular, vuejs, laravel, reactnative, php, csharp reviewers rewritten with: model sonnet, scoring /100 in 4 categories, decision trees (CRITIQUE/MAJEUR/MINEUR), 5-phase audit methodology, structured report template, French language, tech-specific 2026 patterns
- **csharp-reviewer now has frontmatter** — was the only agent missing YAML frontmatter; now fully compliant with model: sonnet
- **CONTRIBUTING /tmp/ paths fixed** — all `/tmp/test-project` references replaced with `./test-output/` (project convention: no /tmp/ storage)
- **KNOWN_NO_FRONTMATTER emptied** — removed csharp-reviewer.md from exclusion list in agent tests

## [7.18.0] - 2026-02-19

### Added

- **Technology tier system** — formalized 3-tier model (core/supported/community) in tech-registry with `tier` field and `getTechsByTier()` helper. Tier 1 (core): Symfony, React, Python, Flutter. Tier 2 (supported): React Native, PHP. Tier 3 (community): C#, Angular, Laravel, Vue.js
- **Content validation tests** — new `tests/content/` suite validating agents (YAML frontmatter, required fields, model whitelist, skill references), commands (frontmatter, namespace consistency), and skills (SKILL.md + REFERENCE.md presence, format). Added `test:content` script
- **Skills publishing guide** — `docs/SKILLS-PUBLISHING.md` with distribution methods, publishing checklist, and attribution guidelines. Standalone `README.md` added to 4 pilot skills (solid-principles, testing, security, git-workflow)
- **Technologies documentation** — `docs/TECHNOLOGIES.md` with tier breakdown, maturity criteria, and upgrade paths
- **Competitive analysis** — `docs/COMPETITIVE-ANALYSIS.md` benchmarking against cursor-rules-cli, 10xrules, awesome-cursorrules, and others

### Changed

- **Reviewer agents differentiated** — 4 Tier 1 reviewers (React, Symfony, Python, Flutter) rewritten with deep tech-specific decision trees, unique scoring breakdowns, and tech-specific skills. Model upgraded from haiku to sonnet
- **README simplified** — 611 → 205 lines with progressive disclosure (install-first hero, key commands, doc links)
- **QUICKSTART rewritten** — restructured as a 10-minute journey with checkpoints and expected output at each step
- **CONTRIBUTING updated** — added Technology Tiers section with tier requirements table, upgrade guide, and community contribution template
- **Skill frontmatter improved** — broadened triggers and updated descriptions for solid-principles, testing, security, git-workflow

### Fixed

- **Broken symlink handling** — skills test now uses `lstatSync` to skip broken symlinks (e.g. `remotion-best-practices`)

## [7.17.1] - 2026-02-19

### Changed

- **README** — updated What's New section for v7.17

## [7.17.0] - 2026-02-19

### Added

- **LSP plugin documentation** — documented Claude Code LSP plugins for all 10 technology stacks: PHP/Symfony/Laravel (Intelephense), Python (Pyright), React/Angular/Vue/RN (vtsls), Flutter (Dart analyzer), C#/.NET (csharp-ls). Added sections in tooling references, CLAUDE.md, INDEX.md, PREREQUISITES.md, MCP.md (LSP vs MCP comparison), and TECHNOLOGIES.md

## [7.16.0] - 2026-02-19

### Added

- **Claude Code 2.1.46-2.1.47 compatibility** — MCP connectors from claude.ai, macOS orphan process fix, VS Code Plan Preview auto-updates, `last_assistant_message` in Stop/SubagentStop hooks, `added_dirs` in statusline JSON, `chat:newline` keybinding for multi-line input
- **Performance improvements** — ~500ms faster startup (deferred SessionStart hooks), `@` file mention pre-warming and session caching, O(n²) memory fix for long sessions
- **Resume & navigation** — `/rename` updates terminal tab title, resume picker shows 50 sessions (up from 10), Shift+Down wrapping for teammate navigation, custom `/rename` titles preserved
- **45+ bug fixes** — FileWriteTool trailing blank lines, Unicode curly quotes corruption (#26141), parallel write resilience, large sessions >16KB in /resume (#25721), Windows terminal rendering, background agents final response (#26012), agents/skills in git worktrees (#25816), plan mode after compaction (#26061), PDF compaction, CJK wide character alignment

### Changed

- **Minimum Claude Code version** — bumped from 2.1.45 to 2.1.47
- **README What's New** — updated to v7.16 highlights

## [7.15.0] - 2026-02-18

### Added

- **Context management rule** — new `12-context-management.md` (5 languages) covering Anthropic's #1 best practice: context window as THE critical resource, `/clear` usage, sub-agent delegation, verification loops (2-3x quality), Plan Mode guidance, token tracking thresholds
- **MCP & Plugin security** — updated `11-security.md` (6 files, 5 languages) with Snyk 2026 findings (76 malicious payloads in public MCP registries), vetting checklist, PreToolUse hook enforcement, CLAUDE.md vs Hooks distinction
- **Hook templates** — 4 ready-to-use templates in `.claude/templates/hooks/`: auto-format (PostToolUse), protect-files (PreToolUse), context-reinject (SessionStart compact), security-block (PreToolUse Bash)
- **Parallel worktrees skill** — new `/parallel-worktrees` skill documenting Boris Cherny's productivity pattern for concurrent Claude sessions (writer/reviewer workflow)
- **Best Practices section** — CLAUDE.md updated with MCP Tool Search (46.9% context reduction), adaptive thinking guidance (low/medium/high/max), hooks enforcement references
- **Context Management Best Practices** — new section in COMMANDS.md with thresholds, hooks vs instructions comparison

### Changed

- **README What's New** — updated to v7.14 highlights
- **Skill count** — 36 → 37 (added parallel-worktrees)

## [7.14.0] - 2026-02-18

### Added

- **Documentation update** — Plan Mode Classification section in COMMANDS.md, updated README What's New to v7.13, enriched training materials with Plan Mode guidance (MANDATORY/RECOMMENDED/CONDITIONAL), updated all training docs versions to 2.1.45/7.13.0

## [7.13.0] - 2026-02-18

### Added

- **Claude Code 2.1.42-2.1.45 compatibility** — resume title fix, structured outputs header, auth token refresh, plugin hot-reload/backup, memory improvements, spinnerTipsOverride, plugin directory config, Agent SDK rate limiting
- **Claude Sonnet 4.6 support** — new model (`claude-sonnet-4-6`, $3/$15/M, 200K/1M context, near-Opus coding performance)
- **Plan Mode guidance** — added Plan Mode sections to all 543 command files across 5 languages (en, fr, es, de, pt), classifying each command as MANDATORY (22 commands — code generation, implementation, QA), RECOMMENDED (6 commands — architecture decisions, design, planning), or CONDITIONAL (51 commands — analysis, audits, checks activated automatically based on scope)

### Fixed

- **Cost-estimator pricing** — corrected Opus from $15/$75 (Opus 4.1) to $5/$25 (Opus 4.6), Haiku from $0.25/$1.25 (Haiku 3) to $1/$5 (Haiku 4.5)

### Changed

- **Minimum Claude Code version** — bumped from 2.1.41 to 2.1.45

## [7.12.0] - 2026-02-18

### Added

- **Playwright E2E tests** — 119 tests covering all 89 pages (5 locales), landing page, navigation, search, accessibility (axe-core WCAG 2.1 AA), and 404 page
- **CI E2E test job** — Playwright runs between build and deploy in docs workflow, blocking deploy on test failure

### Fixed

- **Accessibility** — added `<main>` landmark, `aria-label` on language selects and GitHub links, `aria-hidden` on decorative SVGs, semantic `<dl>` for stats grid
- **Performance** — removed unused Tailwind CDN and Lucide CDN scripts from landing page
- **Responsive mobile layout** — proper mobile styles for landing page grid and navigation

## [7.11.0] - 2026-02-13

### Added

- **Agent Teams optimization** — reduce token overhead from ~30% to ~15-20% via lean context loading (task-type-specific tokens per worker: audit=4K, sprint=5K, security=3.5K, delivery=5.5K) and adaptive coordination overhead (5% + 3.5%/worker replacing flat 15%)
- **Fast Mode blocking guard** — all 4 team commands display 6x cost comparison dashboard and require explicit confirmation before proceeding in Fast Mode
- **Budget guard (`--max-cost`)** — abort team execution when estimated parallel cost exceeds user-specified dollar threshold
- **Structured spawn templates** — rich TaskCreate context per worker type (project, tech, reference, checks, output schema) for higher quality first-pass results
- **Context compaction mitigation** — leader re-reads TaskList every 5 completions (bug #23620); delivery re-reads phase-handoff.yaml at Phase 2 start
- **Per-task timeout baselines** — 1.5x estimated duration per task type in ralph-teams-adapter (audit=135s, sprint=1350s, security=180s, delivery=1800s)
- **Auto-size recommendation** — `recommend_team_size()` in cost-estimator for optimal worker count
- **Sub-agents vs Agent Teams decision matrix** — comparison table and concrete examples in sub-agents-patterns.md
- **138 bats tests** — cost-estimator (42), cost-dashboard (24), ralph-teams-adapter (27), compatibility-check (23), result-aggregator (22)

### Changed

- **Delivery Phase 1 Reviewer** — model changed from sonnet to haiku (-15% Phase 1 cost)
- **Polling cadence** — standardized across all team commands (30s, backoff to 60s after 3 idle polls)
- **Message verbosity** — worker completion messages capped at <50 tokens across all team commands
- **i18n** — all changes mirrored across 5 languages (en, fr, es, de, pt) for 4 team commands

## [7.10.2] - 2026-02-13

### Changed

- **Claude Code compatibility** — document v2.1.39 and v2.1.41 features (nested session guard, auth CLI commands, Windows ARM64, /rename auto-generation, Agent Teams cloud provider fix, OTel fast mode tracing, @-mention anchor fix, Agent SDK & plan mode fixes); bump minimum version from 2.1.38 to 2.1.41

## [7.10.1] - 2026-02-13

### Fixed

- **Status line locale bug** — force `LC_NUMERIC=C` in `statusline.sh` for locale-safe numeric formatting; `printf "%.2f"` failed on non-English locales (e.g. French) where the decimal separator is a comma, causing cost to display as `$0,00` instead of `$0.50`

## [7.10.0] - 2026-02-13

### Added

- **Status Line v2.0** — fixed critical `settings.json` format (`"type": "command"` instead of `"enabled"`/`"script"`), native `context_window.used_percentage`, single jq call (7→1), cross-platform `stat`, git cache (5s TTL), 13 element toggles, agent name, vim mode, burn rate, lines changed, progress bar styles (`percentage`/`bar`/`both`), compact/detailed modes, `--version`/`--help` flags
- **27 bats tests** for status line (`Tools/StatusLine/tests/statusline.bats`)
- **`test-statusline` Makefile target** — runs status line tests via Docker

### Changed

- **Status line README** — rewritten in English with full v2.0 documentation
- **`statusline.conf.example`** — expanded with all new options (toggles, bar style, display mode, git cache TTL)
- **Docs** — fixed `settings.json` format in `docs/guides/{en,fr}/05-tools-reference.md` and `06-troubleshooting.md`

## [7.9.0] - 2026-02-13

### Added

- **Multi-account `doctor` command** — checks profile permissions, .mode file, symlink validity, credentials JSON, shell aliases, and orphan alias detection
- **`--json` flag** — machine-readable JSON output for `list` and `--version`, enabling scripting and pipeline integration
- **Standardized exit codes** — `0` (OK), `1` (error), `2` (usage), `3` (not found), `4` (missing dep)
- **Shell completions** — bash and zsh tab-completion for commands and profile names (`completions/`)
- **`.claude-profile` per project** — `ccsp` reads this file for automatic profile switching by directory
- **`CLAUDE_PROFILE_NAME` export** — `ccsp()` exports the active profile name for shell prompt integration (PS1, Starship)
- **23 bats tests** — comprehensive test suite for version, CRUD, exit codes, JSON output, doctor (`tests/claude-accounts.bats`)
- **Makefile targets** — `install-completions` (bash/zsh) and `test-tools` (bats via Docker)
- **29 i18n keys** across 5 languages (en/fr/es/de/pt) — doctor, permissions warning, backup, delete confirmation, JSON output

### Changed

- **Profile directory permissions** — `chmod 0700` enforced on creation (`add`, `migrate`) and `ensure_profiles_dir`; warning displayed in `list` if permissions are too open
- **Signal handling** — `trap _cleanup EXIT` with `_TMP_FILES` tracking for safe Ctrl+C cleanup
- **Profile validation** — `validate_profile()` guard added to `run` and `auth` CLI commands; returns exit code 3 for missing profiles
- **CLI `rm` i18n** — hardcoded English strings replaced with i18n keys (`MSG_CONFIRM_DELETE`, `MSG_BACKUP_CREATED`)
- **Interactive menu** — doctor added as option 8, help moved to option 9

## [7.8.0] - 2026-02-12

### Added

- **Coolify infrastructure technology** — 4 agents (`@coolify-architect`, `@coolify-deployment`, `@coolify-debug`, `@coolify-monitoring`), 5 commands (`/coolify:setup`, `/coolify:deploy`, `/coolify:debug`, `/coolify:backup`, `/coolify:optimize`), install script, full i18n (en/fr/es/de/pt) — 46 new files
- **`install-coolify` Makefile target** — standalone Coolify installation; `install-infra` now installs both Docker and Coolify
- **Coolify in tech registry** — CLI namespace, help text, and `INSTALLABLE_TECHS` exclusion (infra, not dev tech)

### Changed

- **Counter updates** — commands 155→160, agents 29→33, namespaces 19→20 across CLAUDE.md, README.md, docs/index.html (stats grid + i18n), COMMANDS.md, COMMANDS-FULL-REFERENCE.md, AGENTS.md
- **README.md** — added Coolify to AI Agents description
- **docs/AGENTS.md** — added Coolify/Infrastructure Agents section (4 agents)

## [7.7.2] - 2026-02-12

### Fixed

- **Command count** — reverted erroneous 156→155 (verified: 117 Dev + 33 Project + 5 Docker = 155)
- **docs/index.html** — 9 stale `v5.8.0` version badges updated to `v7.7.1`; template count 23→21; checklist count 9→10
- **README.md** — "What's New" updated to v7.7; template count 33→21; checklist count 21→10
- **docs/AGENTS.md** — removed phantom BMAD agent section (39→29 actual); cleaned up ASC mode documentation

## [7.7.1] - 2026-02-12

### Fixed

- **docs/index.html** — copyright symbol `&copy;` rendered as literal text in i18n translations; replaced with Unicode `©` in all 5 JS translation strings (the i18n system uses `textContent` for non-HTML strings)

## [7.7.0] - 2026-02-12

### Changed

- **docs/index.html** — fixed all outdated counters in presentation page: agents 40→29, commands 130+→155, skills 249→36, templates 25→23, checklists 21→9; updated feature cards and all 5 i18n translations (EN/FR/ES/DE/PT)
- **README.md** — "What's New" updated to v7.6 features; agent count 28→29; skills count 50→36
- **CLAUDE.md** — agent count 28→29 in header description
- **docs/AGENTS.md** — added note explaining Docker and Project agent bundling
- **docs/FAQ.md** — Node.js 18+→20+
- **docs/PREREQUISITES.md** — Claude Code minimum version 2.1.0→2.1.38
- **docs/QUICKSTART.md** — Node.js 18+→20+
- **i18n docs** — PREREQUISITES and QUICKSTART updated for DE/ES/FR/PT (Node.js 20+, Claude Code 2.1.38); FR FAQ Node.js 20+

### Added

- **.github/PULL_REQUEST_TEMPLATE.md** — standardized PR template

## [7.6.1] - 2026-02-12

### Fixed

- **CLI `update` command** — argument order was wrong (`script TARGET LANG --force` instead of `script --lang=LANG --force TARGET`), causing all install scripts to reject the lang parameter
- **2026 feature references copy** — added same-directory guard in `install-tech-common.sh` to prevent `cp` errors when source and destination resolve to the same path

## [7.6.0] - 2026-02-12

### Changed

- **README.md** — "What's New" updated to v7.5 features; fixed namespace count (20→19); added `/team:` and `/uiux:` to Command Namespaces (17→19); Docker commands 4→5
- **COMMANDS.md** — added `/docker:optimize` to Docker detailed section (was in summary but missing from details)
- **CONTRIBUTING.md** — Node.js 18+→20+; added shellcheck to prerequisites; added `lint:shell` and `lint:i18n` to Running Tests
- **PREREQUISITES.md** — Node.js 18→20 (lines 9 and 229)
- **vitest.config.mjs** — raised coverage thresholds from 80/85/70/80 to 90/90/90/90 (actual coverage: 96/93/96/96)

## [7.5.0] - 2026-02-12

### Added

- **Doctor yq check** — `doctor` command now verifies `yq` availability (required for YAML config per PREREQUISITES.md)
- **CLI-REFERENCE.md** — added `check`, `list`, `doctor`, `update` command sections with usage, options, and examples
- 5 new doctor tests (yq OK/missing, unreadable scripts dir, empty i18n, non-executable scripts, real tryExec)
- 2 new update tests (skip when install script missing, all-scripts-fail path)

### Changed

- **README.md** — "What's New" updated to v7.4 features (list/doctor/update, 20 namespaces, fs-utils)
- **QUICKSTART.md** — verification section now recommends `check` and `doctor` commands instead of `ls -la`
- **CLAUDE.md** — fixed namespace count: "16+" → "19 namespaces"
- **doctor.js** — renumbered check comments (5→yq, 6→structure, 7→scripts, 8→i18n)
- Test count: 511 → 519 tests
- Coverage: doctor.js 86% → 96%, update.js 91% → 100%

## [7.4.0] - 2026-02-12

### Added

- **CLI `list` command** — detailed listing of installed claude-craft components (`npx @the-bearded-bear/claude-craft list [dir]`)
- **CLI `doctor` command** — environment diagnostics & installation health check (`npx @the-bearded-bear/claude-craft doctor [dir]`)
- **CLI `update` command** — re-run install scripts to refresh an existing installation (`npx @the-bearded-bear/claude-craft update [dir] [--lang=XX] [--tech=NAME]`)
- `cli/lib/fs-utils.js` — shared `countFiles` / `listDirs` utilities extracted from check.js
- `cli/lib/list.js`, `cli/lib/doctor.js`, `cli/lib/update.js` — new command modules
- `tests/cli/list.test.mjs` — 4 tests for list command
- `tests/cli/doctor.test.mjs` — 8 tests for doctor command
- `tests/cli/update.test.mjs` — 7 tests for update command
- `tests/cli/fs-utils.test.mjs` — 6 tests for shared fs utilities
- 2 detect-project tests for Python/Docker catch path coverage
- 4 index.js tests for flattenCodebase, constructor, detectProject, parseArgs delegation

### Changed

- **check.js**: Refactored to import `countFiles` / `listDirs` from `fs-utils.js` (DRY)
- **help.js**: Added 3 missing namespace entries (python, reactnative, php) — now 20 namespaces; added list, doctor, update to Commands section
- **README.md**: Removed phantom `/pm:` and `/arch:` namespaces; replaced stale `/common:recette*` with `/qa:*`
- **index.js**: Wired 3 new commands (list, doctor, update)
- Test count: 480 → 511 tests

## [7.3.0] - 2026-02-12

### Added

- **CLI `check` command** — verify claude-craft installation in a project directory (`npx @the-bearded-bear/claude-craft check [dir]`)
- `cli/lib/check.js` — new module: scans `.claude/` for commands, agents, references, skills with colorized summary
- `tests/cli/check.test.mjs` — 6 tests for check command (empty dir, full structure, partial, multi-namespace, tech detection)
- 4 shell-ui integration tests for cross-directory sourcing (Infra/, Project/, tcl-common guard)
- 4 detect-project tests (unreadable dir, debug logging, all 10 techs, 2-tech complexity)

### Changed

- **install-from-config.sh**: Sources `shell-ui.sh` instead of defining local colors/logging; `log_*`/`print_header`/`print_section` are backward-compat aliases
- **install-infra-rules.sh**: Sources `shell-ui.sh` instead of defining local colors/logging; `log_*` are backward-compat aliases
- **install-project-commands.sh**: Sources `shell-ui.sh`; emoji echo replaced with `ui_box`/`ui_info`/`ui_success`
- **check-prerequisites.sh**: Sources `shell-ui.sh`; header uses `ui_box`, checks use `ui_check_ok`/`ui_check_fail`/`ui_check_warn`
- **tcl-common.sh**: Added shell-ui.sh guard — auto-sources when `ui_info` not already defined
- **help.js**: Added `--version, -v` to Options display; added `check` to Commands list
- **README.md**: Updated "What's New" to v7.3; removed stale `(v3.2+)` suffix; fixed Migration Guide link (v3.0 → v7.0)
- **FAQ.md**: Fixed stale `.claude/rules/00-project-context.md` path → `.claude/CLAUDE.md`
- Zero duplicate color/logging definitions across all install scripts
- Test count: 466 → 480 tests

## [7.2.0] - 2026-02-12

### Added

- `detect-project.js`: Detection for 5 missing techs — Angular (`@angular/core`), Vue.js (`vue`), C#/.NET (`.csproj`/`.sln`), Laravel (`laravel/framework`), generic PHP (composer.json fallback)
- `help.js`: "Available Namespaces" section listing all 16 v7.0 namespaces with descriptions
- `tests/cli/shell-ui.test.mjs` — 16 tests verifying all `ui_*` functions, color variables, and output format
- `tests/cli/detect-project.test.mjs` — expanded from 14 to 30 tests covering all 10 tech detections, malformed JSON, multi-tech, edge cases
- `tests/cli/help.test.mjs` — expanded from 3 to 8 tests covering namespaces, options, examples
- `tests/cli/tech-registry.test.mjs` — 2 additional consistency tests (derived keys, displayName match)
- `tests/cli/cli-class.test.mjs` — readline lifecycle test

### Changed

- **constants.js**: `TECHNOLOGIES` now derived from `tech-registry.js` SSOT (DRY consolidation)
- **detect-project.js**: Refined Symfony detection to check for `symfony/` packages; added Laravel/generic PHP distinction
- **install-tech-common.sh**: Sources `shell-ui.sh` instead of defining local colors/logging; `log_*` are backward-compat aliases
- **install-common-rules.sh**: Sources `shell-ui.sh` instead of defining local colors/logging; `print_header` uses `ui_box`
- **check-config.sh**: Sources `shell-ui.sh` instead of defining local colors; `log_*` delegate to `ui_check_*`, `print_header` uses `ui_header`
- **Makefile `list-commands`**: Now includes Docker, Workflow, Team, QA, UIUX namespaces; checks both lang and base directories
- Test count: 430+ → 466 tests
- Coverage: detect-project.js → 93%, help.js → 100%, constants.js → 100%

## [7.1.0] - 2026-02-12

### Added

- `cli/lib/tech-registry.js` — Single Source of Truth for all 11 technology stacks (name, namespace, i18n dir, install script, version)
- `Dev/scripts/lib/shell-ui.sh` — Shared UI library for shell scripts (colors, logging, headers, progress indicators)
- `tests/cli/installer-interactive.test.mjs` — 10 tests for interactive install wizard (directory creation, language selection, tech selection, cancel flow)
- `tests/cli/tech-registry.test.mjs` — 11 consistency tests verifying registry matches constants.js, i18n directories, install scripts, and plugin.json
- `tests/scripts/install-dry-run.test.mjs` — 6 integration tests for install dry-run (file counts, namespace validation, no-side-effects)
- Ralph DoD failure modes and timeout documentation in `ralph-run.md`

### Changed

- **README.md**: Fixed skills count from 249 to 50 (actual unique skills)
- **CONTRIBUTING.md**: Added all 10 technologies to test loop (was missing csharp, reactnative, vuejs, laravel, php)
- **vitest.config.mjs**: Raised coverage thresholds — statements 75→80%, branches 80→85%, functions 65→70%, lines 75→80%
- **CLAUDE.md.template**: Updated to v7.0 structure — `rules/` → `references/`, `commands/` now namespaced
- **check-config.sh**: Refactored from 5 hardcoded check functions to data-driven `TECH_REGISTRY` array supporting all 10 technologies
- **plugin.json**: Version bump from 6.2.0 to 7.1.0
- **cli-class.test.mjs**: Added 5 tests for language, tech, path options and flatten command
- Test count: 393 → 430+ tests
- Coverage: statements 81% → 92%+, installer.js 51% → 97%

---

## [7.0.0] - 2026-02-12

### BREAKING CHANGES

- `/common:` reduced from 38 to 12 commands — 26 commands moved to dedicated namespaces
- 9 workflow commands moved: `/common:workflow-*` → `/workflow:*`, `/common:sprint-retro` → `/workflow:retro`, `/common:sprint-review` → `/workflow:review`, `/common:sprint-start` → `/workflow:start`
- 4 team commands moved: `/common:team-*` → `/team:*`
- 6 QA commands moved: `/common:recette*` → `/qa:*`, `/common:fix-bug-tdd` → `/qa:tdd`
- 7 UI/UX commands moved: `/common:uiux-*` → `/uiux:*`, `/common:a11y-*` → `/uiux:a11y-*`, `/common:ui-design-tokens` → `/uiux:design-tokens`, `/common:ux-user-flow` → `/uiux:user-flow`
- 1 Docker command moved: `/common:docker-optimize` → `/docker:optimize`
- 5 sprint commands moved: `/project:sprint-*` → `/sprint:*`
- 6 gate commands moved: `/project:gate-*` → `/gate:*`
- 4 project commands renamed: `/project:project-run-sprint` → `/project:run-sprint`, `/project:project-run-epic` → `/project:run-epic`, `/project:project-run-queue` → `/project:run-queue`, `/project:project-batch-status` → `/project:batch-status`

### Added

- `docs/MIGRATION-v7.md` — complete migration guide with 41-entry mapping table
- `tests/scripts/namespace-integrity.test.mjs` — 5 tests for residual patterns, i18n parity, command counts
- New i18n directories: `Workflow/`, `Team/`, `QA/`, `UIUX/` under `Dev/i18n/{lang}/`
- New i18n directories: `Sprint/`, `Gate/` under `Project/i18n/{lang}/`

### Changed

- `/common:` namespace: 38 → 12 commands
- `/project:` namespace: 33 → 22 commands
- `/workflow:` namespace: 6 → 9 commands (added retro, review, start)
- `/docker:` namespace: 4 → 5 commands (added optimize)
- `/sprint:` namespace: 4 → 5 commands (added dev)
- New namespaces: `/team:` (4), `/qa:` (6), `/uiux:` (7)
- Total command count unchanged: 155
- Install scripts updated: `install-common-rules.sh`, `install-project-commands.sh`, `tcl-common.sh`
- All cross-references updated across Dev/, Project/, Infra/, docs/, .claude/

---

## [6.2.0] - 2026-02-12

### Removed

- `/sprint:bmad-status` command — alias stub for `/sprint:status --bmad` (5 i18n files)
- `/project:validate-backlog` command — alias stub for `/gate:validate-backlog --no-gate` (5 i18n files)
- `/project:move-story` command — merged into `/sprint:transition` (5 i18n files)
- BMAD v6 phantom agents section from documentation — these 10 roles (bmad-master, pm, ba, architect, po, sm, dev, qa, qa-recette, ux) are personas in workflow/sprint commands, not standalone agent files

### Changed

- `/sprint:transition` now supports sprint assignment (`sprint-N`) and task cascade behavior (merged from move-story)
- Agent count: 39 → 28 (removed 10 phantom BMAD agent entries from docs; php-reviewer has no agent file)
- Command count: 158 → 155 (removed 3 redundant commands)
- QA Recette namespace: documented as `/common:recette*` instead of `/qa:recette*` to match actual installation
- Updated COMMANDS-FULL-REFERENCE.md command count from "132+" to "155"

---

## [6.1.1] - 2026-02-12

### Added

- `/qa:recette-status` command — show session status and progress (5 languages)
- `/qa:recette-regression` command — view and manage regression test registry (5 languages)
- `/qa:recette-report` command — generate reports from session data in MD/HTML/JSON (5 languages)

### Changed

- Command count: 155 → 158 (3 new QA Recette commands)
- Removed `[PLANNED]` tags from QA Recette commands in documentation
- Updated COMMANDS.md, COMMANDS-FULL-REFERENCE.md, INDEX.md with new command details

### Fixed

- Widened `execSync` timeouts in 4 test files to eliminate flaky ETIMEDOUT failures under load
- Restored OIDC npm publishing (broken since v5.9.2 Phase 2 remediation)
- Fixed `workflow_dispatch` generating `-next` suffix instead of using package.json version directly

---

## [6.0.0] - 2026-02-11

### BREAKING

- **Removed** `/common:full-audit` command — use `/common:team-audit --sequential` instead
- **Removed** `/common:ralph-sprint` command — use `/common:team-sprint --ralph-mode` instead
- **Removed** `@workflow-orchestrator` agent — use `/workflow:*` commands directly

### Added

- `docs/MIGRATION-v6.md` — upgrade guide from v5.x to v6.0

### Removed

- `docs/AUTONOMOUS-SPRINT.md` — ASC-specific documentation (functionality now in team-sprint)
- 15 i18n files for removed commands/agent (full-audit, ralph-sprint, workflow-orchestrator)

### Changed

- Agent count: 40 → 39 (removed workflow-orchestrator)
- Command count: 157 → 155 (removed full-audit and ralph-sprint)
- Updated all documentation references to use replacement commands

---

## [5.19.0] - 2026-02-11

### Added
- **DOC-13**: Automated i18n parity check script (`scripts/verify-i18n-parity.sh`) with `npm run lint:i18n` alias — compares file counts across all 5 languages in `Dev/i18n/` and `docs/guides/`

### Fixed
- **SEC-16**: Upgraded 5 Ralph scripts from `set -e` to `set -euo pipefail` (ralph.sh, pre-tool-context.sh, session-restore.sh, status-injector.sh, stop-dod-gate.sh) with uninitialized variable fixes

### Changed
- **DOC-5**: Closed as "by design" — i18n asymmetry is intentional per I18N-STATUS.md (Dev/i18n and docs/guides at full parity, docs/*.md English-only with opt-in community translations)

---

## [5.18.0] - 2026-02-11

### Added
- **SEC-13**: 46 CLI injection security tests (shell metacharacters, command substitution, null bytes, path traversal, prototype pollution, oversized inputs)

### Fixed
- **SEC-1**: Removed unnecessary `$(echo ...)` subshell from tilde expansion in `install-from-config.sh` (3 occurrences) and `check-config.sh` (1 occurrence) — direct variable assignment `"${root/#\~/$HOME}"` eliminates any residual injection surface

### Changed
- Confirmed CICD-8, CICD-13, CICD-15/CQ-15 already resolved in prior phases (CI permissions scoped, node_modules gitignored, engines.node >=20.0.0)

---

## [5.17.0] - 2026-02-11

### Added
- **TEST-20**: 1 unit test for ralph.js synchronous spawn error path (lines 92-95)
- **CICD-21**: Raised coverage thresholds (lines 50→75%, branches 40→80%, functions 50→65%)

### Fixed
- **DOC-17**: Removed stale `migrate-project.sh` and `make migrate*` references from 10 doc files (README, CLI-REFERENCE, TROUBLESHOOTING, ARCHITECTURE, SCRIPTS-REFERENCE, MIGRATION-v4, FAQ, MAKEFILE-REFERENCE, fr/FAQ, fr/CLI-REFERENCE)
- **DOC-18**: Updated README "What's New" to v5.17

---

## [5.16.0] - 2026-02-11

### Added
- **TEST-19**: 3 unit tests for ralph.js event handlers (close code 0, close code 1, spawn error)
- **CQ-18**: Convenience scripts `test:watch` and `lint:fix` in package.json

### Fixed
- **DOC-15**: Fixed SKILLS.md — corrected skill counts (Flutter 10→8, React 8→6, ReactNative 11→9, Python 6→4), removed phantom `quality-tools`, updated total 58→50 unique
- **DOC-16**: Updated README "What's New" to v5.16
- **ARCH-17**: Removed 3 stale Makefile migrate targets referencing nonexistent `migrate-project.sh`

### Changed
- **CQ-17**: ESLint tightened with `no-shadow`, `object-shorthand`, `prefer-template` (warnings)

---

## [5.15.0] - 2026-02-11

### Added
- **TEST-17**: 8 unit tests for `ClaudeCraftCLI.run()` (version flags, validation errors, command dispatch)
- **TEST-18**: 3 unit tests for installer.js error handling (spawn failure, non-zero exit, missing script)
- **CICD-19**: Vale prose linter in CI pipeline
- **CICD-20**: Coverage thresholds in vitest config (50% lines, 40% branches)

### Fixed
- **DOC-12**: Fixed COMMANDS.md — namespace count table (7 wrong counts), added `/workflow:` (6), `/php:` (5), 3 missing commands
- **DOC-13**: Fixed CONTRIBUTING.md stale directory structure (now references `Dev/i18n/{lang}/{Tech}/`)
- **DOC-14**: Updated README "What's New" from v5.13 to v5.15

---

## [5.14.0] - 2026-02-11

### Added
- **TEST-16**: 4 unit tests for `ClaudeCraftCLI` class (constructor, delegates)
  - `cli/index.js` now exports class + guards auto-run for testability

### Changed
- **DOC-9**: Updated README project structure to reflect Phase 14 CLI refactoring (cli/lib/)
- **DOC-10**: Fixed ARCHITECTURE.md Mermaid diagram — added banner.js, help.js, installer.js, ralph.js
- **DOC-11**: Added missing `init`, `ralph`, `help` commands to CLI-REFERENCE.md
- **TEST-15**: Removed ~25 redundant tests from index.test.mjs (logic now tested in dedicated module files)
- **CQ-16**: Tightened ESLint rules (eqeqeq, no-var, prefer-const)

---

## [5.13.0] - 2026-02-11

### Added
- **TEST-14**: 15 unit tests for Phase 14 extracted CLI modules
  - banner.js (3), help.js (3), installer.js (4), ralph.js (5)
- **CICD-18**: Coverage reporting with `@vitest/coverage-v8`
  - New `test:coverage` script, v8 provider on cli/ modules

### Changed
- **CICD-17**: CI now enforces Prettier formatting (`format:check`)
- **CQ-15**: Fixed Prettier formatting violations in 7 CLI files
- **DOC-8**: Updated README "What's New" from v5.9 to v5.13
- **DOC-7**: Fixed bundles/README.md version (v3.0 → v5.13.0), removed ghost `bundle` CLI commands

---

## [5.12.0] - 2026-02-11

### Changed
- **ARCH-15**: Refactored CLI from 595-line monolith into 6 focused modules
  - Extracted `banner.js`, `help.js`, `installer.js`, `ralph.js` into `cli/lib/`
  - `cli/index.js` reduced to ~220-line thin orchestrator
- **ARCH-16**: Added `bundles/` (AI instruction bundles) to npm distribution

### Added
- **TEST-6**: 8 additional unit tests for `CodebaseFlattener` (cli/flattener.js)
  - Constructor defaults/custom options, flatten() end-to-end, printSummary()

---

## [5.11.0] - 2026-02-11

### Changed
- **ARCH-3**: Deduplicated i18n directory — extracted 114 language-agnostic files into `Dev/i18n/base/`
  - Removed 570 redundant file copies across 5 language directories (~17 MB saved)
  - Install scripts now use base+overlay resolution: shared files from `base/`, translations from `{lang}/`
  - New helpers: `copy_i18n_files()`, `copy_i18n_dir()`, `resolve_i18n_file()`, `i18n_dir_exists()` in install-tech-common.sh
  - Updated `get_source_dir()`, `verify_source_files()`, `copy_tech_references()`, `copy_base_references()` for base fallback
  - i18n file count: 2,035 → 1,584 (−22%)

### Added
- 26 new tests for i18n base overlay resolution (shell function unit tests + integration tests)

---

## [5.10.1] - 2026-02-11

### Fixed
- **SEC-9**: Fixed unsafe `xargs` without `-r` flag in pre-compact.sh
- **SEC-15**: Added shebang validation before `chmod +x` in hooks-generator.sh

### Added
- **TEST-12/13**: Additional unit tests for flattener output and CLI argument building
- **DOC-5**: i18n status documentation (`docs/I18N-STATUS.md`)
- **DOC-17a**: Architecture diagram (Mermaid) in `docs/ARCHITECTURE.md`
- **SEC-14**: Documented MCP template placeholder requirements

### Changed
- **ARCH-4**: Trimmed Makefile — removed CLI-redundant targets, added loop-based install-all (~390 lines)
- **SEC-17**: Updated `.npmignore` to exclude Ralph state directories from npm package
- **CICD-16**: Clarified version semantics in migration script

---

## [5.10.0] - 2026-02-11

### Changed
- **CQ-7**: Migrated CLI from CommonJS to native ESM (`"type": "module"`)
- All 6 CLI modules converted to `import`/`export` syntax
- Test suite updated to direct ESM imports (removed `createRequire` bridge)
- ESLint config updated for ESM source type

---

## [5.9.9] - 2026-02-11

### Fixed
- **CQ-14**: Fixed step counter in `runInstallation()` — docker no longer double-counted, missing scripts handled correctly

### Added
- Unit tests for `cli/lib/colors.js` module
- CI: `npm audit` security check before publish
- CI: Package size threshold enforcement (25 MB)
- Vitest timeout configuration for long-running install tests

---

## [5.9.8] - 2026-02-11

### Fixed
- **SEC-6**: YAML injection in escalation `create_escalation()` — replaced heredoc with safe `yq` construction
- **SEC-10**: Removed `DATABASE_URL` from session-init.sh env allowlist (may contain credentials)
- **SEC-11**: Hardened `block-dangerous-commands.sh` — expanded matcher scope, added flag reordering detection, broadened secret exposure patterns
- **SEC-12**: Added CLI input validation for `--max-iterations` and `--output` options
- **Ralph syntax**: Fixed bash syntax errors in `dod-validator.sh` (regex) and `escalation-service.sh` (for-loop redirect)

---

## [5.9.7] - 2026-02-11

### Changed
- **ARCH-1**: Consolidated 10 tech install scripts into thin wrappers + shared library (`Dev/scripts/lib/install-tech-common.sh`), reducing ~6,000 lines to ~2,600 (~57% reduction)
- All install scripts maintain identical CLI interface and behavior (backward compatible)

---

## [5.9.6] - 2026-02-11

### Added
- **ESLint config**: Created `eslint.config.mjs` (flat config ESLint 9) for `cli/` JavaScript linting

### Fixed
- **CQ-10**: Documented magic numbers in `flattener.js` (TOKENS_PER_CHAR, MAX_TOKENS_PER_SHARD) with rationale
- **DOC-6**: Replaced hardcoded French strings with English in all 11 install scripts
- **ESLint warnings**: Fixed 5 unused variable warnings in `flattener.js` and `index.js`

### Removed
- **ARCH-12**: Deleted dead code `Dev/scripts/lib/install-common.sh` (504 lines), obsolete `Dev/scripts/migrate-project.sh` (v3.0 migration script), and associated test

---

## [5.9.5] - 2026-02-10

### Added
- **ShellCheck CI**: Added ShellCheck linting step in `npm-publish.yml` workflow, completing 100% of audit Phase 2 items
- **`.shellcheckrc`**: Project-wide ShellCheck configuration (SC1091, SC1090, SC2034 exclusions)
- **`lint:shell`**: New npm script for local shell script linting (`--severity=warning`)

---

## [5.9.4] - 2026-02-10

### Added
- **JSDoc**: `@module` tag on `cli/flattener.js` exported module
- **routing-engine tests**: State machine validation, valid/invalid transitions, autonomous mode toggles (39 tests)
- **ASC mode tests**: Error classification, retry backoff logic, DoD security regression, stop conditions (39 tests)

### Fixed
- **quality-gate warning**: Now logs a warning when no test framework is detected instead of passing silently (all 5 languages)

---

## [5.9.3] - 2026-02-10

### Added
- **Test infrastructure**: vitest config, 14 test files (168+ tests), commitlint
- **Code quality tooling**: `.editorconfig`, `.prettierrc`, `.github/CODEOWNERS`, `dependabot.yml`
- **CLI testability**: Extracted `parseArgs`, `detectProject`, constants into `cli/lib/` modules
- **Vale prose linter**: `.vale.ini` config with project vocabulary for documentation linting
- **i18n team commands**: `team-audit`, `team-delivery`, `team-security`, `team-sprint` in de/es/fr/pt

### Fixed
- **i18n parity**: Updated workflow commands, rules, hooks across all 5 languages (de/en/es/fr/pt)
- **Flattener exports**: Exposed `DEFAULT_IGNORES`, `PRIORITY_EXTENSIONS`, constants for testing

---

## [5.9.2] - 2026-02-10

### Fixed
- **Shell hardening**: `set -euo pipefail` added to all 20 Ralph lib modules
- **Shell security**: Safe xargs (`-r`), allowlist env filtering, regex normalization in hook scripts
- **Shell security**: Shebang verification before `chmod +x`, `.npmignore` excludes runtime hooks
- **CLI quality**: Shared `cli/lib/colors.js` module, separated try/catch in `detectProject()`
- **CLI quality**: Fixed "GPT-4" → "Claude models", documented magic numbers in flattener
- **CLI quality**: Dynamic tech list in `--help` (all 11 technologies), fixed `CURRENT_VERSION` in migrate script
- **CI/CD**: Added `npm ci` + `npm run lint` to build job, `registry-url` in publish job
- **CI/CD**: Centralized VERSION via `get_claude_craft_version()` — no more hardcoded versions in install scripts
- **Docs**: Created `.markdownlint.json`, deleted orphan TRANSLATION_STATUS.md files
- **Docs**: Added i18n verification checklist to CONTRIBUTING.md

---

## [5.9.1] - 2026-02-10

### Added
- **CODE_OF_CONDUCT.md**: Contributor Covenant v2.1
- **SECURITY.md**: Security policy and vulnerability reporting

### Fixed
- README badges (npm, CI, license) added
- Removed 14 stale "What's New" sections from README, kept only v5.9
- Fixed command count `130+` → `157` and BMAD agent count `9` → `10` in README and `.bmad/README.md`
- Removed ghost commands `/bmad:init`, `/bmad:status` from README and `.bmad/README.md`
- Removed `/bmad:` namespace from command list
- Updated LICENSE copyright to 2024-2026
- Separated fixes from features in CHANGELOG v5.9.0 (`### Fixed` section)

---

## [5.9.0] - 2026-02-10

### Added
- **Claude Code 2.1.36 / 2.1.38 Compatibility**
  - **Fast Mode** (v2.1.36): `/fast` toggles up to 2.5x faster Opus 4.6 output
  - **Skills Directory Protection** (v2.1.38): Writes to `.claude/skills` blocked in sandbox

### Fixed
- **Heredoc Fix** (v2.1.38): No more "Bad substitution" with JS template literals
- **Plan Mode Crash Fix** (v2.1.38): Fixed crash when `~/.claude.json` missing fields
- **temperatureOverride Fix** (v2.1.38): No longer ignored in streaming API
- **LSP Compatibility** (v2.1.38): Fixed shutdown/exit with strict language servers
- **VSCode Fixes** (v2.1.38): Terminal scroll, Tab key, duplicate sessions
- **Text Rendering** (v2.1.38): Thai/Lao spacing, text between tool uses

### Changed
- Updated recommended Claude Code version from 2.1.34 to 2.1.38
- Updated VERSION in all 11 install scripts from 5.4.0 to 5.9.0

---

## [5.8.0] - 2026-02-07

### Fixed
- **Documentation Accuracy** — Fixed agent/command counts in documentation (40 agents, 157 commands)
- **BMAD Agent Cleanup** — Removed ghost menu blocks from all 10 BMAD agent YAMLs
- **Ghost Commands** — Removed ghost commands `/bmad:init`, `/bmad:status`
- **QA Commands** — Marked `/qa:recette-status`, `/qa:recette-regression`, `/qa:recette-report` as [PLANNED]

### Added
- **Documentation** — Added `/common:team-delivery` to documentation

### Changed
- **Command Harmonization** — Harmonized 8 check-compliance commands to unified delegation pattern
- **Command Merging**
  - Merged `sprint-bmad-status` → `sprint-status --bmad`
  - Merged `validate-backlog` → `gate-validate-backlog --no-gate`

### Deprecated
- **full-audit** → Use `team-audit --sequential` instead (removal in v6.0)
- **ralph-sprint** → Use `team-sprint --ralph-mode` instead (removal in v6.0)
- **workflow-orchestrator agent** → Deprecated (removal in v6.0)

---

## [5.7.0] - 2026-02-07

### Added
- **Agent Teams Integration** — 3 team templates, infrastructure scripts, cost framework
  - `/common:team-audit` — Parallel multi-technology audit (1 opus leader + N haiku auditors, max 4)
  - `/common:team-sprint` — Sprint Development Team (1 opus conductor + 2-3 sonnet devs)
  - `/common:team-security` — Security Review Team (1 opus lead + 3 haiku reviewers)
  - `Tools/AgentTeams/lib/result-aggregator.sh` — Merges isolated audit results
  - `Tools/AgentTeams/lib/compatibility-check.sh` — Validates agent-role compatibility
  - `Tools/AgentTeams/lib/ralph-teams-adapter.sh` — Abstraction layer with bash fallback
  - `Tools/AgentTeams/lib/cost-estimator.sh` — Token cost estimation (parallel vs sequential)
  - `Tools/AgentTeams/lib/cost-dashboard.sh` — Visual cost comparison before team launch
  - `docs/AGENT-TEAMS-GUIDE.md` — User guide for Agent Teams integration

### Changed
- `ralph-sprint.md` — Added `--use-teams` option for Agent Teams mode
- `ralph-conductor.md` — Added Agent Teams coordination mode
- `full-audit.md` — Added isolated output directories and result merge step
- `.claude/INDEX.md` — Added Agent Teams section

### Fixed
- **sprint-status.yaml race condition** — Single-writer pattern in `.bmad/lib/batch-executor.sh` and `Tools/Ralph/lib/parallel-manager.sh`

---

## [5.6.0] - 2026-02-06

### Changed
- **Claude Code 2.1.33 Compatibility**
  - **Agent Memory Frontmatter** (v2.1.33): Persistent `memory` field for agents with 3 scopes (user/project/local)
  - **TeammateIdle & TaskCompleted Hooks** (v2.1.33): New hook events for multi-agent coordination
  - **Agent Type Restrictions** (v2.1.33): `Task(agent_type)` syntax in tools frontmatter
  - **Plugin Name in Skills** (v2.1.33): Plugin name shown in /skills menu
  - **VSCode Remote Sessions** (v2.1.33): Browse/resume from claude.ai
  - **VSCode Session Picker** (v2.1.33): Git branch and message count display
  - **Improved API Errors** (v2.1.33): Specific error causes (ECONNREFUSED, SSL)
  - **Agent Teams Stability** (v2.1.33): tmux fix, plan warnings fix

### Added
- Added `memory: user` frontmatter to key agents (ralph-conductor, research-assistant, workflow-orchestrator)
- Documented TeammateIdle and TaskCompleted hook events in HOOKS.md (11 → 13 events)
- Documented agent type restrictions and memory frontmatter in AGENTS.md

### Upgraded
- Updated minimum Claude Code version from 2.1.32 to 2.1.34
- Updated recommendedClaudeCodeVersion to 2.1.34 in plugin.json

---

## [5.5.1] - 2026-02-06

### Fixed
- Harmonized agent counts from 34/35 to 40 across all documentation (13 Common + 10 Reviewers + 10 BMAD + 5 Docker + 2 Project)
- Fixed `recommendedClaudeCodeVersion` from 2.1.25 to 2.1.32 in plugin.json
- Added missing frontmatter: `model: opus` for ralph-conductor (EN/ES), `model: haiku` + tools for vuejs-reviewer and php-reviewer
- Added @workflow-orchestrator to Common agents, @csharp-reviewer/@php-reviewer to Technology Reviewers, Project Agents (2) section
- Translated 5 remaining French strings in INDEX.md to English
- Fixed `claude-projects.yaml` version from 5.3.0 to 5.5.0

## [5.5.0] - 2026-02-06

### Changed
- **Claude Code 2.1.32 Compatibility**
  - **Claude Opus 4.6** (v2.1.32): New flagship model - 200K context (1M beta), 128K output, adaptive thinking
  - **Agent Teams** (v2.1.32 Research Preview): Multi-agent coordination with Teammate/SendMessage tools
  - **Automatic Memory Recording** (v2.1.32): Auto-records session context for future use
  - **Summarize from Here** (v2.1.32): Partial conversation summarization
  - **Auto Skill Loading** (v2.1.32): Skills from --add-dir auto-discovered
  - **Skill Budget Scaling** (v2.1.32): Skill content scales to 2% of context window
  - **--resume Agent Inheritance** (v2.1.32): Auto-inherits --agent value
  - **VSCode Session Spinner** (v2.1.32): Loading spinner during session restore

### Upgraded
- All common agents upgraded from `model: sonnet` to `model: opus` (Opus 4.6)
- Settings templates updated to use `claude-opus-4-6` as default model

---

## [5.4.0] - 2026-02-03

### Added
- **Claude Code 2.1.31 Compatibility** - Documentation update for latest Claude Code features
  - **PDF Page Range** (v2.1.30): `pages` parameter for Read tool, lightweight reference for large PDFs
  - **OAuth Client Credentials for MCP** (v2.1.30): `--client-id` / `--client-secret` flags for `claude mcp add`
  - **/debug Command** (v2.1.30): Session-specific troubleshooting (complements `/doctor`)
  - **Task Tool Metrics** (v2.1.30): Token count, tool uses, duration in Task results
  - **Reduced Motion Mode** (v2.1.30): `reducedMotion: true` setting to minimize animations
  - **Session Resume Hint** (v2.1.31): Resume hint displayed on exit
  - **PDF Limits Clarification** (v2.1.31): Error messages show actual limits (100 pages, 20MB)
  - **Enhanced File Tools Preference** (v2.1.31): Improved system prompts for native tools usage
  - **Reduced Layout Jitter** (v2.1.31): Less terminal UI jitter during spinner
  - **Japanese IME Support** (v2.1.31): Full-width space input in checkbox selection
  - **Third-party Pricing Fix** (v2.1.31): Corrected pricing display for Bedrock/Vertex/Foundry
  - **PR Integration** (v2.1.27): `--from-pr` flag, auto-link sessions to PRs, status indicators
  - **spinnerVerbs** (v2.1.23): Customizable spinner text configuration in settings.json
  - **File Tools Preference** (v2.1.21): Claude prefers Read/Edit/Write over bash equivalents
  - **Task status `deleted`** (v2.1.20): Permanent task removal via TaskUpdate
  - **Background Agent Permissions** (v2.1.20): Permission prompts before agent launch
  - **VSCode Python venv** (v2.1.21): `claudeCode.usePythonEnvironment` setting

### Changed
- Updated all documentation to reference Claude Code 2.1.31
- Added Claude Code Compatibility section to `.claude/CLAUDE.md`
- Enhanced `.claude/INDEX.md` with quick reference for new features
- Updated training materials and cheatsheets

---

## [5.3.0] - 2026-01-31

### Added
- **QA Recette Fix** (`/qa:recette-fix`) - Automated bug fixing from recette sessions
  - 7-phase workflow: load → refine → group → BMAD docs → TDD fix → verify → report
  - Error refinement with severity matrix and root cause analysis
  - Smart grouping by root cause (deduplication)
  - BMAD bug story generation from template
  - TDD workflow (RED → GREEN → REFACTOR) per bug
  - `--dry-run`, `--skip-fix`, `--severity`, `--auto-commit` flags
  - fix-state.yaml for progress tracking
  - Bug story template in 5 languages (fr, en, es, de, pt)

## [5.2.1] - 2026-01-30

### Fixed
- **install-from-config.sh**: Added missing technology mappings (angular, csharp, laravel, vuejs, php) in `get_install_script()`
- **install-from-config.sh**: Docker tech now correctly routes to `Infra/install-infra-rules.sh` instead of being skipped
- **install-from-config.sh**: Script options (`--install`, `--force`, `--preserve-config`, `--skip-common`) are now adapted per technology script capabilities
- **install-common-rules.sh**: Fixed `install_claude_md()` crash when markdown files lack `description:` frontmatter (grep exit code 1 with `set -e`)

### Changed
- **claude-projects.yaml**: Added Docker module to all SaaS projects (kapitain, CareLink, Joina, SkillProof) for consistent infrastructure tooling across all projects

## [5.2.0] - 2026-01-30

### Added
- **Claude Code 2.1.25 Optimization** - Full leverage of Claude Code advanced features
  - **New Hooks**:
    - `PostToolUseFailure`: Automatic recovery context after tool failures
    - `PreCompact`: Backup sprint state before memory compaction
    - `SessionEnd`: Collect session metrics, cleanup logs, generate daily summaries
  - **Agent YAML Frontmatter** (~100 agents across 5 languages):
    - `model`: haiku for reviewers/auditors, sonnet for engineers/architects
    - `tools`: Explicit tool whitelist per agent role
    - `disallowedTools`: Security restrictions (no Write/Edit for reviewers)
    - `skills`: Preloaded skill context (solid-principles, testing, security)
  - **Skills Frontmatter Enhancement**:
    - `allowed-tools`: Tool restrictions per skill
    - `model`: Cost optimization (haiku for simple skills)
    - Enhanced `triggers`: file patterns + keywords
  - **Plugin Manifest** (`.claude-plugin/plugin.json`):
    - Full plugin metadata for marketplace distribution
    - Capabilities declaration (skills, agents, hooks, mcp)
    - Technology stack listing
  - **Settings Enhancement**:
    - `plansDirectory: .claude/plans` for organized plans
    - Extended permissions (npm, pnpm, yarn, php, flutter, ng, dotnet)
    - Extended deny rules (chmod 777, curl|sh, credentials)

### Changed
- Claude Code feature utilization: ~40% → ~75%
- Hook coverage: 5/13 → 9/13 events
- Agent configuration: Added formal YAML frontmatter to all agents
- Skills configuration: Added tool restrictions and model selection

### Technical Details
- Hook scripts use jq for JSON parsing
- Backup rotation: keeps last 10 backups
- Log retention: 7 days for logs, 30 days for metrics
- Session metrics in `.claude/metrics/session-YYYYMMDD.json`

---

## [5.1.0] - 2026-01-30

### Added
- **QA Recette** - Automated Acceptance Testing with Claude in Chrome
  - `/qa:recette` command for browser-based acceptance tests
  - `/qa:recette-status` to view session progress
  - `/qa:recette-regression` to run regression tests only
  - `@qa-recette` agent for QA automation expertise
  - **Golden Rule Enforcement**: Fixed bugs never reappear
  - **Session Recovery**: Resume interrupted tests with checkpoints
  - **Auto Test Generation**: Unit, Functional, Behat tests from errors
  - **Regression Detection**: Compare historical runs
  - **6 Test Categories**: AC validation, edge cases, errors, UI/UX, performance, security
  - **Error Classification**: visual, interaction, validation, logic, security, API
  - **Chrome MCP Integration**: navigate, click, type, screenshot, record_gif
- **Recette Library** (`Tools/Recette/lib/`)
  - `chrome-check.sh`: MCP Chrome verification
  - `session.sh`: Session management with checkpoints
  - `plan-generator.sh`: Test plan from acceptance criteria
  - `browser-executor.sh`: Chrome automation execution
  - `test-generator.sh`: Regression test generation
  - `regression-detector.sh`: Historical comparison
  - `report-generator.sh`: MD/HTML/JSON reports
- **Templates** (`Tools/Recette/templates/`)
  - `unit-test.php.template`: PHPUnit template
  - `functional-test.php.template`: Symfony WebTestCase
  - `feature.feature.template`: Behat scenarios
  - `report.md.template`: Report template
- **i18n**: Full translation for en, fr, es, de, pt
- **Documentation**: Updated CLAUDE.md, INDEX.md, COMMANDS.md, AGENTS.md

### Changed
- Agent count: 34 → 35 (qa-recette added)
- Command count: 127+ → 130+ (3 QA commands added)

## [5.0.0] - 2026-01-30

### Added
- **Autonomous Sprint Conductor (ASC)** - Run entire sprints overnight with minimal human intervention
  - `/common:ralph-sprint` command for overnight/unattended sprint execution
  - `--overnight` mode: Bounded execution with stop window at 6am
  - `--parallel N` mode: Process up to N stories concurrently
  - `--supervised` mode: Confirm each story before processing
  - `--max-stories N` and `--timeout H` options for limits
- **Recovery Engine** (`Tools/Ralph/lib/recovery-engine.sh`)
  - 4-level error classification: Transient, Recoverable, Degraded, Blocked
  - Auto-retry with exponential backoff for transient errors
  - Auto-fix strategies: lint fix, TDD retry, dependency install
  - Recovery logging and metrics
- **Escalation Service** (`Tools/Ralph/lib/escalation-service.sh`)
  - Queue management for blocking issues
  - Webhook notifications: Slack, Teams, Discord, generic
  - Configurable timeout with default actions (skip, proceed, retry, abort)
  - Audit trail in `.ralph/escalations/audit.jsonl`
- **Parallel Manager** (`Tools/Ralph/lib/parallel-manager.sh`)
  - Dependency graph building from stories
  - Multi-session spawning with isolation
  - Resource monitoring (CPU, memory limits)
  - Result aggregation
- **Sprint Conductor** (`Tools/Ralph/lib/sprint-conductor.sh`)
  - Main orchestrator for autonomous sprint execution
  - Auto-claim, progress tracking, transitions
  - Stop conditions: max stories, consecutive failures, runtime, time window
- **Autonomous Circuit Breaker Profile**
  - New `autonomous` profile with recovery_enabled
  - `check_circuit_breaker_with_recovery()` function
  - Integration with recovery engine before trip
- **BMAD Autonomous Mode**
  - `routing-engine.sh`: enable-autonomous, auto-claim, tdd-phase, tests-status commands
  - `batch-executor.sh`: autonomous mode with Ralph integration
  - Auto-transition based on TDD phase and test status
- **Configuration** (`Tools/Ralph/config/ralph-autonomous.yml`)
  - Complete autonomous mode configuration template
  - Schedule, limits, parallel, recovery, escalation settings
- **Documentation**
  - `docs/AUTONOMOUS-SPRINT.md`: Complete ASC guide
  - `docs/AGENTS.md`: Agent behavior in autonomous mode section
  - `docs/CLI-REFERENCE.md`: Full ASC CLI options documentation
  - `.claude/INDEX.md`: ASC quick reference section
  - `Tools/Ralph/docs/RECOVERY.md`: Recovery engine documentation
  - `Tools/Ralph/docs/PARALLEL.md`: Parallel processing documentation
  - `.bmad/docs/AUTONOMOUS.md`: BMAD autonomous mode documentation
  - Updated FAQ, TROUBLESHOOTING, COMMANDS docs
- **i18n** - `/common:ralph-sprint` command in 5 languages (en, fr, es, de, pt)

### Changed
- Ralph version: 2.0.0 → 3.0.0
- Ralph loads 4 new modules: recovery-engine, escalation-service, parallel-manager, sprint-conductor
- Ralph main script now supports: `--autonomous`, `--story=<id>`, `--sprint`, `--overnight`, `--parallel=<n>`
- Circuit breaker now includes recovery integration for autonomous profile
- `.claude/CLAUDE.md` updated with ASC section

### Technical Details
- New files: 6 shell modules (recovery-engine.sh, escalation-service.sh, parallel-manager.sh, sprint-conductor.sh, config/ralph-autonomous.yml)
- Updated files: ralph.sh, circuit-breaker.sh, batch-executor.sh, routing-engine.sh
- New command files: 5 (ralph-sprint.md in en/fr/es/de/pt)
- Documentation updates: README.md, CHANGELOG.md, docs/COMMANDS.md, docs/FAQ.md, docs/TROUBLESHOOTING.md, docs/AUTONOMOUS-SPRINT.md, .claude/CLAUDE.md, .bmad/README.md, Tools/Ralph/README.md

## [4.4.0] - 2026-01-29

### Added
- **Comprehensive Documentation for Junior Developers**
  - `docs/QUICKSTART.md`: 5-minute getting started guide
  - `docs/PREREQUISITES.md`: Complete dependency guide with OS-specific instructions
  - `docs/CLI-REFERENCE.md`: Full NPX CLI and Makefile documentation
  - `docs/FAQ.md`: 50+ frequently asked questions organized by category
  - `docs/TROUBLESHOOTING.md`: Common problems and solutions with diagnostic scripts
  - `docs/BMAD-PRACTICAL-GUIDE.md`: Practical guide for BMAD v6 framework
  - `docs/RALPH-GUIDE.md`: Ralph Wiggum configuration and DoD validators
  - `docs/MIGRATION-v4.md`: v3.x to v4.x migration guide
  - `docs/COMMANDS-FULL-REFERENCE.md`: All 127+ commands documented
  - `docs/AGENTS-FULL-REFERENCE.md`: All 40 agents documented
  - `docs/SCRIPTS-REFERENCE.md`: Installation scripts reference
  - `docs/MAKEFILE-REFERENCE.md`: All Makefile targets documented
  - `docs/ARCHITECTURE.md`: Internal architecture with diagrams (TCL, BMAD, Ralph)
- **Complete Workflow Guides** in 5 languages (en, fr, es, de, pt)
  - `docs/guides/*/10-complete-workflow.md`: Idea → Production workflow
- **Example Projects**
  - `docs/examples/symfony-api/`: Complete REST API example
  - `docs/examples/flutter-app/`: Mobile application example
  - `docs/examples/fullstack-saas/`: Full SaaS with Symfony + Flutter
- **Translations** for key documents (fr, es, de, pt)
  - QUICKSTART, PREREQUISITES, CLI-REFERENCE, FAQ, TROUBLESHOOTING
- **Prerequisites Check Script**
  - `Dev/scripts/check-prerequisites.sh`: Verify all Claude Craft dependencies
  - Supports `--verbose` and `--fix` options

### Changed
- `.claude/CLAUDE.md` expanded from 37 to 285 lines with all 10 technologies
- `CONTRIBUTING.md` enhanced with dev setup and release checklist
- All install scripts updated to version 4.4.0

## [4.3.0] - 2026-01-29

### Added
- **Complete i18n Support for BMAD v6 Commands**
  - Spanish (ES): 18 BMAD v6 commands translated
  - German (DE): 18 BMAD v6 commands translated
  - Portuguese (PT): 18 BMAD v6 commands translated
  - French (FR): 12 missing BMAD v6 commands completed
- **Dev/i18n Translations Completed**
  - `Common/commands/sub-agents-patterns.md` (FR, ES, DE, PT)
  - `Common/templates/mcp.json.template` (FR, ES, DE, PT)
  - `Python/rules/08-quality-tools.md` (FR, ES, DE, PT)
  - `Python/rules/11-security-python.md` (FR, ES, DE, PT)
  - `Flutter/rules/07-testing-flutter.md` (PT)
  - `Flutter/skills/testing-flutter/SKILL.md` (PT)

### Fixed
- Project commands now included in `make install-all` target
- Added "project" as valid technology in `install-from-config.sh`
- Added `--skip-common` flag support in `install-project-commands.sh`

### Changed
- All install scripts version updated: 4.0.1 → 4.3.0
- Project install script version: 2.0.0 → 2.1.0
- Dev/i18n file count now equal across all 5 languages (~346 files each)

## [4.2.0] - 2026-01-29

### Added
- **BMAD v6 Framework** - Complete project management enhancement
  - **9 Agent-as-Code Definitions** (`Project/agents/`)
    - `bmad-master`: Central orchestrator for BMAD methodology
    - `pm`: Product Manager (PRD, vision, roadmap, prioritization)
    - `ba`: Business Analyst (requirements, use cases, story mapping)
    - `architect`: System Architect (tech specs, ADRs, API design)
    - `po`: Product Owner (backlog management, acceptance)
    - `sm`: Scrum Master (ceremonies, velocity, impediments)
    - `dev`: Developer (TDD implementation, refactoring)
    - `qa`: QA Engineer (test strategy, validation)
    - `ux`: UX Designer (wireframes, journeys, accessibility)
  - **Status-based Routing** (`.bmad/lib/routing-engine.sh`)
    - State machine: backlog → ready-for-dev → in-progress → review → done
    - Automatic transitions based on task completion
    - History tracking for all status changes
    - Support for blocked state from any status
  - **5 Quality Gates** (`.bmad/gates/`)
    - PRD Gate (≥80%): Problem, users, goals, metrics, scope validation
    - Tech Spec Gate (≥90%): Architecture, security, testing, deployment
    - Backlog Gate: Full INVEST compliance (6/6 criteria)
    - Sprint Ready Gate: Metadata, goal, stories ready validation
    - Story DoD Gate: Tasks, tests, AC, review, no blockers
  - **Claude Code Hooks** (`.bmad/hooks/`)
    - `sprint-context.sh` (SessionStart): Inject sprint context at session start
    - `story-status.sh` (PreToolUse, once:true): Inject current story status
    - `quality-gate.sh` (Stop): Validate quality gates before completion (exit 2 blocks)
  - **Batch Processing** (`.bmad/lib/batch-executor.sh`)
    - Queue management for epic/sprint execution
    - Sequential and parallel execution modes
    - Checkpointing for resume on failure
    - Dependency-aware processing
  - **YAML Configuration Files**
    - `sprint-status.yaml`: Sprint state tracking with routing rules
    - `batch-queue.yaml`: Batch processing queue management

- **20+ New Commands**
  - Sprint Management:
    - `/sprint:bmad-status`: Display sprint status with routing info
    - `/sprint:next-story`: Get next story ready for development
    - `/sprint:transition <ID> <status>`: Transition story status
    - `/sprint:auto-route`: Execute automatic routing rules
  - Quality Gates:
    - `/gate:validate-prd [file]`: Validate PRD (≥80%)
    - `/gate:validate-techspec [file]`: Validate Tech Spec (≥90%)
    - `/gate:validate-backlog [story-id]`: Validate INVEST compliance
    - `/gate:validate-story <story-id>`: Validate story DoD
    - `/gate:validate-sprint`: Validate sprint readiness
    - `/gate:report`: Comprehensive quality gates report
  - Backlog Migration:
    - `/project:analyze-backlog`: Analyze current backlog structure
    - `/project:migrate-backlog`: Convert to BMAD v6 format
    - `/project:update-stories`: Add missing BMAD fields
    - `/project:sync-backlog`: Bidirectional sync files ↔ YAML
  - Batch Processing:
    - `/project:run-epic <epic-id>`: Queue all stories from an epic
    - `/project:run-queue`: Process batch queue
    - `/project:run-sprint`: Execute full sprint
    - `/project:batch-status`: View queue status

- **3 New Templates** (`Project/templates/`)
  - `sprint-status.yaml.template`: Sprint tracking template
  - `batch-queue.yaml.template`: Batch queue configuration
  - `agent.yaml.template`: Agent-as-Code template

- **French Translations** for all new BMAD commands
  - `analyze-backlog.md`, `migrate-backlog.md`
  - `sprint-bmad-status.md`
  - `gate-validate-prd.md`, `gate-validate-backlog.md`, `gate-report.md`

- **TDD Phase Tracking**
  - Stories track TDD phase: red → green → refactor
  - Automatic phase guidance in hooks
  - Phase validation in Story DoD gate

### Changed
- Agent count: 25 → 34 (9 BMAD agents added)
- Command count: 90+ → 110+ (20+ BMAD commands added)
- Template count: 30 → 33 (3 BMAD templates added)
- README.md updated with BMAD v6 documentation
- docs/AGENTS.md updated with BMAD agents section
- docs/COMMANDS.md updated with BMAD commands section

## [4.1.0] - 2026-01-29

### Added
- **Ralph Wiggum v2.0** - Major upgrade to continuous AI agent loop
  - **Claude Code 2.1.23+ Hooks Integration** - Bidirectional communication
    - `SessionStart` hook injects Ralph context
    - `PreToolUse` hook (once:true) injects DoD status
    - `Stop` hook gates on DoD satisfaction (exit code 2 blocks)
  - **Auto-Detection** - Intelligent project type detection
    - Supports: Symfony, Laravel, Flutter, React, Vue, Angular, Next.js, .NET, Python, Go, Rust
    - Confidence levels (HIGH/MEDIUM) for detection accuracy
  - **Observability** - Real-time monitoring
    - Terminal dashboard with progress bar, circuit breaker status, context usage
    - Metrics export in JSON and Prometheus formats
    - Health monitoring (stall detection, error spiral, context bloat)
  - **Adaptive Circuit Breaker** - Profile-based thresholds
    - 5 profiles: `quick_fix`, `small_feature`, `medium_feature`, `large_feature`, `exploration`
    - Auto-detection from prompt keywords
    - Learning mode with historical adjustment
  - **DoD Templates** - Pre-configured for 8 technologies
    - Symfony (PHPUnit + PHPStan), Flutter (flutter_test + flutter_lints)
    - React (Jest/Vitest + ESLint), Python (pytest + ruff)
    - .NET (xUnit + Analyzers), Go (go test + golangci-lint), Rust (cargo test + clippy)
- New CLI flags: `--auto-detect`, `--init`, `--interactive`
- New modules: `metrics-exporter.sh`, `project-detector.sh`, `dod-templates.sh`, `config-generator.sh`, `dashboard.sh`, `health-monitor.sh`, `hooks-generator.sh`
- Hook scripts: `session-restore.sh`, `status-injector.sh`, `pre-tool-context.sh`, `stop-dod-gate.sh`

### Changed
- Ralph version bumped from 1.1.0 to 2.0.0
- `ralph.yml.template` updated with v2.0 configuration sections
- i18n messages updated for all 5 languages with v2.0 strings

## [4.0.3] - 2026-01-29

### Fixed
- CLI now reads version dynamically from package.json instead of hardcoded value
- Added `--version` and `-v` flags to CLI

## [4.0.2] - 2026-01-29

### Fixed
- Installation scripts now include 2026 feature references (json-streamer, object-mapper, wasm, mcp-integration, etc.)
- Aligned installation script versions with package version

## [4.0.1] - 2026-01-29

### Changed
- Updated to Claude Code 2.1.23 best practices
- Added `Setup` hook event documentation (for `--init`, `--init-only`, `--maintenance`)
- Added `once: true` hook configuration option
- Added `additionalContext` PreToolUse output field
- Added `spinnerVerbs` setting in templates
- Updated hook events from 10 to 11 (added Setup)

## [4.0.0] - 2026-01-29

### Added
- **2026 Best Practices Update** for all major frameworks
- `.claude/` directory now tracked in version control
- Sub-CLAUDE.md quick reference files per technology
  - `symfony/CLAUDE.md` - Symfony 8 quick reference
  - `flutter/CLAUDE.md` - Flutter 3.38 quick reference
- **Symfony 8.0 / PHP 8.5** documentation
  - `json-streamer.md` - JSON Streamer Component
  - `object-mapper.md` - ObjectMapper Component
  - `service-container-2026.md` - Container 2026 features
- **Flutter 3.38 / Dart 3.10** documentation
  - `wasm.md` - WebAssembly compilation
  - `mcp-integration.md` - Model Context Protocol
  - `web-performance-2026.md` - Web optimization
- `/common:init` command for bootstrapping new projects
- Technology Quick Links in INDEX.md

### Changed
- **PHP**: 8.4 → 8.5 (pipe operator, lazy objects)
- **Symfony**: 6.4 → 8.0 (JSON Streamer, ObjectMapper)
- **.NET**: 9 → 10 LTS
- **C#**: 13 → 14 (Extension Members, Null-Conditional Assignment)
- **Flutter**: 3.x → 3.38+ (WebAssembly, MCP)
- **Dart**: 3.x → 3.10+ (dot shorthands)
- **Rector**: 1.x → 2.3.x
- **Deptrac**: v1 → v4
- **PHPStan**: → 2.1.x
- `.gitignore` updated to track `.claude/` (except settings.local.json)
- CLAUDE.md updated to multi-technology framework format

### Improved
- Conformity score: 5.8/10 → 9/10
- Complete 2026 tooling stack documentation

## [3.6.0] - 2026-01-29

### Added
- **TCL (Tiered Context Loading)** extended to ALL 10 technologies
  - Python, React, Angular, Vue.js, Flutter, React Native
  - Symfony, Laravel, PHP, C#/.NET
- `.claude/references/{tech}/` structure for on-demand rule loading
- `INDEX.md` quick reference summaries for each technology
- `context.yaml` file-based contextual triggers
- `tcl-common.sh` shared functions for TCL installation scripts
- Templates: `CLAUDE.md.template`, `INDEX.md.template`, `context.yaml.template`

### Changed
- All installation scripts updated to TCL architecture (v3.5.0+)
- Rules renamed without numeric prefixes (e.g., `architecture.md` instead of `02-architecture.md`)
- CLAUDE.md reduced to ~200 tokens (previously ~70,000)
- Project context moved to `references/{tech}/project-context.md`

### Improved
- ~95% token reduction in auto-loaded context
- Fewer context compactions during long sessions
- Full rules still accessible via `@.claude/references/`

## [3.5.1] - 2026-01-23

### Fixed
- Nested code blocks in markdown templates now use 4 backticks
  - Fixes Claude misinterpreting nested gherkin/mermaid/bash/php/dart blocks
  - Updated 10 files across 5 languages (en, fr, de, es, pt)
  - Affected: generate-backlog.md, decompose-tasks.md

## [3.5.0] - 2026-01-22

### Changed
- **Token Optimization**: ~200K tokens saved (~19% reduction)
  - Deleted 249 REFERENCE.md duplicate files from skills directories
  - Removed 15 duplicate *-examples.md files from templates directories
  - SKILL.md files now reference rules/ directly via relative path
- Updated migrate-project.sh to no longer create REFERENCE.md files

### Improved
- Skills architecture: single source of truth (rules/) instead of duplicated content
- Reduced installed project size significantly

## [3.4.0] - 2026-01-22

### Added
- WHAT/WHY/HOW format for all CLAUDE.md templates
- Hooks support (PreToolUse, PostToolUse, Stop) in settings.json.template
- MCP configuration template (context7, filesystem, github)
- Sub-agents documentation (Explore, General-purpose, Plan)
- Wildcard permissions syntax in settings

### Changed
- Restructured all CLAUDE.md templates (55 total: 11 per language x 5 languages)
- Reduced template sizes from 239-544 lines to 79-110 lines
- Updated to Claude Code 2.1.23 best practices

### Improved
- Context usage optimization for Claude
- Consistent structure across all 5 languages (EN, FR, ES, DE, PT)

## [3.3.3] - 2026-01-16

### Fixed
- Ralph auto-compact: disable `compact_on_task_complete` by default

## [3.3.2] - 2026-01-15

### Changed
- Ralph auto-compact: increase `preventive_threshold` from 90% to 95%
- Ralph auto-compact: increase `max_compacts` from 3 to 5
- Ralph auto-compact: add `min_threshold` (default 50%) to skip compact when context is low

### Fixed
- Exclude `add-technology` command from project installations (internal only)

## [3.3.1] - 2026-01-14

### Fixed
- Sync package.json version with git tag for proper npm publishing

## [3.3.0] - 2026-01-14

### Changed
- Bump Ralph version to 1.1.0

## [3.2.0] - 2026-01-13

### Added
- 4 new technology stacks: Angular, C#/.NET, Laravel, Vue.js
- `/common:add-technology` command for generating new tech stacks

## [3.1.2] - 2026-01-13

### Changed
- Updated docs/index.html to showcase v3.0/v3.1 features
- Stats updated: 25 agents, 90+ commands
- Features grid: 4 → 6 cards (3-column layout)

## [3.1.1] - 2026-01-13

### Added
- Documentation for Ralph Wiggum feature

## [3.1.0] - 2026-01-13

### Added
- Ralph Wiggum continuous AI agent loop integration
- Definition of Done (DoD) structured validation system
- Circuit breaker safety mechanism
- Git checkpointing for recovery
- `/common:ralph-run` command (5 languages)
- `@ralph-conductor` agent (5 languages)
- CLI: `npx @the-bearded-bear/claude-craft ralph`

## [3.0.3] - 2026-01-13

### Added
- `/common:setup-project-context` command for interactive project configuration
  - Auto-detects tech stack, framework, database, CI/CD
  - Three modes: default, --auto (minimal), --full (comprehensive)
  - Generates complete `.claude/rules/00-project-context.md`

### Changed
- Updated all setup guides to reference the new command
- Added Configuration Commands section to COMMANDS.md

## [3.0.2] - 2026-01-12

### Added
- Installation tutorials for new and existing projects (10 files)
  - `08-setup-new-project.md`: Installation on brand new projects
  - `09-setup-existing-project.md`: Adding Claude-Craft to existing codebases
- Available in 5 languages (EN, FR, ES, DE, PT)

## [3.0.1] - 2026-01-12

### Fixed
- Version bump (3.0.0 was already published manually during initial setup)

## [3.0.0] - 2026-01-12

### Added
- OIDC trusted publishing for npm
- Node 24 support (npm 11.5.1+)

### Changed
- Pure OIDC authentication without token fallback
- Removed NODE_AUTH_TOKEN interference

### Security
- Enhanced npm publishing security via OIDC

[5.5.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.5.0...v5.5.1
[5.5.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.4.0...v5.5.0
[5.4.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.3.0...v5.4.0
[5.3.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.2.1...v5.3.0
[5.2.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.2.0...v5.2.1
[5.2.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.1.0...v5.2.0
[5.1.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v5.0.0...v5.1.0
[5.0.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.4.0...v5.0.0
[4.4.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.3.0...v4.4.0
[4.3.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.2.0...v4.3.0
[4.2.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.1.0...v4.2.0
[4.1.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.0.3...v4.1.0
[4.0.3]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.0.2...v4.0.3
[4.0.2]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.0.1...v4.0.2
[4.0.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v4.0.0...v4.0.1
[4.0.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.6.0...v4.0.0
[3.6.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.5.1...v3.6.0
[3.5.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.5.0...v3.5.1
[3.5.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.4.0...v3.5.0
[3.4.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.3.3...v3.4.0
[3.3.3]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.3.2...v3.3.3
[3.3.2]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.3.1...v3.3.2
[3.3.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.3.0...v3.3.1
[3.3.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.2.0...v3.3.0
[3.2.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.1.2...v3.2.0
[3.1.2]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.1.1...v3.1.2
[3.1.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.1.0...v3.1.1
[3.1.0]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.0.3...v3.1.0
[3.0.3]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.0.2...v3.0.3
[3.0.2]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.0.1...v3.0.2
[3.0.1]: https://github.com/TheBeardedBearSAS/claude-craft/compare/v3.0.0...v3.0.1
[3.0.0]: https://github.com/TheBeardedBearSAS/claude-craft/releases/tag/v3.0.0
