@the-bearded-bear/claude-craft 7.17.1 → 7.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +115 -521
  2. package/cli/lib/tech-registry.js +21 -1
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -8,594 +8,189 @@ A comprehensive framework for AI-assisted development with [Claude Code](https:/
8
8
 
9
9
  ## What's New in v7.17
10
10
 
11
- - **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
11
+ - **LSP plugin documentation** for all 10 technology stacks -- gives Claude structural code intelligence (diagnostics, go-to-definition, find references, type info)
12
12
  - See [CHANGELOG](CHANGELOG.md) for full details
13
13
 
14
- > See [CHANGELOG.md](CHANGELOG.md) for previous versions.
15
-
16
- ## Features
17
-
18
- - **10 Technology Stacks**: Symfony, Flutter, Python, React, React Native, Angular, C#/.NET, Laravel, Vue.js, PHP
19
- - **Infrastructure Stack**: Docker and Coolify agents and commands
20
- - **5 Languages**: English, French, Spanish, German, Portuguese
21
- - **33 AI Agents**: Specialized reviewers, architects, coaches, UI/UX, Docker, Coolify experts, and Ralph Conductor
22
- - **160 Slash Commands**: Automated workflows, code generation, **sprint management, quality gates, batch processing, acceptance testing**
23
- - **BMAD v6 Framework**: Complete project management with status-based routing, quality gates, and batch execution
24
- - **Ralph Wiggum**: Continuous loop execution with Definition of Done validation
25
- - **37 Skills**: Best practices in official Claude Code format (architecture, testing, security)
26
- - **21 Templates**: Code generation patterns + BMAD templates
27
- - **10 Checklists**: Quality gates for commits, features, releases
28
- - **Hooks System**: Pre/Post tool execution, quality gates, notifications, **BMAD context injection**
29
- - **MCP Templates**: Context7, GitHub, PostgreSQL, Slack integration
30
- - **Auto-generated CLAUDE.md**: Project configuration file created at installation
31
- - **Multi-Account Manager**: Manage multiple Claude Code accounts easily
32
- - **Custom Status Line**: Rich status bar with profile, model, git, context %
33
-
34
- ## Workflow Methodology
35
-
36
- Claude-Craft includes a BMAD-inspired workflow system that adapts to your project complexity.
37
-
38
- ### Development Tracks
39
-
40
- | Track | Setup Time | Phases | Best For |
41
- |-------|------------|--------|----------|
42
- | **Quick Flow** | < 5 min | Implementation only | Bug fixes, hotfixes, small tweaks |
43
- | **Standard** | < 15 min | Plan → Design → Implement | New features, refactoring |
44
- | **Enterprise** | < 30 min | Analyze → Plan → Design → Implement | Platforms, migrations, multi-team |
45
-
46
- ### Getting Started with Workflows
14
+ ## Install and First Result
47
15
 
48
16
  ```bash
49
- # Initialize workflow - auto-detects complexity
50
- /workflow:init
51
-
52
- # Or specify track
53
- /workflow:init --quick # Bug fix mode
54
- /workflow:init --enterprise # Full methodology
55
-
56
- # Check progress
57
- /workflow:status
58
- ```
59
-
60
- ### Workflow Commands
61
-
62
- | Command | Phase | Purpose |
63
- |---------|-------|---------|
64
- | `/workflow:init` | Setup | Analyze project, recommend track |
65
- | `/workflow:analyze` | Analysis | Research and exploration (Enterprise) |
66
- | `/workflow:plan` | Planning | Generate PRD, personas, backlog |
67
- | `/workflow:design` | Design | Tech spec, architecture, ADRs |
68
- | `/workflow:implement` | Implementation | Sprint development with TDD/BDD |
69
- | `/workflow:status` | Any | Show current progress |
70
-
71
- ### Document Generation
17
+ # Install to your project (picks your tech stack interactively)
18
+ npx @the-bearded-bear/claude-craft
72
19
 
73
- ```bash
74
- # Generate Product Requirements Document
75
- /project:generate-prd
20
+ # Or install directly
21
+ npx @the-bearded-bear/claude-craft install ~/my-project --tech=react --lang=en
76
22
 
77
- # Generate Technical Specification
78
- /project:generate-tech-spec
23
+ # Open Claude Code and run your first audit
24
+ claude
25
+ /team:audit
79
26
  ```
80
27
 
81
- ## BMAD v6 Project Management
82
-
83
- BMAD v6 (Build, Measure, Analyze, Deliver) extends the workflow system with comprehensive project management.
84
-
85
- ### BMAD Roles
86
-
87
- 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.
88
-
89
- ### Status-based Routing
90
-
91
- Stories automatically transition through a state machine:
28
+ That's it. You get an architecture, security, and quality audit of your project in minutes.
92
29
 
93
- ```
94
- backlog → ready-for-dev → in-progress → review → done
95
- ↓ ↓ ↓ ↓
96
- └──────────┴──────────────┴───────────┴→ blocked
97
- ```
30
+ > See [Quickstart](docs/QUICKSTART.md) for a step-by-step walkthrough with expected output at each stage.
98
31
 
99
- ```bash
100
- # View sprint status with routing info
101
- /sprint:status --bmad
32
+ ## Why Claude Craft?
102
33
 
103
- # Get next story ready for development
104
- /sprint:next-story --claim
34
+ Claude Code is powerful on its own. Claude Craft makes it **consistent and team-ready**:
105
35
 
106
- # Transition story status
107
- /sprint:transition US-005 review
36
+ - **Standardized rules** -- SOLID, Clean Architecture, TDD enforced across your team, not just suggested
37
+ - **33 specialized agents** -- reviewers, architects, coaches that know your stack deeply
38
+ - **160 slash commands** -- repeatable workflows for audits, code generation, sprint management
39
+ - **Quality gates** -- automated checks at every stage from PRD to deployment
40
+ - **5 languages** -- English, French, Spanish, German, Portuguese
108
41
 
109
- # Run automatic routing rules
110
- /sprint:auto-route
111
- ```
42
+ ## Supported Technologies
112
43
 
113
- ### 5 Quality Gates
44
+ | Stack | Version | Install Command |
45
+ |-------|---------|-----------------|
46
+ | **Symfony / PHP** | 8.0 / PHP 8.5 | `--tech=symfony` |
47
+ | **React** | 19.x | `--tech=react` |
48
+ | **Flutter / Dart** | 3.38 / Dart 3.10 | `--tech=flutter` |
49
+ | **Python** | 3.13+ / FastAPI | `--tech=python` |
50
+ | **Angular** | 19.x | `--tech=angular` |
51
+ | **Vue.js** | 3.5+ | `--tech=vuejs` |
52
+ | **React Native** | 0.76+ | `--tech=reactnative` |
53
+ | **C# / .NET** | 10 LTS / C# 14 | `--tech=csharp` |
54
+ | **Laravel** | 12.x / PHP 8.5 | `--tech=laravel` |
55
+ | **PHP** | 8.5 | `--tech=php` |
114
56
 
115
- | Gate | Threshold | When |
116
- |------|-----------|------|
117
- | **PRD Gate** | ≥80% | Vision → PRD |
118
- | **Tech Spec Gate** | ≥90% | PRD → Tech Spec |
119
- | **Backlog Gate** | INVEST 6/6 | Tech Spec → Backlog |
120
- | **Sprint Ready** | 100% | Backlog → Sprint |
121
- | **Story DoD** | 100% | Dev → Done |
57
+ Infrastructure stacks (Docker, Coolify) are also available. See [Technologies](docs/TECHNOLOGIES.md) for full details.
122
58
 
123
- ```bash
124
- # Validate PRD quality
125
- /gate:validate-prd docs/prd.md
59
+ ## What's Included
126
60
 
127
- # Check INVEST compliance
128
- /gate:validate-backlog
61
+ | Category | Count | Examples |
62
+ |----------|-------|---------|
63
+ | **Agents** | 33 | `@tdd-coach`, `@api-designer`, `@symfony-reviewer`, `@docker-architect` |
64
+ | **Commands** | 160 | `/workflow:init`, `/team:audit`, `/react:generate-component` |
65
+ | **Skills** | 37 | Architecture, testing, security best practices |
66
+ | **Templates** | 21 | Code generation patterns, BMAD project templates |
67
+ | **Checklists** | 10 | Commit, feature, release quality gates |
129
68
 
130
- # Verify story meets Definition of Done
131
- /gate:validate-story US-005
69
+ See [Agents](docs/AGENTS.md) | [Commands](docs/COMMANDS.md) | [Skills](docs/SKILLS.md)
132
70
 
133
- # Full gates report
134
- /gate:report
135
- ```
71
+ ## Workflow Tracks
136
72
 
137
- ### Batch Processing
73
+ Claude Craft adapts to your project complexity with three development tracks:
138
74
 
139
- Process multiple stories automatically:
75
+ | Track | Setup | Phases | Best For |
76
+ |-------|-------|--------|----------|
77
+ | **Quick Flow** | < 5 min | Implementation only | Bug fixes, hotfixes |
78
+ | **Standard** | < 15 min | Plan > Design > Implement | New features, refactoring |
79
+ | **Enterprise** | < 30 min | Analyze > Plan > Design > Implement | Platforms, migrations |
140
80
 
141
81
  ```bash
142
- # Queue all stories from an epic
143
- /project:run-epic EPIC-002
144
-
145
- # Process the queue
146
- /project:run-queue --parallel 3
147
-
148
- # Execute full sprint
149
- /project:run-sprint --auto
150
-
151
- # Check batch status
152
- /project:batch-status
82
+ /workflow:init # Auto-detects complexity
83
+ /workflow:init --quick # Bug fix mode
84
+ /workflow:init --enterprise # Full methodology
153
85
  ```
154
86
 
155
- ### Backlog Migration
87
+ See [BMAD Practical Guide](docs/BMAD-PRACTICAL-GUIDE.md) for the complete project management framework.
156
88
 
157
- Convert existing backlogs to BMAD v6:
89
+ ## Key Commands
158
90
 
159
- ```bash
160
- # Analyze current backlog structure
161
- /project:analyze-backlog
91
+ These are the commands you'll use most:
162
92
 
163
- # Migrate to BMAD v6 format
164
- /project:migrate-backlog --dry-run
165
- /project:migrate-backlog
93
+ | Command | What It Does |
94
+ |---------|-------------|
95
+ | `/workflow:init` | Start a development workflow (auto-detects track) |
96
+ | `/team:audit` | Full project audit (architecture, security, quality) |
97
+ | `/common:pre-commit-check` | Validate before committing |
98
+ | `/sprint:next-story` | Get next story ready for development |
99
+ | `/qa:tdd` | Test-Driven Development flow |
100
+ | `/gate:validate-story` | Check story meets Definition of Done |
101
+ | `/{tech}:check-architecture` | Verify architecture compliance |
102
+ | `/{tech}:generate-*` | Generate code following project patterns |
103
+ | `/common:ralph-run "task"` | Run Claude in continuous loop until task is done |
104
+ | `/qa:recette` | Automated acceptance testing via Chrome |
166
105
 
167
- # Add missing fields to stories
168
- /project:update-stories
106
+ See [CLI Reference](docs/CLI-REFERENCE.md) for all 160 commands across 20 namespaces.
169
107
 
170
- # Sync files with sprint-status.yaml
171
- /project:sync-backlog
172
- ```
108
+ ## Installation
173
109
 
174
- ### Claude Code Hooks Integration
175
-
176
- Enable BMAD hooks in `.claude/settings.json`:
177
-
178
- ```json
179
- {
180
- "hooks": {
181
- "SessionStart": [{
182
- "command": ".bmad/hooks/sprint-context.sh",
183
- "timeout": 5000
184
- }],
185
- "PreToolUse": [{
186
- "command": ".bmad/hooks/story-status.sh",
187
- "once": true,
188
- "timeout": 3000
189
- }],
190
- "Stop": [{
191
- "command": ".bmad/hooks/quality-gate.sh",
192
- "timeout": 10000
193
- }]
194
- }
195
- }
196
- ```
197
-
198
- ## Quick Start
199
-
200
- ### Method 1: NPX (Recommended)
110
+ ### NPX (Recommended)
201
111
 
202
112
  ```bash
203
- # Interactive installation wizard
204
- npx @the-bearded-bear/claude-craft
205
-
206
- # Or install to specific directory
207
- npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=fr
113
+ npx @the-bearded-bear/claude-craft install ~/my-project --tech=symfony --lang=en
208
114
  ```
209
115
 
210
- ### Method 2: Clone Repository
116
+ ### Clone + Makefile
211
117
 
212
118
  ```bash
213
119
  git clone https://github.com/TheBeardedBearSAS/claude-craft.git
214
120
  cd claude-craft
121
+ make install-symfony TARGET=~/my-project RULES_LANG=en
215
122
  ```
216
123
 
217
- Then install rules to your project:
218
-
219
- ```bash
220
- # Install Symfony rules (default: English)
221
- make install-symfony TARGET=~/my-project
222
-
223
- # Install with specific language
224
- make install-symfony TARGET=~/my-project RULES_LANG=fr
225
-
226
- # Install React rules in German
227
- make install-react TARGET=~/my-project RULES_LANG=de
228
-
229
- # Install all technologies
230
- make install-all TARGET=~/my-project RULES_LANG=es
231
- ```
232
-
233
- ### 3. Use in Claude Code
234
-
235
- Once installed, use the commands in your project:
236
-
237
- ```
238
- /symfony:check-architecture
239
- /react:generate-component Button
240
- /common:pre-commit-check
241
- ```
242
-
243
- ## Supported Technologies
244
-
245
- | Technology | Skills | Commands | Agents | Focus |
246
- |------------|--------|----------|--------|-------|
247
- | **Common** | 7 | 21 | 11 | Cross-tech best practices, UI/UX |
248
- | **Symfony** | 16 | 10 | 1 | Clean Architecture, DDD, API Platform |
249
- | **Flutter** | 10 | 10 | 1 | BLoC pattern, Material/Cupertino |
250
- | **Python** | 6 | 10 | 1 | FastAPI, async/await, Type hints |
251
- | **React** | 8 | 8 | 1 | Hooks, State management, A11y |
252
- | **React Native** | 11 | 7 | 1 | Navigation, Native modules |
253
- | **Angular** | 6 | 6 | 1 | Standalone, Signals, OnPush, RxJS |
254
- | **C#/.NET** | 7 | 6 | 1 | Clean Architecture, CQRS, Entity Framework |
255
- | **Laravel** | 6 | 6 | 1 | Clean Architecture, Pest PHP, Sanctum |
256
- | **Vue.js** | 6 | 6 | 1 | Composition API, Pinia, Vitest |
257
- | **PHP** | 6 | 5 | 1 | Clean Architecture, PSR-12, PHPStan, Pest |
258
- | **Docker** | - | 5 | 5 | Dockerfile, Compose, CI/CD, Debugging, Optimize |
259
- | **Coolify** | - | 5 | 4 | Setup, Deploy, Debug, Backup, Optimize |
260
-
261
- ## Project Structure
262
-
263
- ```
264
- claude-craft/
265
- ├── Makefile # Main orchestration
266
- ├── claude-projects.yaml # YAML configuration (user copy)
267
- ├── Dev/
268
- │ ├── i18n/ # Internationalized content
269
- │ │ ├── en/ # English
270
- │ │ ├── fr/ # French
271
- │ │ ├── es/ # Spanish
272
- │ │ ├── de/ # German
273
- │ │ └── pt/ # Portuguese
274
- │ │ ├── Common/ # Shared agents, commands & skills
275
- │ │ ├── Symfony/ # PHP backend
276
- │ │ ├── Flutter/ # Mobile Dart
277
- │ │ ├── Python/ # Backend/API
278
- │ │ ├── React/ # Frontend JS/TS
279
- │ │ ├── ReactNative/ # Mobile JS/TS
280
- │ │ ├── Angular/ # Angular frontend
281
- │ │ ├── CSharp/ # C#/.NET backend
282
- │ │ ├── Laravel/ # PHP/Laravel backend
283
- │ │ ├── VueJS/ # Vue.js frontend
284
- │ │ └── PHP/ # PHP Clean Architecture
285
- │ └── scripts/ # Installation scripts
286
- ├── Infra/ # Infrastructure (Docker, Coolify)
287
- │ ├── i18n/ # Translated agents & commands
288
- │ ├── install-infra-rules.sh
289
- │ └── install-coolify-rules.sh
290
- ├── Project/ # Project management commands
291
- │ ├── i18n/ # Translated commands
292
- │ └── install-project-commands.sh
293
- ├── Tools/ # Claude Code utilities
294
- │ ├── MultiAccount/ # Multi-account manager
295
- │ ├── StatusLine/ # Custom status line
296
- │ ├── ProjectConfig/ # YAML project manager
297
- │ └── PluginExport/ # Export as Claude Code plugins
298
- ├── cli/ # NPX CLI (npx @the-bearded-bear/claude-craft)
299
- │ ├── index.js # CLI orchestrator (dispatches to lib/ modules)
300
- │ ├── flattener.js # Codebase flattener
301
- │ └── lib/ # Extracted CLI modules
302
- │ ├── banner.js # ASCII art banner & success messages
303
- │ ├── help.js # Usage help text
304
- │ ├── installer.js # Installation wizard & script runner
305
- │ ├── ralph.js # Ralph Wiggum loop launcher
306
- │ ├── colors.js # ANSI color definitions
307
- │ ├── constants.js # Technologies, languages, tracks
308
- │ ├── detect-project.js # Project detection utilities
309
- │ └── parse-args.js # CLI argument parser
310
- └── bundles/ # Web platform bundles
311
- ├── chatgpt/ # ChatGPT bundle
312
- ├── claude/ # Claude Projects bundle
313
- └── gemini/ # Gemini Gems bundle
314
- ```
315
-
316
- ### What Gets Installed
317
-
318
- After installation, your project will have the TCL-optimized structure:
319
-
320
- ```
321
- your-project/
322
- └── .claude/
323
- ├── CLAUDE.md # Minimal config (~200 tokens) - auto-loaded
324
- ├── INDEX.md # Quick reference summaries (~1,300 tokens)
325
- ├── context.yaml # File-based skill triggers
326
- ├── settings.json # Permissions and tool allowlists
327
- ├── references/ # Full documentation (loaded on-demand via @)
328
- │ ├── base/ # Universal principles (SOLID, DRY, etc.)
329
- │ └── {tech}/ # Technology-specific rules
330
- ├── skills/ # Best practices (official format)
331
- │ ├── architecture/ # Architecture patterns
332
- │ ├── testing/ # Testing strategies
333
- │ └── security/ # Security guidelines
334
- ├── agents/ # AI specialist definitions
335
- ├── commands/ # Slash commands
336
- │ ├── common/
337
- │ └── {tech}/
338
- ├── hooks/ # Pre/Post tool execution scripts
339
- ├── mcp/ # MCP server templates
340
- ├── checklists/ # Quality gates
341
- └── templates/ # Code generation templates
342
- ```
343
-
344
- ### Token Optimization (TCL)
345
-
346
- The TCL structure reduces context from ~70,000 to ~3,500 tokens (95% reduction):
347
-
348
- | Level | Content | Tokens | Loading |
349
- |-------|---------|--------|---------|
350
- | **Always Loaded** | CLAUDE.md + INDEX.md | ~1,500 | Automatic |
351
- | **On-Demand** | Skills | ~variable | Via `/skill-name` or triggers |
352
- | **Reference** | Full rules | ~0 | Via `@.claude/references/...` |
353
-
354
- Access full documentation with: `@.claude/references/{tech}/architecture.md`
355
-
356
- ## Installation Methods
357
-
358
- ### Method 1: Makefile (Recommended)
359
-
360
- ```bash
361
- # Single technology
362
- make install-symfony TARGET=~/my-project
363
-
364
- # Common rules only
365
- make install-common TARGET=~/my-project
366
-
367
- # Preset combinations
368
- make install-web TARGET=~/my-project # React
369
- make install-backend TARGET=~/my-project # Symfony + Python
370
- make install-mobile TARGET=~/my-project # Flutter + React Native
371
-
372
- # Infrastructure (Docker + Coolify)
373
- make install-infra TARGET=~/my-project
374
-
375
- # Install Claude Code tools
376
- make install-tools # All tools
377
- make install-statusline # Custom status line
378
- make install-multiaccount # Multi-account manager
379
- make install-projectconfig # Project config manager
380
-
381
- ```
382
-
383
- ### Method 2: YAML Configuration (Monorepos)
124
+ ### YAML Configuration (Monorepos)
384
125
 
385
126
  ```yaml
386
127
  # claude-projects.yaml
387
- settings:
388
- default_lang: "en" # Default language for all projects
389
-
390
128
  projects:
391
129
  - name: "my-monorepo"
392
130
  root: "~/Projects/my-monorepo"
393
- lang: "fr" # Override: French for this project
394
- common: true
131
+ lang: "fr"
395
132
  modules:
396
133
  - path: "frontend"
397
134
  tech: react
398
135
  - path: "backend"
399
136
  tech: symfony
400
- - path: "mobile"
401
- tech: flutter
402
137
  ```
403
138
 
404
139
  ```bash
405
140
  make config-install PROJECT=my-monorepo
406
141
  ```
407
142
 
408
- #### Multi-Technology Modules
409
-
410
- You can specify multiple technologies for a single module. This is useful for fullstack folders or projects using multiple frameworks:
411
-
412
- ```yaml
413
- projects:
414
- - name: "fullstack-app"
415
- root: "~/Projects/fullstack"
416
- modules:
417
- # Single technology (legacy syntax)
418
- - path: "api"
419
- tech: symfony
420
-
421
- # Multiple technologies - inline array
422
- - path: "frontend"
423
- tech: [react, laravel]
424
-
425
- # Multiple technologies - YAML list
426
- - path: "dashboard"
427
- tech:
428
- - vuejs
429
- - symfony
430
- ```
431
-
432
- When multiple technologies are specified:
433
- - The **first technology** installs common rules (SOLID, TDD, etc.)
434
- - **Subsequent technologies** skip common rules to avoid duplicates
435
- - All tech-specific rules, commands, and agents are installed
143
+ See [Installation Guide](docs/INSTALLATION.md) | [Configuration](docs/CONFIGURATION.md)
436
144
 
437
- ### Method 3: Direct Script
438
-
439
- ```bash
440
- # Default language (English)
441
- ./Dev/scripts/install-symfony-rules.sh --install ~/my-project
145
+ ### What Gets Installed
442
146
 
443
- # With specific language
444
- ./Dev/scripts/install-symfony-rules.sh --lang=fr ~/my-project
445
- ./Dev/scripts/install-flutter-rules.sh --lang=de ~/my-project
446
147
  ```
447
-
448
- ## CLI Tools
449
-
450
- ### Codebase Flattener
451
-
452
- Generate a context-optimized summary of your codebase for AI assistants:
453
-
454
- ```bash
455
- # Generate flattened context
456
- npx @the-bearded-bear/claude-craft flatten
457
-
458
- # With custom output file
459
- npx @the-bearded-bear/claude-craft flatten --output=CONTEXT.md
460
-
461
- # For large codebases (automatic sharding)
462
- npx @the-bearded-bear/claude-craft flatten --max-tokens=50000
148
+ your-project/.claude/
149
+ CLAUDE.md # Minimal config (~200 tokens, auto-loaded)
150
+ INDEX.md # Quick reference summaries
151
+ references/ # Full documentation (loaded on-demand via @)
152
+ agents/ # AI specialist definitions
153
+ commands/ # Slash commands
154
+ skills/ # Best practices
155
+ checklists/ # Quality gates
156
+ templates/ # Code generation patterns
157
+ hooks/ # Pre/Post tool execution scripts
158
+ mcp/ # MCP server templates
463
159
  ```
464
160
 
465
- Features:
466
- - Smart file selection (ignores node_modules, vendor, etc.)
467
- - Automatic document sharding for large projects
468
- - Token estimation
469
- - Priority-based file ordering
470
- - File tree generation
471
-
472
- ### Web Bundles
473
-
474
- Use Claude-Craft methodology outside of Claude Code:
475
-
476
- ```bash
477
- claude-craft/bundles/
478
- ├── chatgpt/claude-craft-bundle.md # For ChatGPT Custom Instructions
479
- ├── claude/claude-craft-bundle.md # For Claude Projects
480
- └── gemini/claude-craft-bundle.md # For Gemini Gems
481
- ```
482
-
483
- Copy the appropriate bundle into your preferred AI platform's custom instructions.
484
-
485
- ## Available Agents
486
-
487
- ### Common Agents
488
- | Agent | Expertise |
489
- |-------|-----------|
490
- | `api-designer` | REST/GraphQL API design |
491
- | `database-architect` | Database optimization |
492
- | `devops-engineer` | CI/CD, Docker, deployment |
493
- | `performance-auditor` | Performance analysis |
494
- | `refactoring-specialist` | Safe code refactoring |
495
- | `research-assistant` | Technical research |
496
- | `tdd-coach` | Test-Driven Development |
497
-
498
- ### UI/UX Agents
499
- | Agent | Expertise |
500
- |-------|-----------|
501
- | `uiux-orchestrator` | Coordinates UI, UX, and A11y experts |
502
- | `ui-designer` | Design systems, tokens, components |
503
- | `ux-ergonome` | User flows, cognitive ergonomics |
504
- | `accessibility-expert` | WCAG 2.2 AAA, ARIA, audits |
505
-
506
- ### Technology Reviewers
507
- | Agent | Expertise |
508
- |-------|-----------|
509
- | `symfony-reviewer` | Symfony code review |
510
- | `flutter-reviewer` | Flutter code review |
511
- | `python-reviewer` | Python code review |
512
- | `react-reviewer` | React code review |
513
- | `reactnative-reviewer` | React Native code review |
514
- | `angular-reviewer` | Angular code review |
515
- | `laravel-reviewer` | Laravel code review |
516
- | `vuejs-reviewer` | Vue.js code review |
517
- | `php-reviewer` | PHP code review |
518
-
519
- ### Docker/Infrastructure Agents
520
- | Agent | Expertise |
521
- |-------|-----------|
522
- | `docker-dockerfile` | Dockerfile optimization, multi-stage builds |
523
- | `docker-compose` | Compose orchestration, networks, volumes |
524
- | `docker-debug` | Container troubleshooting, diagnostics |
525
- | `docker-cicd` | CI/CD pipelines, security scanning |
526
- | `docker-architect` | Complete Docker architecture design |
527
-
528
- ### Coolify/Infrastructure Agents
529
- | Agent | Expertise |
530
- |-------|-----------|
531
- | `coolify-architect` | Coolify infrastructure design |
532
- | `coolify-deployment` | Deploy and manage applications |
533
- | `coolify-debug` | Troubleshoot Coolify deployments |
534
- | `coolify-monitoring` | Monitoring and backups |
535
-
536
- ## Command Namespaces
537
-
538
- - `/workflow:` - Development workflow (init, analyze, plan, design, implement, status)
539
- - `/project:` - Project management (backlog, PRD, tech-spec, sprints, **batch processing, migration**)
540
- - `/sprint:` - **BMAD sprint management (status, transitions, routing, TDD)**
541
- - `/gate:` - **Quality gate validation (PRD, tech-spec, backlog, story, sprint)**
542
- - `/team:` - Agent Teams (parallel audit, sprint, security, delivery)
543
- - `/uiux:` - UI/UX (audit, a11y, component-spec, design-tokens, user-flow)
544
- - `/common:` - Transversal commands (audit, changelog, CI/CD)
545
- - `/symfony:` - Symfony-specific (CRUD, migrations, Doctrine)
546
- - `/flutter:` - Flutter-specific (widgets, BLoC, performance)
547
- - `/python:` - Python-specific (endpoints, async, typing)
548
- - `/react:` - React-specific (components, hooks, a11y)
549
- - `/reactnative:` - React Native-specific (screens, native modules)
550
- - `/angular:` - Angular-specific (components, signals, standalone)
551
- - `/csharp:` - C#/.NET-specific (features, architecture, CQRS)
552
- - `/laravel:` - Laravel-specific (controllers, Actions, Pest PHP)
553
- - `/vuejs:` - Vue.js-specific (components, composables, Pinia)
554
- - `/php:` - PHP-specific (entities, value objects, use cases, Clean Architecture)
555
- - `/docker:` - Docker/Infrastructure (compose, debug, pipelines, architecture)
556
- - `/coolify:` - Coolify/PaaS (setup, deploy, debug, backup, optimize)
557
- - `/qa:*` - **QA Recette** (acceptance testing, regression, Chrome automation)
161
+ Context usage is optimized: ~3,500 tokens always loaded vs ~70,000 if everything were inline (95% reduction).
558
162
 
559
163
  ## Documentation
560
164
 
561
- ### 📚 User Guides (Multilingual)
562
-
563
- Complete step-by-step tutorials for getting started, developing features, and fixing bugs:
564
-
565
- | Guide | 🇬🇧 EN | 🇫🇷 FR | 🇪🇸 ES | 🇩🇪 DE | 🇧🇷 PT |
566
- |-------|--------|--------|--------|--------|--------|
165
+ | Document | Description |
166
+ |----------|-------------|
167
+ | [Quickstart](docs/QUICKSTART.md) | Get results in 10 minutes |
168
+ | [Installation](docs/INSTALLATION.md) | All installation methods |
169
+ | [Configuration](docs/CONFIGURATION.md) | Project configuration |
170
+ | [CLI Reference](docs/CLI-REFERENCE.md) | Full CLI documentation |
171
+ | [Commands](docs/COMMANDS.md) | All 160 commands |
172
+ | [Agents](docs/AGENTS.md) | All 33 agents |
173
+ | [Skills](docs/SKILLS.md) | Best practices reference |
174
+ | [Technologies](docs/TECHNOLOGIES.md) | Stack-specific guides |
175
+ | [BMAD Guide](docs/BMAD-PRACTICAL-GUIDE.md) | Project management framework |
176
+ | [Hooks](docs/HOOKS.md) | Pre/Post tool execution |
177
+ | [MCP](docs/MCP.md) | Model Context Protocol integration |
178
+ | [FAQ](docs/FAQ.md) | Common questions |
179
+ | [Troubleshooting](docs/TROUBLESHOOTING.md) | Problem solving |
180
+ | [Migration v7](docs/MIGRATION-v7.md) | Upgrade from previous versions |
181
+ | [Compatibility](.claude/COMPATIBILITY.md) | Claude Code version compatibility |
182
+
183
+ ### User Guides (Multilingual)
184
+
185
+ Step-by-step tutorials available in 5 languages:
186
+
187
+ | Guide | EN | FR | ES | DE | PT |
188
+ |-------|----|----|----|----|-----|
567
189
  | 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) |
568
- | 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) |
569
190
  | 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) |
570
191
  | 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) |
571
- | 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) |
572
- | 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) |
573
- | 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) |
574
192
 
575
- 📖 [Guide Index](docs/guides/index.md)
576
-
577
- ### 📋 Reference Documentation
578
-
579
- - [Installation Guide](docs/INSTALLATION.md)
580
- - [Configuration](docs/CONFIGURATION.md)
581
- - [Skills Reference](docs/SKILLS.md) - Best practices in official format
582
- - [Agents Reference](docs/AGENTS.md)
583
- - [Commands Reference](docs/COMMANDS.md)
584
- - [Technologies Guide](docs/TECHNOLOGIES.md)
585
- - [Migration Guide](docs/MIGRATION-v7.md) - Upgrade existing projects to v7.0
586
- - [Hooks Guide](docs/HOOKS.md) - Pre/Post tool execution automation
587
- - [MCP Guide](docs/MCP.md) - Model Context Protocol integration
588
-
589
- ## Requirements
590
-
591
- - **bash** - For installation scripts
592
- - **yq** - For YAML configuration parsing (optional)
593
-
594
- ```bash
595
- # Install yq
596
- sudo apt install yq # Debian/Ubuntu
597
- brew install yq # macOS
598
- ```
193
+ [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)
599
194
 
