@the-bearded-bear/claude-craft 7.17.1 → 7.18.0-next.c3e3337

package/README.md

@@ -6,596 +6,193 @@
 
 A comprehensive framework for AI-assisted development with [Claude Code](https://claude.ai/code). Install standardized rules, agents, and commands for your projects across multiple technology stacks.
 
-## What's New in v7.17
+## What's New in v7.18
 
-- **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). Gives Claude structural code intelligence — automatic diagnostics, go-to-definition, find references, and type info on hover
+- **Differentiated reviewer agents** -- Tier 1 reviewers (React, Symfony, Python, Flutter) rewritten with deep tech-specific decision trees and upgraded to sonnet
+- **Technology tier system** -- formalized core/supported/community tiers with upgrade paths
+- **Simplified onboarding** -- README cut from 611 to 205 lines, QUICKSTART rewritten as a 10-minute journey
 - See [CHANGELOG](CHANGELOG.md) for full details
 
-> See [CHANGELOG.md](CHANGELOG.md) for previous versions.
-
-## Features
-
-- **10 Technology Stacks**: Symfony, Flutter, Python, React, React Native, Angular, C#/.NET, Laravel, Vue.js, PHP
-- **Infrastructure Stack**: Docker and Coolify agents and commands
-- **5 Languages**: English, French, Spanish, German, Portuguese
-- **33 AI Agents**: Specialized reviewers, architects, coaches, UI/UX, Docker, Coolify experts, and Ralph Conductor
-- **160 Slash Commands**: Automated workflows, code generation, **sprint management, quality gates, batch processing, acceptance testing**
-- **BMAD v6 Framework**: Complete project management with status-based routing, quality gates, and batch execution
-- **Ralph Wiggum**: Continuous loop execution with Definition of Done validation
-- **37 Skills**: Best practices in official Claude Code format (architecture, testing, security)
-- **21 Templates**: Code generation patterns + BMAD templates
-- **10 Checklists**: Quality gates for commits, features, releases
-- **Hooks System**: Pre/Post tool execution, quality gates, notifications, **BMAD context injection**
-- **MCP Templates**: Context7, GitHub, PostgreSQL, Slack integration
-- **Auto-generated CLAUDE.md**: Project configuration file created at installation
-- **Multi-Account Manager**: Manage multiple Claude Code accounts easily
-- **Custom Status Line**: Rich status bar with profile, model, git, context %
-
-## Workflow Methodology
-
-Claude-Craft includes a BMAD-inspired workflow system that adapts to your project complexity.
-
-### Development Tracks
-
-| Track | Setup Time | Phases | Best For |
-|-------|------------|--------|----------|
-| **Quick Flow** | < 5 min | Implementation only | Bug fixes, hotfixes, small tweaks |
-| **Standard** | < 15 min | Plan → Design → Implement | New features, refactoring |
-| **Enterprise** | < 30 min | Analyze → Plan → Design → Implement | Platforms, migrations, multi-team |
-
-### Getting Started with Workflows
+## Install and First Result
 
 ```bash
-# Initialize workflow - auto-detects complexity
-/workflow:init
-
-# Or specify track
-/workflow:init --quick      # Bug fix mode
-/workflow:init --enterprise # Full methodology
-
-# Check progress
-/workflow:status
-```
-
-### Workflow Commands
-
-| Command | Phase | Purpose |
-|---------|-------|---------|
-| `/workflow:init` | Setup | Analyze project, recommend track |
-| `/workflow:analyze` | Analysis | Research and exploration (Enterprise) |
-| `/workflow:plan` | Planning | Generate PRD, personas, backlog |
-| `/workflow:design` | Design | Tech spec, architecture, ADRs |
-| `/workflow:implement` | Implementation | Sprint development with TDD/BDD |
-| `/workflow:status` | Any | Show current progress |
-
-### Document Generation
+# Install to your project (picks your tech stack interactively)
+npx @the-bearded-bear/claude-craft
 
-```bash
-# Generate Product Requirements Document
-/project:generate-prd
+# Or install directly
+npx @the-bearded-bear/claude-craft install ~/my-project --tech=react --lang=en
 
-# Generate Technical Specification
-/project:generate-tech-spec
+# Open Claude Code and run your first audit
+claude
+/team:audit
 ```
 
