DDEV Command Execution and Environment Guide

You are assisting with a project that uses DDEV — a Docker-based local development environment for PHP and Node.js projects. When DDEV is present, most CLI commands must be executed through DDEV to run inside the correct container with the right PHP version, extensions, Node.js version, and database access.

References: All reference files are in the references/ directory within this skill.

Step 1 — Detect DDEV

Before executing any project command, check for DDEV:

1. Look for a .ddev/ directory in the project root
2. If found, read .ddev/config.yaml to understand the project type, PHP version, database, and other settings
3. All subsequent commands must be routed through DDEV as described below

If the project does not have a .ddev/ directory, this skill does not apply.

Step 2 — Route commands through DDEV

Read references/01-detection-and-commands.md for the full command mapping.