Skip to content

consumer-automation.rst

Latest commit

 

History

History
56 lines (45 loc) · 1.89 KB

consumer-automation.rst

File metadata and controls

56 lines (45 loc) · 1.89 KB

Consumer Automation

FastForward DevTools plays two roles at once:

  • producer: this repository ships reusable workflow templates and default configuration files;
  • consumer helper: the dev-tools:sync command copies those assets and links packaged skills into other Fast Forward libraries.

Reusable Workflows Versus Consumer Stubs

Location Role
.github/workflows/*.yml Reusable workflows implemented in this repository.
resources/github-actions/*.yml Small consumer stubs that call the reusable workflows through workflow_call.
.github/dependabot.yml This repository's own Dependabot configuration.
resources/dependabot.yml Template copied into consumer repositories.
.agents/skills/* Packaged agent skills linked into consumer repositories by the skills command.
.github/wiki Generated Markdown API documentation locally and wiki submodule content in consumer repositories.

How GitHub Pages Publishing Works

  • .github/workflows/reports.yml runs composer dev-tools reports.
  • The workflow uploads public/ as the Pages artifact.
  • On the main branch, GitHub Pages serves the generated site.

How Wiki Publishing Works

  • .github/workflows/wiki.yml runs composer dev-tools wiki -- --target=.github/wiki.
  • The workflow commits the wiki submodule contents.
  • The parent repository then commits the updated submodule pointer.

Producer Impact

Any change to resources/github-actions, resources/dependabot.yml, .agents/skills, .github/workflows, or FastForward\DevTools\Console\Command\SyncCommand changes the default onboarding story for every consumer library.