-## BMAD v6 Project Management
-
-BMAD v6 (Build, Measure, Analyze, Deliver) extends the workflow system with comprehensive project management.
-
-### BMAD Roles
-
-BMAD roles (bmad-master, pm, ba, architect, po, sm, dev, qa, qa-recette, ux) are integrated into workflow and sprint commands as personas, not standalone agent files.
-
-### Status-based Routing
-
-Stories automatically transition through a state machine:
+That's it. You get an architecture, security, and quality audit of your project in minutes.
 
-```
-backlog → ready-for-dev → in-progress → review → done
-   ↓          ↓              ↓           ↓
-   └──────────┴──────────────┴───────────┴→ blocked
-```
+> See [Quickstart](docs/QUICKSTART.md) for a step-by-step walkthrough with expected output at each stage.
 
-```bash
-# View sprint status with routing info
-/sprint:status --bmad
+## Why Claude Craft?
 
-# Get next story ready for development
-/sprint:next-story --claim
+Claude Code is powerful on its own. Claude Craft makes it **consistent and team-ready**:
 
-# Transition story status
-/sprint:transition US-005 review
+- **Standardized rules** -- SOLID, Clean Architecture, TDD enforced across your team, not just suggested
+- **33 specialized agents** -- reviewers, architects, coaches that know your stack deeply
+- **160 slash commands** -- repeatable workflows for audits, code generation, sprint management
+- **Quality gates** -- automated checks at every stage from PRD to deployment
+- **5 languages** -- English, French, Spanish, German, Portuguese
 
-# Run automatic routing rules
-/sprint:auto-route
-```
+## Supported Technologies
 
-### 5 Quality Gates
+| Stack | Version | Install Command |
+|-------|---------|-----------------|
+| **Symfony / PHP** | 8.0 / PHP 8.5 | `--tech=symfony` |
+| **React** | 19.x | `--tech=react` |
+| **Flutter / Dart** | 3.38 / Dart 3.10 | `--tech=flutter` |
+| **Python** | 3.13+ / FastAPI | `--tech=python` |
+| **Angular** | 19.x | `--tech=angular` |
+| **Vue.js** | 3.5+ | `--tech=vuejs` |
+| **React Native** | 0.76+ | `--tech=reactnative` |
+| **C# / .NET** | 10 LTS / C# 14 | `--tech=csharp` |
+| **Laravel** | 12.x / PHP 8.5 | `--tech=laravel` |
+| **PHP** | 8.5 | `--tech=php` |
 
-| Gate | Threshold | When |
-|------|-----------|------|
-| **PRD Gate** | ≥80% | Vision → PRD |
-| **Tech Spec Gate** | ≥90% | PRD → Tech Spec |
-| **Backlog Gate** | INVEST 6/6 | Tech Spec → Backlog |
-| **Sprint Ready** | 100% | Backlog → Sprint |
-| **Story DoD** | 100% | Dev → Done |
+Infrastructure stacks (Docker, Coolify) are also available. See [Technologies](docs/TECHNOLOGIES.md) for full details.
 
-```bash
-# Validate PRD quality
-/gate:validate-prd docs/prd.md
+## What's Included
 
-# Check INVEST compliance
-/gate:validate-backlog
+| Category | Count | Examples |
+|----------|-------|---------|
+| **Agents** | 33 | `@tdd-coach`, `@api-designer`, `@symfony-reviewer`, `@docker-architect` |
+| **Commands** | 160 | `/workflow:init`, `/team:audit`, `/react:generate-component` |
+| **Skills** | 37 | Architecture, testing, security best practices |
+| **Templates** | 21 | Code generation patterns, BMAD project templates |
+| **Checklists** | 10 | Commit, feature, release quality gates |
 
-# Verify story meets Definition of Done
-/gate:validate-story US-005
+See [Agents](docs/AGENTS.md) | [Commands](docs/COMMANDS.md) | [Skills](docs/SKILLS.md)
 
-# Full gates report
-/gate:report
-```
+## Workflow Tracks
 
-### Batch Processing
+Claude Craft adapts to your project complexity with three development tracks:
 
-Process multiple stories automatically:
+| Track | Setup | Phases | Best For |
+|-------|-------|--------|----------|
+| **Quick Flow** | < 5 min | Implementation only | Bug fixes, hotfixes |
+| **Standard** | < 15 min | Plan > Design > Implement | New features, refactoring |
+| **Enterprise** | < 30 min | Analyze > Plan > Design > Implement | Platforms, migrations |
 
 ```bash
-# Queue all stories from an epic
-/project:run-epic EPIC-002
-
-# Process the queue
-/project:run-queue --parallel 3
-
-# Execute full sprint
-/project:run-sprint --auto
-
-# Check batch status
-/project:batch-status
+/workflow:init              # Auto-detects complexity
+/workflow:init --quick      # Bug fix mode
+/workflow:init --enterprise # Full methodology
 ```
 
