process-lifecycle

Manage DDEV lifecycle for Drupal worktrees with readiness checks and completion gates.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/cosmicdreams/claude-plugins --skill process-lifecycle-cosmicdreams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-lifecycle
Source: https://github.com/cosmicdreams/claude-plugins/tree/main/drupal-lab/skills/process-lifecycle
Command: npx skills add https://github.com/cosmicdreams/claude-plugins --skill process-lifecycle-cosmicdreams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted time and broken Drupal work by ensuring the DDEV environment in each worktree is correctly bootstrapped, fully ready, and properly released when work is done.

Core Features & Use Cases

  • DDEV lifecycle orchestration for worktrees: Starts DDEV for a specific worktree, runs dependency installation, and enforces orderly completion and shutdown.
  • Readiness gating before development work: Checks container status, PHP version, database access, Chrome webdriver availability, and vendor dependencies to avoid mid-task failures.
  • Completion and failure handling: Requires quality gates (coding standards, static analysis, tests) and supports error recovery and stuck detection patterns.

Quick Start

Use the process-lifecycle skill when you need to start DDEV for a Drupal worktree, confirm it is ready for development or tests, and then shut it down at the end of the work.

Frequently Asked Questions about process-lifecycle

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate DDEV startup and shutdown for Drupal worktrees?

Automating DDEV lifecycle for Drupal worktrees involves starting the environment, enforcing readiness checks, and executing orderly shutdown procedures. This requires resolving the project root from configuration files and using worktree-relative paths to manage container instances.

What readiness checks should I run before testing in a DDEV environment?

Readiness gating for DDEV environments requires checking container status, PHP version, database access, Chrome webdriver availability, and vendor dependencies. These checks prevent mid-task failures and ensure the environment is fully operational before development or test execution begins.

Can I enforce quality gates before shutting down a Drupal DDEV environment?

Enforcing completion criteria before DDEV shutdown requires running coding standards checks, static analysis, and tests as quality gates. The lifecycle process supports error recovery and stuck detection patterns to handle failures and ensure resources are cleaned up properly after work completes.

Why does my DDEV environment get stuck during Drupal worktree bootstrapping?

DDEV environments can get stuck during worktree bootstrapping due to unresolved project root paths, missing dependency installation, or container instance slot conflicts. The lifecycle process includes stuck detection patterns and phase-based execution recovery to resolve these issues and ensure proper environment initialization.

Does DDEV lifecycle management work with multiple Drupal worktrees simultaneously?

Managing multiple Drupal worktrees simultaneously requires guarding DDEV instance slots and using worktree-relative paths to isolate environments. The lifecycle process coordinates phase-based execution across separate worktrees, ensuring each environment is independently bootstrapped, validated, and released.

What are the limitations of automating DDEV container shutdown for Drupal development?

Automating DDEV container shutdown requires resolving the project root from configuration files and enforcing completion criteria. Limitations include dependency on environment readiness checks and the need for error recovery mechanisms to handle stuck detection patterns during phase-based execution and resource cleanup.