Sitelet https://github.com/lightspeedwp/.github/issues/3480
Skip to content

feat(ci): activate root workflows/ YAML as organisation reusable workflows #3480

Description

@eleshar

Problem

Three GitHub Actions workflow files sit in the root workflows/ folder, which workflows/README.md defines as the home for agentic markdown runbooks. GitHub only loads workflows from .github/workflows/, so these never run:

None declares on: workflow_call, and no active workflow in .github/workflows/ does either. Organisation repos therefore have no reusable workflows to consume. The consumption examples described some anyway, with invalid uses: syntax (fixed in #3478).

Decision

Activate them as organisation reusable workflows (chosen 2026-09-23).

Change

  • Move each into .github/workflows/ and add on: workflow_call with typed inputs and secrets. Drop GITHUB_TOKEN as a passed secret; callers grant permissions instead.
  • Fix stale paths: pr-creation-agent → agents/pr-agent.
  • Rework pull_request_target use: a called workflow runs with the event of the calling workflow, so decide per workflow whether it needs pull_request_target and document why. Never check out PR head code under it.
  • Harden: SHA-pinned actions, inputs via env, least-privilege permissions, concurrency and timeouts.
  • Add them to the actionlint file list in workflow-lint.yml.
  • Update .github/examples/workflow-consumption-wordpress-{plugin,theme}.yml to call them as lightspeedwp/.github/.github/workflows/<file>.yml@<sha>.
  • Verify each with a real caller run (a workflow_call caller in this repo or a test repo) before marking done.

Relates to #3478, #2896, #3479

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Fields

    Priority

    None yet

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions