Objective
Move the shared Fast Forward GitHub Actions implementation from php-fast-forward/dev-tools into this organization-level .github repository, following the migration direction tracked in php-fast-forward/dev-tools#240.
Current Limitation
Consumer repositories receive thin workflow wrappers from dev-tools, but those wrappers currently call reusable workflows and composite actions hosted in php-fast-forward/dev-tools. That keeps organization automation coupled to the PHP CLI package repository and assumes consumers can run composer dev-tools from their own dependency graph.
That assumption is becoming weaker for extracted packages such as fast-forward/agents, which should be able to consume shared Fast Forward workflows without requiring fast-forward/dev-tools as a project dependency.
Proposed Work
Add the reusable workflow and composite action implementation to this repository, then introduce a dedicated setup action that guarantees the dev-tools CLI is available before shared workflows call it.
The setup action should prefer an already installed project-local dev-tools command when available, and otherwise install fast-forward/dev-tools globally through Composer with an explicit version/ref input. This lets existing repositories keep working while newly extracted repositories can use shared workflows without depending on dev-tools directly.
Scope
- Add reusable workflow files currently consumed by Fast Forward repository wrappers.
- Add composite actions required by those workflows.
- Add a dedicated action for installing or locating
fast-forward/dev-tools globally.
- Update copied workflow/action paths so reusable workflows resolve local actions from this repository instead of
php-fast-forward/dev-tools.
- Document the initial ownership split between
.github, dev-tools, and consumer repositories.
- Keep this issue focused on the
.github repository side of the migration; wrapper changes in dev-tools may be handled by a coordinated follow-up PR there.
Non-goals
Acceptance Criteria
Delivery Criteria
Regression Criteria
Architectural / Isolation Criteria
Objective
Move the shared Fast Forward GitHub Actions implementation from
php-fast-forward/dev-toolsinto this organization-level.githubrepository, following the migration direction tracked in php-fast-forward/dev-tools#240.Current Limitation
Consumer repositories receive thin workflow wrappers from
dev-tools, but those wrappers currently call reusable workflows and composite actions hosted inphp-fast-forward/dev-tools. That keeps organization automation coupled to the PHP CLI package repository and assumes consumers can runcomposer dev-toolsfrom their own dependency graph.That assumption is becoming weaker for extracted packages such as
fast-forward/agents, which should be able to consume shared Fast Forward workflows without requiringfast-forward/dev-toolsas a project dependency.Proposed Work
Add the reusable workflow and composite action implementation to this repository, then introduce a dedicated setup action that guarantees the
dev-toolsCLI is available before shared workflows call it.The setup action should prefer an already installed project-local
dev-toolscommand when available, and otherwise installfast-forward/dev-toolsglobally through Composer with an explicit version/ref input. This lets existing repositories keep working while newly extracted repositories can use shared workflows without depending ondev-toolsdirectly.Scope
fast-forward/dev-toolsglobally.php-fast-forward/dev-tools..github,dev-tools, and consumer repositories..githubrepository side of the migration; wrapper changes indev-toolsmay be handled by a coordinated follow-up PR there.Non-goals
dev-toolsin this repository.dev-toolsPHP command architecture.fast-forward/dev-toolstocomposer.jsonsolely to run shared workflows.Acceptance Criteria
Delivery Criteria
.github/workflows/contains the shared reusable workflow implementations needed by Fast Forward consumer wrappers..github/actions/contains the composite actions required by those workflows.fast-forward/dev-toolsand exposes a command path that workflows can use consistently.composer dev-toolsor related commands use the setup action first.dev-toolsversion/ref for branch-based testing..githubowns shared automation whiledev-toolsowns PHP CLI commands and consumer wrapper synchronization.Regression Criteria
php-fast-forward/dev-toolsonly to access.github/actions.php-fast-forward/dev-tools/.github/workflows/*@main.dev-toolssetup action can resolve an existing local command or prepare a global Composer installation path without requiring a consumer project dependency.Architectural / Isolation Criteria
dev-toolsPHP package ownership.