Skip to documentation

Common Workflows

Most day-to-day work falls into one of the flows below.

Goal Command What happens
Check everything before a pull request composer dev-tools Runs refactor , phpdoc , code-style , and reports in order.
Auto-fix what can be changed safely composer dev-tools:fix Passes --fix through the supported subcommands.
Refresh only test results composer tests Runs PHPUnit with the resolved phpunit.xml .
Refresh only the documentation site composer docs Runs phpDocumentor using PSR-4 namespaces and the docs/ guide.
Record a notable pull-request change cpx --skip-local fast-forward/changelog:0.2.0 add "Describes the change." --no-interaction Creates one independent change fragment using the external CPX runtime.
Refresh packaged agent skills only composer skills Creates or repairs symlinks in .agents/skills .
Refresh packaged project agents only composer agents Creates or repairs symlinks in .agents/agents .
Trigger a rigorous review pass for a ready pull request Mark the pull request ready for review or run review.yml manually Posts a deterministic review brief that points maintainers to the review-guardian agent and pull-request-review skill.
Inspect the next release cpx --skip-local fast-forward/changelog:0.2.0 status --source=tags --no-interaction Plans from pending fragments; the managed version PR consolidates them for review. Merging the reviewed managed version PR automatically publishes its tag and GitHub Release at the approved commit.
Publish local automation defaults into a consumer repository composer dev-tools:sync Updates scripts, copies missing automation assets, and refreshes packaged skills and packaged agents.
Regenerate wiki pages composer wiki Builds Markdown API pages in .github/wiki by default; normal sync explicitly uses .dev-tools/wiki-generated without a submodule.

Choose the Right Entry Point

Use composer ... when you want the same command vocabulary across repositories.

Use vendor/bin/dev-tools ... when you need to pass several options and want to avoid Composer's -- forwarding rules.

A Safe Beginner Routine

  1. Run composer tests .
  2. Run cpx --skip-local fast-forward/changelog:0.2.0 add with a description when the branch introduces a notable change (requires CPX and PHP 8.5); then run cpx --skip-local fast-forward/changelog:0.2.0 check .
  3. Run composer skills if you changed packaged consumer skills.
  4. Run composer agents if you changed packaged project-agent prompts.
  5. Run composer docs if you changed guides or public APIs.
  6. Run composer dev-tools:fix when you want automated help.
  7. Run composer dev-tools before pushing.
Search results