{
  "markdown": "# drupal-boost\n\nThe most comprehensive Drupal 11 development toolkit for Claude Code. Module scaffolding, theme development, configuration management, migration, security auditing, testing, deployment, and more.\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Installation](#installation)\n- [Quick Start](#quick-start)\n- [How It Works](#how-it-works)\n- [Commands](#commands)\n- [Agents](#agents)\n- [Skills](#skills)\n- [Hooks](#hooks)\n- [Environment Support](#environment-support)\n- [Drupal Compatibility](#drupal-compatibility)\n- [Troubleshooting](#troubleshooting)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Requirements\n\n- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI v1.0+\n- `jq` installed (used by hook scripts for JSON processing)\n- For full functionality within a Drupal project:\n  - PHP 8.2+ (Drupal 11 requirement)\n  - Composer\n  - A Drupal 10.3+ or 11.x project\n  - Optionally: [DDEV](https://ddev.readthedocs.io/) or [Lando](https://lando.dev/) for local development\n\n## Installation\n\n```bash\nclaude plugin install drupal-boost\n```\n\nOr load directly:\n\n```bash\nclaude --plugin-dir ./drupal-boost\n```\n\n## Quick Start\n\n```\n/drupal-boost:boost-module my_module \"Custom content management module\"\n/drupal-boost:security-audit\n/drupal-boost:quality-check\n```\n\n## How It Works\n\ndrupal-boost operates on a 3-tier architecture that combines automatic detection, contextual skills, and user-invoked workflows:\n\n```\n┌─────────────────────────────────────────────────────────┐\n│  Tier 1: AUTOMATIC                                      │\n│  SessionStart hook detects Drupal version, DDEV/Lando,  │\n│  PHP version, Composer, and Drush availability.         │\n├─────────────────────────────────────────────────────────┤\n│  Tier 2: SKILLS (Auto-Triggered)                        │\n│  13 skills activate based on conversation context.      │\n│  Ask about migrations → migrate-api skill loads.        │\n│  Ask about caching → caching-strategy skill loads.      │\n├─────────────────────────────────────────────────────────┤\n│  Tier 3: COMMANDS (User-Invoked)                        │\n│  8 slash commands for multi-phase workflows.            │\n│  /boost-feature runs a full 7-phase dev cycle.          │\n├─────────────────────────────────────────────────────────┤\n│  Cross-cutting: HOOKS                                   │\n│  Every Write/Edit is validated for PSR-4 namespaces,    │\n│  .info.yml structure, and Drupal coding standards.      │\n│  Bash commands are adapted for DDEV/Lando.              │\n└─────────────────────────────────────────────────────────┘\n```\n\nThe flagship `/drupal-boost:boost-feature` command orchestrates a 7-phase workflow:\n\n1. **Discovery** — gather requirements from the user\n2. **Exploration** — parallel `drupal-explorer` agents analyze the codebase\n3. **Clarifying Questions** — fill knowledge gaps\n4. **Architecture** — parallel `drupal-architect` agents propose multiple approaches\n5. **Implementation** — build the chosen approach\n6. **Quality Review** — parallel `drupal-reviewer` + `drupal-security-auditor` agents\n7. **Summary** — files created, next steps, manual testing guidance\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/drupal-boost:boost-feature` | Full 7-phase feature development workflow with parallel agents |\n| `/drupal-boost:boost-module` | Guided multi-phase module scaffolding |\n| `/drupal-boost:boost-theme` | Theme creation with Single Directory Component scaffolding |\n| `/drupal-boost:boost-migration` | Guided migration builder with source analysis |\n| `/drupal-boost:boost-recipe` | Scaffold a Drupal Recipe |\n| `/drupal-boost:security-audit` | Comprehensive security audit with confidence scoring |\n| `/drupal-boost:deploy-check` | Pre-deployment readiness check |\n| `/drupal-boost:quality-check` | Run PHPCS + PHPStan + Drupal Check |\n\n## Agents\n\n| Agent | Color | Model | Purpose |\n|-------|-------|-------|---------|\n| `drupal-explorer` | Blue | Haiku | Fast codebase analysis, traces services, hooks, routing, entities |\n| `drupal-architect` | Green | Sonnet | Designs module/feature architectures with implementation blueprints |\n| `drupal-reviewer` | Yellow | Sonnet | Code review for Drupal standards, DI patterns, deprecated APIs |\n| `drupal-security-auditor` | Red | Sonnet | Deep security audit: XSS, SQL injection, access bypass, CSRF |\n| `drupal-migration-analyst` | Magenta | Sonnet | Analyzes source data, maps to Drupal entities, generates migration YAML |\n| `drupal-test-runner` | Cyan | Sonnet | Runs tests, analyzes failures, suggests and applies fixes |\n\n## Skills (Auto-Triggered)\n\nSkills activate automatically when Claude detects relevant context:\n\n| Skill | Triggers On |\n|-------|-------------|\n| `module-scaffold` | Creating modules, services, plugins, controllers, forms, hooks, entities |\n| `theme-development` | Theme, SDC, Twig, Starterkit, component work |\n| `config-management` | Config export/import, Config Split, environment config |\n| `recipes-api` | Drupal Recipes, site templates, automated setup |\n| `rest-jsonapi` | REST, JSON:API, decoupled/headless architecture |\n| `ddev-workflow` | DDEV, Lando, local dev environment, Xdebug, Solr, Redis |\n| `quality-testing` | PHPUnit, PHPStan, PHPCS, Rector, Nightwatch |\n| `drupal-security` | Security review, XSS, SQL injection, permissions |\n| `deployment` | Deploy, CI/CD, GitHub Actions, GitLab CI |\n| `migrate-api` | Data migration, ETL, source/process/destination plugins |\n| `caching-strategy` | Cache tags, contexts, max-age, render caching, BigPipe |\n| `contrib-publishing` | Publishing modules to drupal.org |\n| `workspaces` | Content staging, editorial workflows |\n\n## Hooks\n\n| Event | Purpose |\n|-------|---------|\n| `SessionStart` | Detects Drupal version, DDEV/Lando environment |\n| `PreToolUse (Write/Edit)` | Validates PSR-4 namespaces, .info.yml structure |\n| `PreToolUse (Bash)` | Adapts commands for DDEV/Lando |\n| `PostToolUse (Write/Edit)` | Checks Drupal coding standards |\n\n## Environment Support\n\n| Environment | Status |\n|-------------|--------|\n| DDEV | Fully supported |\n| Lando | Fully supported |\n\n## Drupal Compatibility\n\n- Drupal 11 (primary target)\n- Drupal 10.3+ (most features)\n- OOP Hook attributes require Drupal 11.1+\n\n## Troubleshooting\n\n**Plugin not activating skills?**\nSkills 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.\n\n**Hook scripts failing?**\nEnsure `jq` is installed (`brew install jq` on macOS, `apt install jq` on Ubuntu). Hook scripts require `jq` for JSON parsing.\n\n**DDEV/Lando not detected?**\nThe SessionStart hook looks for `.ddev/config.yaml` or `.lando.yml` in your working directory. Make sure you launch Claude Code from the project root.\n\n**Commands not found?**\nVerify 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`.\n\n**Namespace validation blocking writes?**\nThe 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.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to contribute to this plugin.\n\n## License\n\nMIT\n",
  "bytes": 7337,
  "sha": "bbe8f214f2efabd9cc53b0a49e661652607cead5a690d2f07c9ce70cf1188605",
  "repo_slug": "abderrahimghazali/drupal-boost",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_abderrahimghazali_drupal_boost_drupal_bo_a0c6e1e7/readme"
}