Repository navigation
Description
Story
As a pr-review maintainer,
I want commit a versioned consumer-manifest.json that enumerates each consumer repo and, per shared surface (reusable workflow path, scripts/lib/ library, prompts/ file), which consumers depend on it, plus a validator that keeps it well-formed,
so that downstream-impact detection has a single, ground-truthed source of truth to map changed files to impacted consumers.
Acceptance Criteria
- A committed
consumer-manifest.jsonlists each consumer repo (owner/name) and asurfacesmap keyed by a.github-privatepath (e.g..github/workflows/pr-review.yml,scripts/lib/ci-status.sh,prompts/triage.md) to the list of consumer repos that reference it. - The manifest's consumer set is grounded in the repo's authoritative release strategy, not guessed: each listed consumer is justified by a citation (the ring listing in
docs/initiatives/agentic-release-strategy.mdand/or thepr-review.ymlconsumer references), and any consumer whose dependency could not be confirmed is recorded under an explicitunverifiedfield rather than asserted. - A JSON Schema (
consumer-manifest.schema.json) constrains the manifest shape (required keys, string formats forowner/name, surface paths relative to repo root) and a validator script exits non-zero with a clear message on a malformed manifest, unknown top-level keys, or a surface path that does not resolve in the working tree. - Every surface path listed in the manifest resolves to an existing file in
.github-private(no dangling surface entries). - A
batstest covers: a valid manifest passes; a malformed manifest (missing required key) fails; a manifest naming a non-existent surface path fails.
Tasks / Subtasks
- Place the manifest at a clear home (
scripts/pr-review/consumer-manifest.jsonrecommended, parallel toscripts/initiative-planner/) and the schema alongside it. (AC: test issue from agent #1, Add @claude delegation, auto-merge, and rebase handling #3)- Enumerate shared surfaces: first-party reusable workflows callable by consumers, libs under
scripts/lib/, and consumer-facing files underprompts/. - Populate the surface->consumers map from grounded evidence only.
- Enumerate shared surfaces: first-party reusable workflows callable by consumers, libs under
- Resolve the consumer-set discrepancy by citing the authoritative ring listing; record any unconfirmed consumer under
unverifiedinstead of asserting a dependency. (AC: Go-live improvements for PR review agent #2) - Write
consumer-manifest.schema.jsonand a validator (consistent withscripts/initiative-planner/validate-plan.py) that checks schema conformance AND that every surface path resolves on disk. (AC: Add @claude delegation, auto-merge, and rebase handling #3, Optimize review: small-PR and incremental fast paths #4) - Add
tests/test_consumer_manifest.batsand register it in theRun testsstep of.github/workflows/lint.yml(explicit list — NOT a glob). (AC: feat: add Copilot engine support via REVIEW_ENGINE toggle #5)
Dev Notes
- Source of truth for the consumer set:
docs/initiatives/agentic-release-strategy.mdlists consumers asbmad-bgreat-suite, google-app-scripts, markets, ContentTwin; the discussion text listsBroodly, TalkTerm, markets, google-app-scripts. These DISAGREE — do not silently pick one. Ground each listed consumer in a citation; park anything unconfirmed underunverified. See open_questions. - Shared surfaces to enumerate: (a) first-party reusable workflows consumers pin to (e.g.
pr-review.yml, the dev-lead reusable,ci-failure-analyst-reusable.yml); (b) libs underscripts/lib/(e.g.ci-status.sh,review-cycle.sh,advisory-review-gate.sh); (c) consumer-facing prompt files underprompts/. Only list a surface if a consumer plausibly references it. - Validation pattern to mirror:
scripts/initiative-planner/validate-plan.py(structural JSON-Schema check + extra semantic invariants) and its registration inlint.yml. Prefer a small, dependency-light validator; the lint job already installsjsonschema>=4. - Testing standard: bats tests live in
tests/and MUST be added to the explicit list in.github/workflows/lint.yml'sRun testsstep or they never run in CI. Model aftertests/test_oversized_pr.bats(setup +run+ status assertions). Lint runsshellcheck --severity=warning -xover shell files — honor# shellcheck source=...directives. - Keep the manifest minimal and declarative; richer per-surface metadata (e.g. which consumer file references it) is added by Story 3 only if needed for the fetch.
Project Structure Notes
No existing consumer manifest or deploy workflow exists in this repo (the consumer-facing deploy lives elsewhere per the release-strategy doc). Place the manifest + schema + validator under a clear home (scripts/pr-review/ recommended, parallel to scripts/initiative-planner/). This is the data foundation for the entire epic.
References
- docs/initiatives/agentic-release-strategy.md#1-executive-summary
- .github/workflows/pr-review.yml
- scripts/lib/ci-status.sh
- scripts/initiative-planner/validate-plan.py
- .github/workflows/lint.yml#Run-tests
- tests/test_oversized_pr.bats
Likely target surface
scripts/pr-review/consumer-manifest.jsonscripts/pr-review/consumer-manifest.schema.jsonscripts/pr-review/validate-consumer-manifest.shtests/test_consumer_manifest.bats.github/workflows/lint.yml
Story prepared by the BMAD Scrum Master (Bob) for epic #727. Status: ready-for-dev.
Activity
github-actions commentedon Jun 15, 2026
Superseded by the re-planned initiative epic #748 (re-planned from idea discussion #653).