Skip to content

Instantly share code, notes, and snippets.

@bmoex

bmoex/AGENTS.md

Last active February 17, 2026 12:30
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save bmoex/bcf5bfc9612f03798ceb62a5be1385f6 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save bmoex/bcf5bfc9612f03798ceb62a5be1385f6 to your computer and use it in GitHub Desktop.
Download ZIP
DDEV local development guidelines
Raw
AGENTS.md

DDEV local development

  • A project can run inside DDEV Docker containers if ./.ddev/ folder is in project root.
  • You MUST execute all commands through DDEV when available.
  • ALWAYS check if DDEV is available in the current project folder FIRST with ddev --version before attempting any commands.
  • Only use DDEV if the .ddev folder exists in the current project.
  • Prioritize running ddev describe to check service status BEFORE running ddev start.
    • Use ddev describe to validate if services are running
    • Only run ddev start if services are not running or if explicitly needed
  • Stop services using ddev stop.
  • Open the application in the browser by running ddev launch [path, ex: /login].
    • Always prefix PHP, Artisan, Composer, and Node commands with ddev. Examples:
    • Run Artisan Commands: ddev artisan
    • Install Composer packages: ddev composer install
    • Execute Node commands: ddev exec npm run dev
    • Execute PHP scripts: ddev php [script]
  • View all available DDEV commands by running ddev without arguments.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment