drupal-meta-skills

Drupal planner-critic-executor bundle for Claude Code.

Visual Explainer
This repo consolidates the work that previously lived across drupal-planner and drupal-critic, plus the drupal-config-executor generation step.

Why this bundle exists

Drupal work breaks when planning, implementation, and review are disconnected.

• Entity structures are expensive to reverse after content exists.
• Cache tags, contexts, and max-age decisions are easy to get “mostly right” and still ship stale or personalized content bugs.
• Config workflow mistakes often look fine locally and fail on deploy.
• Teams reimplement contrib behavior as custom code because the evaluation happened too late or not at all.
• Migration and update-path mistakes are usually discovered after real data is at risk.

This bundle closes that loop:

1. Plan the architecture before implementation.
2. Generate config YAML from planner output when that artifact should be deterministic.
3. Review the result with Drupal-specific rigor rather than generic code review heuristics.

What’s in the bundle

drupal-planner

drupal-planner is the architecture surface for full Drupal implementations. It covers:

1. Scope and context
2. Existing architecture analysis
3. Data model design
4. Module architecture
5. Configuration schema
6. Permission and access model
7. Cache strategy
8. Migration and update path
9. Theme and render design
10. Implementation tasks and review checkpoints

It also ships focused sub-planners:

• /drupal-planner.content-model
• /drupal-planner.taxonomy
• /drupal-planner.theme
• /drupal-planner.canvas
• /drupal-planner.search

Use the main planner for full features or cross-cutting work. Use sub-planners when the scope is clearly limited to one subsystem.

drupal-critic

drupal-critic is the review surface. It layers Drupal-specific checks on top of a structured investigation protocol so reviews do not stop at generic code quality commentary.

It checks Drupal-specific dimensions such as:

• security
• architecture and contrib-first decisions
• operational safety
• configuration workflow stability
• cache correctness
• migration idempotency
• site builder and editor experience
• testing adequacy

It also activates context-driven perspectives such as Open Source Contributor, Site Builder, and Content Editor when the review target warrants them.

drupal-config-executor

drupal-config-executor is the deterministic generation step between planning and review. It consumes structured planner output and produces Drupal config YAML for cases like:

• content types
• fields and field storage
• form and view displays
• taxonomy structures
• Search API and facet configuration

Commands

• /drupal-planner
• /drupal-planner.content-model
• /drupal-planner.taxonomy
• /drupal-planner.theme
• /drupal-planner.canvas
• /drupal-planner.search
• /drupal-critic
• /drupal-config-executor

How the workflow fits together

1. Use /drupal-planner or the appropriate sub-planner to design the architecture.
2. Use /drupal-config-executor when you need YAML generated from the planner spec.
3. Use /drupal-critic to review the implementation or generated artifacts.

This is the core bundle workflow:

drupal-planner.* -> drupal-config-executor -> drupal-critic

And for full-feature planning:

drupal-planner -> implementation -> drupal-critic

Install

npx claude-skills add https://github.com/zivtech/drupal-meta-skills

Manual install:

git clone https://github.com/zivtech/drupal-meta-skills.git
cp -r drupal-meta-skills/.claude/skills/* ~/.claude/skills/
cp drupal-meta-skills/.claude/agents/*.md ~/.claude/agents/

Quick examples

Full feature planning

/drupal-planner Plan a product review system with ratings, moderation, and search

Content model planning

/drupal-planner.content-model Redesign our content model for landing pages, blogs, and case studies

Theme planning

/drupal-planner.theme Plan theme architecture for a Drupal 11 site using SDC

Canvas component planning

/drupal-planner.canvas Plan Canvas Code Component architecture for a Drupal CMS events site

Search planning

/drupal-planner.search Plan search for a 100k+ article content site with facets

Review

/drupal-critic web/modules/custom/my_module/

Config generation

/drupal-config-executor Generate config YAML from this drupal-planner.content-model spec

Repository Layout

.claude/
  agents/
  skills/
docs/
research/
scripts/
templates/
.github/workflows/

Root .claude/ assets are the installable skill and agent files. research/ and scripts/ carry over the Drupal ecosystem and supply-chain tooling that supports the critic.

License

GPL-3.0-or-later. See LICENSE.