https://github.com/abderrahimghazali/drupal-boost
The most comprehensive Drupal 11 development toolkit for Claude Code. Module scaffolding, theme development, configuration management, migration, security auditing, testing, deployment, and more.
https://github.com/abderrahimghazali/drupal-boost
claude-code claude-code-plugin ddev drupal drupal-development drupal-module drupal-theme drupal11 lando php
Last synced: 7 days ago
JSON representation
The most comprehensive Drupal 11 development toolkit for Claude Code. Module scaffolding, theme development, configuration management, migration, security auditing, testing, deployment, and more.
- Host: GitHub
- URL: https://github.com/abderrahimghazali/drupal-boost
- Owner: abderrahimghazali
- License: mit
- Created: 2026-03-22T19:41:51.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T21:51:25.000Z (2 months ago)
- Last Synced: 2026-03-29T00:51:11.393Z (2 months ago)
- Topics: claude-code, claude-code-plugin, ddev, drupal, drupal-development, drupal-module, drupal-theme, drupal11, lando, php
- Language: Shell
- Size: 122 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# drupal-boost
The most comprehensive Drupal 11 development toolkit for Claude Code. Module scaffolding, theme development, configuration management, migration, security auditing, testing, deployment, and more.
## Table of Contents
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [How It Works](#how-it-works)
- [Commands](#commands)
- [Agents](#agents)
- [Skills](#skills)
- [Hooks](#hooks)
- [Environment Support](#environment-support)
- [Drupal Compatibility](#drupal-compatibility)
- [Troubleshooting](#troubleshooting)
- [Contributing](#contributing)
- [License](#license)
## Requirements
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI v1.0+
- `jq` installed (used by hook scripts for JSON processing)
- For full functionality within a Drupal project:
- PHP 8.2+ (Drupal 11 requirement)
- Composer
- A Drupal 10.3+ or 11.x project
- Optionally: [DDEV](https://ddev.readthedocs.io/) or [Lando](https://lando.dev/) for local development
## Installation
```bash
claude plugin install drupal-boost
```
Or load directly:
```bash
claude --plugin-dir ./drupal-boost
```
## Quick Start
```
/drupal-boost:boost-module my_module "Custom content management module"
/drupal-boost:security-audit
/drupal-boost:quality-check
```
## How It Works
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:
1. **Discovery** — gather requirements from the user
2. **Exploration** — parallel `drupal-explorer` agents analyze the codebase
3. **Clarifying Questions** — fill knowledge gaps
4. **Architecture** — parallel `drupal-architect` agents propose multiple approaches
5. **Implementation** — build the chosen approach
6. **Quality Review** — parallel `drupal-reviewer` + `drupal-security-auditor` agents
7. **Summary** — files created, next steps, manual testing guidance
## Commands
| 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 |
## Agents
| 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 (Auto-Triggered)
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 |
## Hooks
| 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 Support
| Environment | Status |
|-------------|--------|
| DDEV | Fully supported |
| Lando | Fully supported |
## Drupal Compatibility
- Drupal 11 (primary target)
- Drupal 10.3+ (most features)
- OOP Hook attributes require Drupal 11.1+
## Troubleshooting
**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.
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute to this plugin.
## License
MIT