-### Backlog Migration
+See [BMAD Practical Guide](docs/BMAD-PRACTICAL-GUIDE.md) for the complete project management framework.
 
-Convert existing backlogs to BMAD v6:
+## Key Commands
 
-```bash
-# Analyze current backlog structure
-/project:analyze-backlog
+These are the commands you'll use most:
 
-# Migrate to BMAD v6 format
-/project:migrate-backlog --dry-run
-/project:migrate-backlog
+| Command | What It Does |
+|---------|-------------|
+| `/workflow:init` | Start a development workflow (auto-detects track) |
+| `/team:audit` | Full project audit (architecture, security, quality) |
+| `/common:pre-commit-check` | Validate before committing |
+| `/sprint:next-story` | Get next story ready for development |
+| `/qa:tdd` | Test-Driven Development flow |
+| `/gate:validate-story` | Check story meets Definition of Done |
+| `/{tech}:check-architecture` | Verify architecture compliance |
+| `/{tech}:generate-*` | Generate code following project patterns |
+| `/common:ralph-run "task"` | Run Claude in continuous loop until task is done |
+| `/qa:recette` | Automated acceptance testing via Chrome |
 
-# Add missing fields to stories
-/project:update-stories
+See [CLI Reference](docs/CLI-REFERENCE.md) for all 160 commands across 20 namespaces.
 
-# Sync files with sprint-status.yaml
-/project:sync-backlog
-```
+## Installation
 
-### Claude Code Hooks Integration
-
-Enable BMAD hooks in `.claude/settings.json`:
-
-```json
-{
-  "hooks": {
-    "SessionStart": [{
-      "command": ".bmad/hooks/sprint-context.sh",
-      "timeout": 5000
-    }],
-    "PreToolUse": [{
-      "command": ".bmad/hooks/story-status.sh",
-      "once": true,
-      "timeout": 3000
-    }],
-    "Stop": [{
-      "command": ".bmad/hooks/quality-gate.sh",
-      "timeout": 10000
-    }]
-  }
-}
-```
-
-## Quick Start
-
-### Method 1: NPX (Recommended)
+### NPX (Recommended)
 
 ```bash
-# Interactive installation wizard
-npx @the-bearded-bear/claude-craft
-
-# Or install to specific directory
-npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=fr
+npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=en
 ```
 
-### Method 2: Clone Repository
+### Clone + Makefile
 
 ```bash
 git clone https://github.com/TheBeardedBearSAS/claude-craft.git
 cd claude-craft
+make install-symfony TARGET=~/my-project RULES_LANG=en
 ```
 
