Use when
- Starting or resuming a work session on a Symfony project.
- Routine tasks: migrations, fixtures, consuming messages, clearing the cache.
- Debugging with
debug:*commands, the profiler, and the logs. - Getting a change ready to commit.
Default workflow
- Sync: pull, run
composer installwhen the lock file changed, apply pending migrations. - Start the services the project uses and check
bin/console about. - Work in small test-first cycles with the project's test runner.
- Debug with
debug:*commands, the profiler andvar/log/dev.logbefore adding dumps. - Before committing, run style, static analysis and tests, and remove every
dump()anddd().
Guardrails
- Prefix commands with the runner the project uses (Docker or host), from the runtime context.
- Never load fixtures or reset the schema on a shared or production database.
- Do not commit
dump(),dd()or debug-only code. - Do not patch
vendor/to work around a problem.
Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.
Output contract
- The commands run, with the project's runner prefix.
- Debugging findings, with the evidence behind them.
- A change ready to commit, quality gates green.
References
reference.md