executing-commands

Repository Execution Rules

Execution Model

All project commands MUST be executed via the Taskfile. Agents MUST NOT call Docker Compose commands directly.

Never run directly on the host (outside task):

• php
• npm
• node
• composer
• docker compose
• docker

Always use:

task <task-name>

To list all available tasks, use:

task --list

If a task does not exist:

1. Inspect the Taskfile.
2. Prefer creating or extending a task.
3. As a temporary fallback, use task dc:run -- php <command> unless another service is explicitly required. This still executes via the Taskfile.

Container Context

The default execution service is php.

All standard development commands run inside the Docker Compose service php.

Only use another service if:

• the user explicitly instructs it, or
• the command explicitly references that service.

If a command fails because services are not running, run:

task up

Then retry the original command.

To check if services are running, use:

task ps

Examples

Run tests:

task test

Install dependencies:

task composer:install

Run npm:

task dc:run -- php npm install