-Then install rules to your project:
-
-```bash
-# Install Symfony rules (default: English)
-make install-symfony TARGET=~/my-project
-
-# Install with specific language
-make install-symfony TARGET=~/my-project RULES_LANG=fr
-
-# Install React rules in German
-make install-react TARGET=~/my-project RULES_LANG=de
-
-# Install all technologies
-make install-all TARGET=~/my-project RULES_LANG=es
-```
-
-### 3. Use in Claude Code
-
-Once installed, use the commands in your project:
-
-```
-/symfony:check-architecture
-/react:generate-component Button
-/common:pre-commit-check
-```
-
-## Supported Technologies
-
-| Technology | Skills | Commands | Agents | Focus |
-|------------|--------|----------|--------|-------|
-| **Common** | 7 | 21 | 11 | Cross-tech best practices, UI/UX |
-| **Symfony** | 16 | 10 | 1 | Clean Architecture, DDD, API Platform |
-| **Flutter** | 10 | 10 | 1 | BLoC pattern, Material/Cupertino |
-| **Python** | 6 | 10 | 1 | FastAPI, async/await, Type hints |
-| **React** | 8 | 8 | 1 | Hooks, State management, A11y |
-| **React Native** | 11 | 7 | 1 | Navigation, Native modules |
-| **Angular** | 6 | 6 | 1 | Standalone, Signals, OnPush, RxJS |
-| **C#/.NET** | 7 | 6 | 1 | Clean Architecture, CQRS, Entity Framework |
-| **Laravel** | 6 | 6 | 1 | Clean Architecture, Pest PHP, Sanctum |
-| **Vue.js** | 6 | 6 | 1 | Composition API, Pinia, Vitest |
-| **PHP** | 6 | 5 | 1 | Clean Architecture, PSR-12, PHPStan, Pest |
-| **Docker** | - | 5 | 5 | Dockerfile, Compose, CI/CD, Debugging, Optimize |
-| **Coolify** | - | 5 | 4 | Setup, Deploy, Debug, Backup, Optimize |
-
-## Project Structure
-
-```
-claude-craft/
-├── Makefile                    # Main orchestration
-├── claude-projects.yaml        # YAML configuration (user copy)
-├── Dev/
-│   ├── i18n/                   # Internationalized content
-│   │   ├── en/                 # English
-│   │   ├── fr/                 # French
-│   │   ├── es/                 # Spanish
-│   │   ├── de/                 # German
-│   │   └── pt/                 # Portuguese
-│   │       ├── Common/         # Shared agents, commands & skills
-│   │       ├── Symfony/        # PHP backend
-│   │       ├── Flutter/        # Mobile Dart
-│   │       ├── Python/         # Backend/API
-│   │       ├── React/          # Frontend JS/TS
-│   │       ├── ReactNative/    # Mobile JS/TS
-│   │       ├── Angular/        # Angular frontend
-│   │       ├── CSharp/         # C#/.NET backend
-│   │       ├── Laravel/        # PHP/Laravel backend
-│   │       ├── VueJS/          # Vue.js frontend
-│   │       └── PHP/            # PHP Clean Architecture
-│   └── scripts/                # Installation scripts
-├── Infra/                      # Infrastructure (Docker, Coolify)
-│   ├── i18n/                   # Translated agents & commands
-│   ├── install-infra-rules.sh
-│   └── install-coolify-rules.sh
-├── Project/                    # Project management commands
-│   ├── i18n/                   # Translated commands
-│   └── install-project-commands.sh
-├── Tools/                      # Claude Code utilities
-│   ├── MultiAccount/           # Multi-account manager
-│   ├── StatusLine/             # Custom status line
-│   ├── ProjectConfig/          # YAML project manager
-│   └── PluginExport/           # Export as Claude Code plugins
-├── cli/                        # NPX CLI (npx @the-bearded-bear/claude-craft)
-│   ├── index.js                # CLI orchestrator (dispatches to lib/ modules)
-│   ├── flattener.js            # Codebase flattener
-│   └── lib/                    # Extracted CLI modules
-│       ├── banner.js           # ASCII art banner & success messages
-│       ├── help.js             # Usage help text
-│       ├── installer.js        # Installation wizard & script runner
-│       ├── ralph.js            # Ralph Wiggum loop launcher
-│       ├── colors.js           # ANSI color definitions
-│       ├── constants.js        # Technologies, languages, tracks
-│       ├── detect-project.js   # Project detection utilities
-│       └── parse-args.js       # CLI argument parser
-└── bundles/                    # Web platform bundles
-    ├── chatgpt/                # ChatGPT bundle
-    ├── claude/                 # Claude Projects bundle
-    └── gemini/                 # Gemini Gems bundle
-```
-
-### What Gets Installed
-
-After installation, your project will have the TCL-optimized structure:
-
-```
-your-project/
-└── .claude/
-    ├── CLAUDE.md           # Minimal config (~200 tokens) - auto-loaded
-    ├── INDEX.md            # Quick reference summaries (~1,300 tokens)
-    ├── context.yaml        # File-based skill triggers
-    ├── settings.json       # Permissions and tool allowlists
-    ├── references/         # Full documentation (loaded on-demand via @)
-    │   ├── base/           # Universal principles (SOLID, DRY, etc.)
-    │   └── {tech}/         # Technology-specific rules
-    ├── skills/             # Best practices (official format)
-    │   ├── architecture/   # Architecture patterns
-    │   ├── testing/        # Testing strategies
-    │   └── security/       # Security guidelines
-    ├── agents/             # AI specialist definitions
-    ├── commands/           # Slash commands
-    │   ├── common/
-    │   └── {tech}/
-    ├── hooks/              # Pre/Post tool execution scripts
-    ├── mcp/                # MCP server templates
-    ├── checklists/         # Quality gates
-    └── templates/          # Code generation templates
-```
-
-### Token Optimization (TCL)
-
-The TCL structure reduces context from ~70,000 to ~3,500 tokens (95% reduction):
-
-| Level | Content | Tokens | Loading |
-|-------|---------|--------|---------|
-| **Always Loaded** | CLAUDE.md + INDEX.md | ~1,500 | Automatic |
-| **On-Demand** | Skills | ~variable | Via `/skill-name` or triggers |
-| **Reference** | Full rules | ~0 | Via `@.claude/references/...` |
-
-Access full documentation with: `@.claude/references/{tech}/architecture.md`
-
-## Installation Methods
-
-### Method 1: Makefile (Recommended)
-
-```bash
-# Single technology
-make install-symfony TARGET=~/my-project
-
-# Common rules only
-make install-common TARGET=~/my-project
-
-# Preset combinations
-make install-web TARGET=~/my-project      # React
-make install-backend TARGET=~/my-project  # Symfony + Python
-make install-mobile TARGET=~/my-project   # Flutter + React Native
-
-# Infrastructure (Docker + Coolify)
-make install-infra TARGET=~/my-project
-
-# Install Claude Code tools
-make install-tools                        # All tools
-make install-statusline                   # Custom status line
-make install-multiaccount                 # Multi-account manager
-make install-projectconfig                # Project config manager
-
-```
-
-### Method 2: YAML Configuration (Monorepos)
+### YAML Configuration (Monorepos)
 
 ```yaml
 # claude-projects.yaml
-settings:
-  default_lang: "en"  # Default language for all projects
-
 projects:
   - name: "my-monorepo"
     root: "~/Projects/my-monorepo"
-    lang: "fr"        # Override: French for this project
-    common: true
+    lang: "fr"
     modules:
       - path: "frontend"
         tech: react
       - path: "backend"
         tech: symfony
-      - path: "mobile"
-        tech: flutter
 ```
 
 ```bash
 make config-install PROJECT=my-monorepo
 ```
 
-#### Multi-Technology Modules
-
-You can specify multiple technologies for a single module. This is useful for fullstack folders or projects using multiple frameworks:
-
-```yaml
-projects:
-  - name: "fullstack-app"
-    root: "~/Projects/fullstack"
-    modules:
-      # Single technology (legacy syntax)
-      - path: "api"
-        tech: symfony
-
-      # Multiple technologies - inline array
-      - path: "frontend"
-        tech: [react, laravel]
-
-      # Multiple technologies - YAML list
-      - path: "dashboard"
-        tech:
-          - vuejs
-          - symfony
-```
-
-When multiple technologies are specified:
-- The **first technology** installs common rules (SOLID, TDD, etc.)
-- **Subsequent technologies** skip common rules to avoid duplicates
-- All tech-specific rules, commands, and agents are installed
+See [Installation Guide](docs/INSTALLATION.md) | [Configuration](docs/CONFIGURATION.md)
 
-### Method 3: Direct Script
-
-```bash
-# Default language (English)
-./Dev/scripts/install-symfony-rules.sh --install ~/my-project
+### What Gets Installed
 
-# With specific language
-./Dev/scripts/install-symfony-rules.sh --lang=fr ~/my-project
-./Dev/scripts/install-flutter-rules.sh --lang=de ~/my-project
 ```
-
-## CLI Tools
-
-### Codebase Flattener
-
-Generate a context-optimized summary of your codebase for AI assistants:
-
-```bash
-# Generate flattened context
-npx @the-bearded-bear/claude-craft flatten
-
-# With custom output file
-npx @the-bearded-bear/claude-craft flatten --output=CONTEXT.md
-
-# For large codebases (automatic sharding)
-npx @the-bearded-bear/claude-craft flatten --max-tokens=50000
+your-project/.claude/
+  CLAUDE.md           # Minimal config (~200 tokens, auto-loaded)
+  INDEX.md            # Quick reference summaries
+  references/         # Full documentation (loaded on-demand via @)
+  agents/             # AI specialist definitions
+  commands/           # Slash commands
+  skills/             # Best practices
+  checklists/         # Quality gates
+  templates/          # Code generation patterns
+  hooks/              # Pre/Post tool execution scripts
+  mcp/                # MCP server templates
 ```
 
