The most comprehensive Drupal 11 development toolkit for Claude Code. Module scaffolding, theme development, configuration management, migration, security auditing, testing, deployment, and more.
- Requirements
- Installation
- Quick Start
- How It Works
- Commands
- Agents
- Skills
- Hooks
- Environment Support
- Drupal Compatibility
- Troubleshooting
- Contributing
- License
- Claude Code CLI v1.0+
jqinstalled (used by hook scripts for JSON processing)- For full functionality within a Drupal project:
claude plugin install drupal-boostOr load directly:
claude --plugin-dir ./drupal-boost/drupal-boost:boost-module my_module "Custom content management module"
/drupal-boost:security-audit
/drupal-boost:quality-check
drupal-boost operates on a 3-tier architecture that combines automatic detection, contextual skills, and user-invoked workflows:
┌─────────────────────────────────────────────────────────┐
│ Tier 1: AUTOMATIC │
│ SessionStart hook detects Drupal version, DDEV/Lando, │
│ PHP version, Composer, and Drush availability. │
├─────────────────────────────────────────────────────────┤
│ Tier 2: SKILLS (Auto-Triggered) │
│ 13 skills activate based on conversation context. │
│ Ask about migrations → migrate-api skill loads. │
│ Ask about caching → caching-strategy skill loads. │
├─────────────────────────────────────────────────────────┤
│ Tier 3: COMMANDS (User-Invoked) │
│ 8 slash commands for multi-phase workflows. │
│ /boost-feature runs a full 7-phase dev cycle. │
├─────────────────────────────────────────────────────────┤
│ Cross-cutting: HOOKS │
│ Every Write/Edit is validated for PSR-4 namespaces, │
│ .info.yml structure, and Drupal coding standards. │
│ Bash commands are adapted for DDEV/Lando. │
└─────────────────────────────────────────────────────────┘
The flagship /drupal-boost:boost-feature command orchestrates a 7-phase workflow:
- Discovery — gather requirements from the user
- Exploration — parallel
drupal-exploreragents analyze the codebase - Clarifying Questions — fill knowledge gaps
- Architecture — parallel
drupal-architectagents propose multiple approaches - Implementation — build the chosen approach
- Quality Review — parallel
drupal-reviewer+drupal-security-auditoragents - Summary — files created, next steps, manual testing guidance
| Command | Description |
|---|---|
/drupal-boost:boost-feature |
Full 7-phase feature development workflow with parallel agents |
/drupal-boost:boost-module |
Guided multi-phase module scaffolding |
/drupal-boost:boost-theme |
Theme creation with Single Directory Component scaffolding |
/drupal-boost:boost-migration |
Guided migration builder with source analysis |
/drupal-boost:boost-recipe |
Scaffold a Drupal Recipe |
/drupal-boost:security-audit |
Comprehensive security audit with confidence scoring |
/drupal-boost:deploy-check |
Pre-deployment readiness check |
/drupal-boost:quality-check |
Run PHPCS + PHPStan + Drupal Check |
| Agent | Color | Model | Purpose |
|---|---|---|---|
drupal-explorer |
Blue | Haiku | Fast codebase analysis, traces services, hooks, routing, entities |
drupal-architect |
Green | Sonnet | Designs module/feature architectures with implementation blueprints |
drupal-reviewer |
Yellow | Sonnet | Code review for Drupal standards, DI patterns, deprecated APIs |
drupal-security-auditor |
Red | Sonnet | Deep security audit: XSS, SQL injection, access bypass, CSRF |
drupal-migration-analyst |
Magenta | Sonnet | Analyzes source data, maps to Drupal entities, generates migration YAML |
drupal-test-runner |
Cyan | Sonnet | Runs tests, analyzes failures, suggests and applies fixes |
Skills activate automatically when Claude detects relevant context:
| Skill | Triggers On |
|---|---|
module-scaffold |
Creating modules, services, plugins, controllers, forms, hooks, entities |
theme-development |
Theme, SDC, Twig, Starterkit, component work |
config-management |
Config export/import, Config Split, environment config |
recipes-api |
Drupal Recipes, site templates, automated setup |
rest-jsonapi |
REST, JSON:API, decoupled/headless architecture |
ddev-workflow |
DDEV, Lando, local dev environment, Xdebug, Solr, Redis |
quality-testing |
PHPUnit, PHPStan, PHPCS, Rector, Nightwatch |
drupal-security |
Security review, XSS, SQL injection, permissions |
deployment |
Deploy, CI/CD, GitHub Actions, GitLab CI |
migrate-api |
Data migration, ETL, source/process/destination plugins |
caching-strategy |
Cache tags, contexts, max-age, render caching, BigPipe |
contrib-publishing |
Publishing modules to drupal.org |
workspaces |
Content staging, editorial workflows |
| Event | Purpose |
|---|---|
SessionStart |
Detects Drupal version, DDEV/Lando environment |
PreToolUse (Write/Edit) |
Validates PSR-4 namespaces, .info.yml structure |
PreToolUse (Bash) |
Adapts commands for DDEV/Lando |
PostToolUse (Write/Edit) |
Checks Drupal coding standards |
| Environment | Status |
|---|---|
| DDEV | Fully supported |
| Lando | Fully supported |
- Drupal 11 (primary target)
- Drupal 10.3+ (most features)
- OOP Hook attributes require Drupal 11.1+
Plugin not activating skills? Skills are triggered by conversation context. Mention the topic explicitly (e.g., "I need to set up a migration from Drupal 7") to activate the relevant skill.
Hook scripts failing?
Ensure jq is installed (brew install jq on macOS, apt install jq on Ubuntu). Hook scripts require jq for JSON parsing.
DDEV/Lando not detected?
The SessionStart hook looks for .ddev/config.yaml or .lando.yml in your working directory. Make sure you launch Claude Code from the project root.
Commands not found?
Verify the plugin is installed with claude plugin list. If loading directly, ensure the path points to the plugin root directory containing .claude-plugin/plugin.json.
Namespace validation blocking writes?
The PreToolUse hook validates PSR-4 namespaces for files under modules/*/src/. If your project uses a non-standard module path, the validation will be skipped.
See CONTRIBUTING.md for guidelines on how to contribute to this plugin.
MIT