module-dev-starter

What problem does it solve?

It eliminates the repetitive setup work required to create a new Drupal contrib module workspace (directories, Claude docs, and DDEV configuration) so you can start developing and validating changes quickly.

Core Features & Use Cases

• Scaffold base Claude worktree structure: Runs the generic admin scaffold to initialize the target project layout and core Claude files in an idempotent way.
• Add Drupal-specific workspace essentials: Creates Drupal-oriented directories (like issue analysis reports and test scaffolding) and appends a Drupal contrib section to the target CLAUDE.md when missing.
• Provision a ready-to-run DDEV environment: Configures and starts a DDEV Drupal project using the contrib addon, runs poser and symlinks the project, and marks scaffold completion so subsequent sessions stop prompting.
• Verification and guardrails: After setup, runs ddev phpunit (when configured) and reminds you to keep worktrees/main clean by creating issue worktrees first.
• Common use case: When you are starting a new Drupal contrib module, this sets up an environment where your tests and Drupal workflows work immediately instead of being assembled manually.

Quick Start

Ask your agent to scaffold a Drupal contrib module project at your chosen target directory using drupal-lab:module-dev-starter.