-Features:
-- Smart file selection (ignores node_modules, vendor, etc.)
-- Automatic document sharding for large projects
-- Token estimation
-- Priority-based file ordering
-- File tree generation
-
-### Web Bundles
-
-Use Claude-Craft methodology outside of Claude Code:
-
-```bash
-claude-craft/bundles/
-├── chatgpt/claude-craft-bundle.md    # For ChatGPT Custom Instructions
-├── claude/claude-craft-bundle.md     # For Claude Projects
-└── gemini/claude-craft-bundle.md     # For Gemini Gems
-```
-
-Copy the appropriate bundle into your preferred AI platform's custom instructions.
-
-## Available Agents
-
-### Common Agents
-| Agent | Expertise |
-|-------|-----------|
-| `api-designer` | REST/GraphQL API design |
-| `database-architect` | Database optimization |
-| `devops-engineer` | CI/CD, Docker, deployment |
-| `performance-auditor` | Performance analysis |
-| `refactoring-specialist` | Safe code refactoring |
-| `research-assistant` | Technical research |
-| `tdd-coach` | Test-Driven Development |
-
-### UI/UX Agents
-| Agent | Expertise |
-|-------|-----------|
-| `uiux-orchestrator` | Coordinates UI, UX, and A11y experts |
-| `ui-designer` | Design systems, tokens, components |
-| `ux-ergonome` | User flows, cognitive ergonomics |
-| `accessibility-expert` | WCAG 2.2 AAA, ARIA, audits |
-
-### Technology Reviewers
-| Agent | Expertise |
-|-------|-----------|
-| `symfony-reviewer` | Symfony code review |
-| `flutter-reviewer` | Flutter code review |
-| `python-reviewer` | Python code review |
-| `react-reviewer` | React code review |
-| `reactnative-reviewer` | React Native code review |
-| `angular-reviewer` | Angular code review |
-| `laravel-reviewer` | Laravel code review |
-| `vuejs-reviewer` | Vue.js code review |
-| `php-reviewer` | PHP code review |
-
-### Docker/Infrastructure Agents
-| Agent | Expertise |
-|-------|-----------|
-| `docker-dockerfile` | Dockerfile optimization, multi-stage builds |
-| `docker-compose` | Compose orchestration, networks, volumes |
-| `docker-debug` | Container troubleshooting, diagnostics |
-| `docker-cicd` | CI/CD pipelines, security scanning |
-| `docker-architect` | Complete Docker architecture design |
-
-### Coolify/Infrastructure Agents
-| Agent | Expertise |
-|-------|-----------|
-| `coolify-architect` | Coolify infrastructure design |
-| `coolify-deployment` | Deploy and manage applications |
-| `coolify-debug` | Troubleshoot Coolify deployments |
-| `coolify-monitoring` | Monitoring and backups |
-
-## Command Namespaces
-
-- `/workflow:` - Development workflow (init, analyze, plan, design, implement, status)
-- `/project:` - Project management (backlog, PRD, tech-spec, sprints, **batch processing, migration**)
-- `/sprint:` - **BMAD sprint management (status, transitions, routing, TDD)**
-- `/gate:` - **Quality gate validation (PRD, tech-spec, backlog, story, sprint)**
-- `/team:` - Agent Teams (parallel audit, sprint, security, delivery)
-- `/uiux:` - UI/UX (audit, a11y, component-spec, design-tokens, user-flow)
-- `/common:` - Transversal commands (audit, changelog, CI/CD)
-- `/symfony:` - Symfony-specific (CRUD, migrations, Doctrine)
-- `/flutter:` - Flutter-specific (widgets, BLoC, performance)
-- `/python:` - Python-specific (endpoints, async, typing)
-- `/react:` - React-specific (components, hooks, a11y)
-- `/reactnative:` - React Native-specific (screens, native modules)
-- `/angular:` - Angular-specific (components, signals, standalone)
-- `/csharp:` - C#/.NET-specific (features, architecture, CQRS)
-- `/laravel:` - Laravel-specific (controllers, Actions, Pest PHP)
-- `/vuejs:` - Vue.js-specific (components, composables, Pinia)
-- `/php:` - PHP-specific (entities, value objects, use cases, Clean Architecture)
-- `/docker:` - Docker/Infrastructure (compose, debug, pipelines, architecture)
-- `/coolify:` - Coolify/PaaS (setup, deploy, debug, backup, optimize)
-- `/qa:*` - **QA Recette** (acceptance testing, regression, Chrome automation)
+Context usage is optimized: ~3,500 tokens always loaded vs ~70,000 if everything were inline (95% reduction).
 
 ## Documentation
 
