Skip to content

Create the initial Fast Forward agents package structure #1

@coisa

Description

@coisa

Objective

Create the initial fast-forward/agents package that will carry the packaged Fast Forward agent assets currently maintained under php-fast-forward/dev-tools.

Related parent work: php-fast-forward/dev-tools#195.

Current Limitation

The packaged .agents payload is still distributed from the dev-tools archive, which couples prompt and skill distribution to the main development-tools package. Consumer repositories need a stable installed path that Composer can manage directly.

Proposed Work

Introduce the initial repository structure for fast-forward/agents without changing dev-tools yet. The package should be prepared so a later dev-tools PR can require it and configure Composer installer paths instead of relying on linked or archived .agents content.

Scope

  • Copy the current .agents tree from php-fast-forward/dev-tools into this repository as the package payload.
  • Review the copied project agents and skills for assumptions that need to change now that the assets live in a standalone package.
  • Add Composer metadata for the fast-forward/agents package, including the custom installer package type expected by [agents] Extract packaged agents into fast-forward/agents and install via composer installer-paths dev-tools#195.
  • Add the standard Fast Forward repository files and automation needed for a package repository: README, changelog, license metadata, git attributes/ignore rules, CI workflows, and dev-tools configuration where applicable.
  • Document the expected consumer installation path, including the Composer extra.installer-paths shape that installs the package into .agents/{$name}/.

Non-goals

  • Do not change php-fast-forward/dev-tools in this issue.
  • Do not update consumer repositories in this issue.
  • Do not redesign the agent or skill content beyond minimal standalone-package compatibility fixes.
  • Do not publish implementation changes directly to main; deliver the initial structure through a pull request.

Acceptance Criteria

Delivery Criteria

  • The repository contains the copied .agents payload from php-fast-forward/dev-tools.
  • composer.json declares fast-forward/agents with the agreed Composer package type for Fast Forward agent bundles.
  • The package layout supports installation through Composer installer paths such as .agents/{$name}/ for packages of that custom type.
  • README or docs explain the package purpose, expected installer path configuration, and relationship to [agents] Extract packaged agents into fast-forward/agents and install via composer installer-paths dev-tools#195.
  • Copied agents and skills are reviewed for standalone-package path assumptions, with required compatibility changes included or explicitly documented.
  • Standard repository automation and metadata are present and match Fast Forward package conventions where they apply to a prompt/agent asset package.
  • Verification covers Composer metadata validity and any applicable repository quality checks.

Architectural / Isolation Criteria

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    Status

    In progress

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions