feature-workflow

Feature Workflow

A gated, phased procedure for non-trivial Drupal development tasks. The goal is that no step is skipped and no task is declared done without evidence (passing checks, exported config, green tests).

When this activates

• Building or extending a custom module or theme
• Adding routes, forms, controllers, services, or plugins
• Changing entity structure, fields, or database schema
• Any change spanning multiple files or subsystems

Task classification (do this first)

Before starting, classify the task and adjust rigor:

Class	Signal	Rigor
tiny-fix	Typo, comment, CSS tweak, single-line change	Stop — use the tiny-fix skill instead
standard	New feature, refactor, multi-file change	All phases below
security-sensitive	Touches routing, forms, user input, DB queries, permissions, file handling	All phases below + mandatory security pass in Phase 3
schema-touching	Changes entity definitions, fields, or DB schema	All phases below + update hook requirement in Phase 2

Phase 1 — Plan

1. Restate the requirement in one or two sentences. If ambiguous, ask before coding.
2. List the files and Drupal subsystems that will change (routing, services, config schema, hooks, plugins).
3. Identify config entities the change will create or modify — these must be exported before the task is done.
4. For multisite codebases: list every site that shares the affected module and note the impact.

Exit condition: a short written plan exists in the conversation. No code yet.

Phase 2 — Implement

1. Follow Drupal 11 coding standards. If the drupal-module-development skill (drupal-dev-tools plugin) is available, apply it; otherwise follow core conventions: dependency injection over \Drupal:: static calls in OOP code, typed config schema for new config, declare(strict_types=1) where the codebase uses it.
2. Schema-touching tasks: every entity/field/schema change ships with a matching hook_update_N() or hook_post_update_NAME() in the same changeset. An update hook must be idempotent.
3. New config objects get a config/schema/*.schema.yml entry.
4. Keep scope: do not refactor code the task did not ask for. Note improvement opportunities instead of applying them.