-### 📚 User Guides (Multilingual)
-
-Complete step-by-step tutorials for getting started, developing features, and fixing bugs:
-
-| Guide | 🇬🇧 EN | 🇫🇷 FR | 🇪🇸 ES | 🇩🇪 DE | 🇧🇷 PT |
-|-------|--------|--------|--------|--------|--------|
+| Document | Description |
+|----------|-------------|
+| [Quickstart](docs/QUICKSTART.md) | Get results in 10 minutes |
+| [Installation](docs/INSTALLATION.md) | All installation methods |
+| [Configuration](docs/CONFIGURATION.md) | Project configuration |
+| [CLI Reference](docs/CLI-REFERENCE.md) | Full CLI documentation |
+| [Commands](docs/COMMANDS.md) | All 160 commands |
+| [Agents](docs/AGENTS.md) | All 33 agents |
+| [Skills](docs/SKILLS.md) | Best practices reference |
+| [Technologies](docs/TECHNOLOGIES.md) | Stack-specific guides |
+| [BMAD Guide](docs/BMAD-PRACTICAL-GUIDE.md) | Project management framework |
+| [Hooks](docs/HOOKS.md) | Pre/Post tool execution |
+| [MCP](docs/MCP.md) | Model Context Protocol integration |
+| [FAQ](docs/FAQ.md) | Common questions |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Problem solving |
+| [Migration v7](docs/MIGRATION-v7.md) | Upgrade from previous versions |
+| [Compatibility](.claude/COMPATIBILITY.md) | Claude Code version compatibility |
+
+### User Guides (Multilingual)
+
+Step-by-step tutorials available in 5 languages:
+
+| Guide | EN | FR | ES | DE | PT |
+|-------|----|----|----|----|-----|
 | Getting Started | [EN](docs/guides/en/01-getting-started.md) | [FR](docs/guides/fr/01-getting-started.md) | [ES](docs/guides/es/01-getting-started.md) | [DE](docs/guides/de/01-getting-started.md) | [PT](docs/guides/pt/01-getting-started.md) |
-| Project Creation | [EN](docs/guides/en/02-project-creation.md) | [FR](docs/guides/fr/02-project-creation.md) | [ES](docs/guides/es/02-project-creation.md) | [DE](docs/guides/de/02-project-creation.md) | [PT](docs/guides/pt/02-project-creation.md) |
 | Feature Development | [EN](docs/guides/en/03-feature-development.md) | [FR](docs/guides/fr/03-feature-development.md) | [ES](docs/guides/es/03-feature-development.md) | [DE](docs/guides/de/03-feature-development.md) | [PT](docs/guides/pt/03-feature-development.md) |
 | Bug Fixing | [EN](docs/guides/en/04-bug-fixing.md) | [FR](docs/guides/fr/04-bug-fixing.md) | [ES](docs/guides/es/04-bug-fixing.md) | [DE](docs/guides/de/04-bug-fixing.md) | [PT](docs/guides/pt/04-bug-fixing.md) |
-| Tools Reference | [EN](docs/guides/en/05-tools-reference.md) | [FR](docs/guides/fr/05-tools-reference.md) | [ES](docs/guides/es/05-tools-reference.md) | [DE](docs/guides/de/05-tools-reference.md) | [PT](docs/guides/pt/05-tools-reference.md) |
-| Troubleshooting | [EN](docs/guides/en/06-troubleshooting.md) | [FR](docs/guides/fr/06-troubleshooting.md) | [ES](docs/guides/es/06-troubleshooting.md) | [DE](docs/guides/de/06-troubleshooting.md) | [PT](docs/guides/pt/06-troubleshooting.md) |
-| Backlog Management | [EN](docs/guides/en/07-backlog-management.md) | [FR](docs/guides/fr/07-backlog-management.md) | [ES](docs/guides/es/07-backlog-management.md) | [DE](docs/guides/de/07-backlog-management.md) | [PT](docs/guides/pt/07-backlog-management.md) |
 
-📖 [Guide Index](docs/guides/index.md)
-
-### 📋 Reference Documentation
-
-- [Installation Guide](docs/INSTALLATION.md)
-- [Configuration](docs/CONFIGURATION.md)
-- [Skills Reference](docs/SKILLS.md) - Best practices in official format
-- [Agents Reference](docs/AGENTS.md)
-- [Commands Reference](docs/COMMANDS.md)
-- [Technologies Guide](docs/TECHNOLOGIES.md)
-- [Migration Guide](docs/MIGRATION-v7.md) - Upgrade existing projects to v7.0
-- [Hooks Guide](docs/HOOKS.md) - Pre/Post tool execution automation
-- [MCP Guide](docs/MCP.md) - Model Context Protocol integration
-
-## Requirements
-
-- **bash** - For installation scripts
-- **yq** - For YAML configuration parsing (optional)
-
-```bash
-# Install yq
-sudo apt install yq      # Debian/Ubuntu
-brew install yq          # macOS
-```
+[All guides](docs/guides/index.md) | [Project Creation](docs/guides/en/02-project-creation.md) | [Tools Reference](docs/guides/en/05-tools-reference.md) | [Troubleshooting](docs/guides/en/06-troubleshooting.md) | [Backlog Management](docs/guides/en/07-backlog-management.md)
 
 ## Contributing
 