600
195
  ## Contributing
601
196
 
@@ -605,7 +200,6 @@ Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md)
605
200
 
606
201
  This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
607
202
 
608
- ## Acknowledgments
203
+ ---
609
204
 
610
- - Built for [Claude Code](https://claude.ai/code) by Anthropic
611
- - Inspired by Clean Architecture and Domain-Driven Design principles
205
+ 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 CHANGED
@@ -19,6 +19,7 @@
19
19
  * @property {string} i18nDir - Directory name under Dev/i18n/{lang}/
20
20
  * @property {string} installScript - Install script filename
21
21
  * @property {string} version - Current supported version
22
+ * @property {1|2|3|null} tier - Maturity tier: 1=core, 2=supported, 3=community, null=infra
22
23
  */
23
24
 
24
25
  /** @type {Record<string, TechEntry>} */
@@ -31,6 +32,7 @@ const TECH_REGISTRY = {
31
32
  i18nDir: 'Symfony',
32
33
  installScript: 'install-symfony-rules.sh',
33
34
  version: '8.0 / PHP 8.5',
35
+ tier: 1,
34
36
  },
35
37
  flutter: {
36
38
  name: 'flutter',
@@ -40,6 +42,7 @@ const TECH_REGISTRY = {
40
42
  i18nDir: 'Flutter',
41
43
  installScript: 'install-flutter-rules.sh',
42
44
  version: '3.38 / Dart 3.10',
45
+ tier: 1,
43
46
  },
44
47
  react: {
45
48
  name: 'react',
@@ -49,6 +52,7 @@ const TECH_REGISTRY = {
49
52
  i18nDir: 'React',
50
53
  installScript: 'install-react-rules.sh',
51
54
  version: '19.x',
55
+ tier: 1,
52
56
  },
53
57
  reactnative: {
54
58
  name: 'reactnative',
@@ -58,6 +62,7 @@ const TECH_REGISTRY = {
58
62
  i18nDir: 'ReactNative',
59
63
  installScript: 'install-reactnative-rules.sh',
60
64
  version: '0.76+',
65
+ tier: 2,
61
66
  },
62
67
  angular: {
63
68
  name: 'angular',
@@ -67,6 +72,7 @@ const TECH_REGISTRY = {
67
72
  i18nDir: 'Angular',
68
73
  installScript: 'install-angular-rules.sh',
69
74
  version: '19.x',
75
+ tier: 3,
70
76
  },
71
77
  csharp: {
72
78
  name: 'csharp',
@@ -76,6 +82,7 @@ const TECH_REGISTRY = {
76
82
  i18nDir: 'CSharp',
77
83
  installScript: 'install-csharp-rules.sh',
78
84
  version: '10 LTS / C# 14',
85
+ tier: 3,
79
86
  },
80
87
  laravel: {
81
88
  name: 'laravel',
@@ -85,6 +92,7 @@ const TECH_REGISTRY = {
85
92
  i18nDir: 'Laravel',
86
93
  installScript: 'install-laravel-rules.sh',
87
94
  version: '12.x / PHP 8.5',
95
+ tier: 3,
88
96
  },
89
97
  vuejs: {
90
98
  name: 'vuejs',
@@ -94,6 +102,7 @@ const TECH_REGISTRY = {
94
102
  i18nDir: 'VueJS',
95
103
  installScript: 'install-vuejs-rules.sh',
96
104
  version: '3.5+',
105
+ tier: 3,
97
106
  },
98
107
  php: {
99
108
  name: 'php',
@@ -103,6 +112,7 @@ const TECH_REGISTRY = {
103
112
  i18nDir: 'PHP',
104
113
  installScript: 'install-php-rules.sh',
105
114
  version: '8.5',
115
+ tier: 2,
106
116
  },
107
117
  python: {
108
118
  name: 'python',
@@ -112,6 +122,7 @@ const TECH_REGISTRY = {
112
122
  i18nDir: 'Python',
113
123
  installScript: 'install-python-rules.sh',
114
124
  version: '3.13+',
125
+ tier: 1,
115
126
  },
116
127
  docker: {
117
128
  name: 'docker',
@@ -121,6 +132,7 @@ const TECH_REGISTRY = {
121
132
  i18nDir: 'Docker',
122
133
  installScript: 'install-infra-rules.sh',
123
134
  version: 'latest',
135
+ tier: null,
124
136
  },
125
137
  coolify: {
126
138
  name: 'coolify',
@@ -130,6 +142,7 @@ const TECH_REGISTRY = {
130
142
  i18nDir: 'Coolify',
131
143
  installScript: 'install-coolify-rules.sh',
132
144
  version: '4.x',
145
+ tier: null,
133
146
  },
134
147
  };
135
148
 
@@ -146,4 +159,11 @@ function getAllTechKeys() {
146
159
  return Object.keys(TECH_REGISTRY);
147
160
  }
148
161
 
149
- export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys };
162
+ /** Get techs by tier */
163
+ function getTechsByTier(tier) {
164
+ return Object.entries(TECH_REGISTRY)
165
+ .filter(([_, entry]) => entry.tier === tier)
166
+ .map(([key]) => key);
167
+ }
168
+
169
+ export { TECH_REGISTRY, INSTALLABLE_TECHS, getDisplayName, getAllTechKeys, getTechsByTier };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@the-bearded-bear/claude-craft",
3
- "version": "7.17.1",
3
+ "version": "7.18.0",
4
4
  "description": "A comprehensive framework for AI-assisted development with Claude Code. Install standardized rules, agents, and commands for your projects.",
5
5
  "type": "module",
6
6
  "main": "cli/index.js",
@@ -13,6 +13,7 @@
13
13
  "scripts": {
14
14
  "test": "vitest run",
15
15
  "test:coverage": "vitest run --coverage",
16
+ "test:content": "vitest run tests/content/",
16
17
  "test:watch": "vitest",
17
18
  "lint": "eslint cli/",
18
19
  "lint:fix": "eslint cli/ --fix",