@@ -605,7 +202,6 @@ Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md)
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
-## Acknowledgments
+---
 
-- Built for [Claude Code](https://claude.ai/code) by Anthropic
-- Inspired by Clean Architecture and Domain-Driven Design principles
+Built for [Claude Code](https://claude.ai/code) by Anthropic. Inspired by Clean Architecture and Domain-Driven Design principles.

package/cli/lib/tech-registry.js

@@ -19,6 +19,7 @@
  * @property {string} i18nDir - Directory name under Dev/i18n/{lang}/
  * @property {string} installScript - Install script filename
  * @property {string} version - Current supported version
+ * @property {1|2|3|null} tier - Maturity tier: 1=core, 2=supported, 3=community, null=infra
  */
 
 /** @type {Record<string, TechEntry>} */
@@ -31,6 +32,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Symfony',
     installScript: 'install-symfony-rules.sh',
     version: '8.0 / PHP 8.5',
+    tier: 1,
   },
   flutter: {
     name: 'flutter',
@@ -40,6 +42,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Flutter',
     installScript: 'install-flutter-rules.sh',
     version: '3.38 / Dart 3.10',
+    tier: 1,
   },
   react: {
     name: 'react',
@@ -49,6 +52,7 @@ const TECH_REGISTRY = {
     i18nDir: 'React',
     installScript: 'install-react-rules.sh',
     version: '19.x',
+    tier: 1,
   },
   reactnative: {
     name: 'reactnative',
@@ -58,6 +62,7 @@ const TECH_REGISTRY = {
     i18nDir: 'ReactNative',
     installScript: 'install-reactnative-rules.sh',
     version: '0.76+',
+    tier: 2,
   },
   angular: {
     name: 'angular',
@@ -67,6 +72,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Angular',
     installScript: 'install-angular-rules.sh',
     version: '19.x',
+    tier: 3,
   },
   csharp: {
     name: 'csharp',
@@ -76,6 +82,7 @@ const TECH_REGISTRY = {
     i18nDir: 'CSharp',
     installScript: 'install-csharp-rules.sh',
     version: '10 LTS / C# 14',
+    tier: 3,
   },
   laravel: {
     name: 'laravel',
@@ -85,6 +92,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Laravel',
     installScript: 'install-laravel-rules.sh',
     version: '12.x / PHP 8.5',
+    tier: 3,
   },
   vuejs: {
     name: 'vuejs',
@@ -94,6 +102,7 @@ const TECH_REGISTRY = {
     i18nDir: 'VueJS',
     installScript: 'install-vuejs-rules.sh',
     version: '3.5+',
+    tier: 3,
   },
   php: {
     name: 'php',
@@ -103,6 +112,7 @@ const TECH_REGISTRY = {
     i18nDir: 'PHP',
     installScript: 'install-php-rules.sh',
     version: '8.5',
+    tier: 2,
   },
   python: {
     name: 'python',
@@ -112,6 +122,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Python',
     installScript: 'install-python-rules.sh',
     version: '3.13+',
+    tier: 1,
   },
   docker: {
     name: 'docker',
@@ -121,6 +132,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Docker',
     installScript: 'install-infra-rules.sh',
     version: 'latest',
+    tier: null,
   },
   coolify: {
     name: 'coolify',
@@ -130,6 +142,7 @@ const TECH_REGISTRY = {
     i18nDir: 'Coolify',
     installScript: 'install-coolify-rules.sh',
     version: '4.x',
+    tier: null,
   },
 };
 
@@ -146,4 +159,11 @@ function getAllTechKeys() {
   return Object.keys(TECH_REGISTRY);
 }
 
-export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys };
+/** Get techs by tier */
+function getTechsByTier(tier) {
+  return Object.entries(TECH_REGISTRY)
+    .filter(([_, entry]) => entry.tier === tier)
+    .map(([key]) => key);
+}
+
+export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys, getTechsByTier };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-bearded-bear/claude-craft",
-  "version": "7.17.1",
+  "version": "7.18.0-next.c3e3337",
   "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
   "type": "module",
   "main": "cli/index.js",
@@ -13,6 +13,7 @@
   "scripts": {
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
+    "test:content": "vitest run tests/content/",
     "test:watch": "vitest",
     "lint": "eslint cli/",
     "lint:fix": "eslint cli/ --fix",