Skip to content

feat: enroll .github in the idea→initiative pipeline + document caller stubs#504

Merged
don-petry merged 3 commits into
mainfrom
feat/enroll-github-idea-pipeline
Jun 21, 2026
Merged

feat: enroll .github in the idea→initiative pipeline + document caller stubs#504
don-petry merged 3 commits into
mainfrom
feat/enroll-github-idea-pipeline

Conversation

@don-petry

@don-petry don-petry commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Two things, both finishing the fleet-enablement initiative (petry-projects/.github-private#817):

  1. Pilot enrollment (S8 #825): adopt the initiative-planner caller stub on petry-projects/.github itself. On idea:approved (added by a trusted maintainer) it dispatches the central BMAD Scrum Master in .github-private with .github as target_repo, materializing an inert epic + story DAG here. This is the first end-to-end cross-repo validation of the fleet path (target_repo ≠ .github-private, writing via GH_PAT_WORKFLOWS).

  2. Docs (S8 #825 / S7 #824): ci-standards.md §10 documents the three caller stubs, the thin-stub→dispatch-reusable→central-planner architecture, the two human gates (idea:approved, initiative:auto), the hybrid board funnel (consumer repos → repo project; .github/.github-private → org project Addressing PR comments #1), and the adoption runbook.

Notes

  • The idea:approved label has been created on .github.
  • Stub pins the initiative-planner/stable channel (tag cut on release).
  • After merge, the live pilot: add idea:approved to an Ideas Discussion → confirm an inert initiative epic appears in .github.

Refs petry-projects/.github-private#817, #824, #825

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Enabled automated workflow for routing ideas from GitHub Discussions into initiatives with approval gates and project board integration
  • Documentation

    • Added guidelines for the idea-to-initiative pipeline, including adoption steps for new repositories

…r stubs

- Adopt the initiative-planner caller stub on petry-projects/.github itself
  (the S8 pilot): on `idea:approved` it dispatches the central BMAD planner with
  .github as target_repo, materializing an inert epic in this repo.
- ci-standards.md §10 documents the three idea→initiative caller stubs, the
  thin-stub→dispatch-reusable→central-planner architecture, the two human gates,
  the hybrid project-board funnel (consumer repos → repo project; .github/
  .github-private → org project #1), and the adoption runbook.

Refs petry-projects/.github-private#817, #824, #825

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@don-petry don-petry requested a review from a team as a code owner June 21, 2026 03:04
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@coderabbitai

coderabbitai Bot commented Jun 21, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@don-petry, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 51 minutes and 1 second. Learn how PR review limits work.

Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file).

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based credits.

🚦 How do rate limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan refill rate.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, the refill rate gradually slows as usage increases. The highest same-day bursts are limited more strictly.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 46ef7f72-6caf-42bd-b848-55aecffb463e

📥 Commits

Reviewing files that changed from the base of the PR and between bff8c40 and 3287e67.

📒 Files selected for processing (2)
  • .github/workflows/initiative-planner.yml
  • standards/ci-standards.md
📝 Walkthrough

Walkthrough

Adds a new GitHub Actions workflow .github/workflows/initiative-planner.yml that triggers on Discussion label events and delegates execution to a centrally maintained reusable workflow pinned to initiative-planner/stable. Simultaneously adds CI standards documentation defining the BMAD Idea → Initiative pipeline architecture, gating, routing, and adoption steps.

Changes

Initiative Planner Caller Stub and CI Standard

Layer / File(s) Summary
Initiative Planner caller workflow and pipeline standard
.github/workflows/initiative-planner.yml, standards/ci-standards.md
Adds the initiative-planner.yml thin caller stub that fires on discussion: labeled events, sets permissions: {}, and dispatches to petry-projects/.github/.github/workflows/initiative-planner-reusable.yml@initiative-planner/stable with inherited secrets. Documents BMAD-only CI standard §10 covering the thin-stub → central-reusable dispatch pattern for three workflow pairs, human gating via idea:approved and initiative:auto labels, hybrid repo/org project-board routing, and GH_PAT_WORKFLOWS secret requirements for adopting repos.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related issues

Possibly related PRs

  • petry-projects/.github#11: Both PRs extend standards/ci-standards.md; this PR appends the #10: Idea → Initiative pipeline conditional-workflow section that builds on the standards framework introduced there.

Suggested labels

needs-human-review

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately and specifically summarizes the two main changes: enrolling .github in the idea→initiative pipeline and documenting the caller stubs pattern.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feat/enroll-github-idea-pipeline

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Comment thread .github/workflows/initiative-planner.yml Fixed
Comment thread .github/workflows/initiative-planner.yml Fixed

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request adds documentation for the "Idea → Initiative pipeline" in standards/ci-standards.md, detailing its architecture, prerequisites, project-board funnel, and adoption steps for BMAD Method repositories. Feedback points out a broken anchor link to add-to-project.yml and a duplicated section number (10.), suggesting corrections for both.

Comment thread standards/ci-standards.md Outdated
Comment thread standards/ci-standards.md
@don-petry

Copy link
Copy Markdown
Contributor Author

Dev-Lead — review-changes (applied)

Changes committed and pushed.

@don-petry don-petry enabled auto-merge (squash) June 21, 2026 03:07
@don-petry don-petry disabled auto-merge June 21, 2026 03:07

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@standards/ci-standards.md`:
- Line 1009: The markdown fragment link for `add-to-project` contains an
incorrect anchor identifier `#add-to-projectyml` that does not match the actual
heading slug generated by the markdown renderer. Locate the correct heading for
the add-to-project section in the file and update the fragment link to use the
proper heading slug, or alternatively use a direct file link instead of a
fragment reference to ensure the markdown lint validation passes.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 4c95c3c6-9b3f-439e-8da9-90e4e0edc828

📥 Commits

Reviewing files that changed from the base of the PR and between 4d05546 and bff8c40.

📒 Files selected for processing (2)
  • .github/workflows/initiative-planner.yml
  • standards/ci-standards.md

Comment thread standards/ci-standards.md Outdated
coderabbitai[bot]
coderabbitai Bot previously approved these changes Jun 21, 2026
petry-projects/.github hosts the initiative-planner reusable, so its own active
stub must use a LOCAL `./` ref (like add-to-project.yml / pr-review-mention.yml),
not the `@initiative-planner/stable` remote channel that consumer repos pin.
Resolves the SonarCloud "use full commit SHA" security finding (a remote tag ref
on the hosting repo) without SHA-pinning a first-party reusable (forbidden by
ci-standards.md). The standards/ template keeps the @stable ref for consumers.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@don-petry don-petry enabled auto-merge (squash) June 21, 2026 03:15
@don-petry

Copy link
Copy Markdown
Contributor Author

@donpetry-bot please review — code-owner approval needed to merge. CI green (SonarCloud now passes after the self-host local-ref fix).

@donpetry-bot

Copy link
Copy Markdown
Contributor

@don-petry I'm on it — starting a fresh review now. Results will appear in a few minutes.

@donpetry-bot

donpetry-bot commented Jun 21, 2026

Copy link
Copy Markdown
Contributor
Superseded by automated re-review at 3287e6746a8181d1925d0e6be79d32eb4929389a — click to expand prior review.

Review — fix requested (cycle 1/3)

The automated review identified the following issues. Please address each one:

Findings to fix

Automated review — NEEDS HUMAN REVIEW

Risk: LOW
Reviewed commit: 3287e6746a8181d1925d0e6be79d32eb4929389a
Cascade: triage → deep (triage: haiku 4.5 → deep: opus 4.8 + duck: o4-mini → audit: fable 5)

Summary

Adds a clean initiative-planner thin caller stub (permissions: {}, first-party local reusable ref correctly un-SHA-pinned, secrets: inherit matching add-to-project/pr-review-mention pattern, no untrusted-input interpolation, no secrets) plus a ci-standards.md section documenting the idea-to-initiative pipeline. No security or GitHub Actions smell — the trusted-actor gate lives in the reusable by design; CI is green (SonarCloud/CodeQL/gitleaks/ShellCheck/Lint pass) and CodeRabbit approved at head. The one valid, still-unaddressed finding is documentation-only: the new section is numbered '### 10. Idea -> Initiative pipeline' (line 973), duplicating the existing '### 10. PR Review Mention' (line 707). No downstream consumers are impacted (downstream-impact: none). Escalating (kick-back, not to security audit) solely to renumber.

Findings

  • minor: Duplicate section heading number: the added '### 10. Idea -> Initiative pipeline' (line 973) collides with the existing '### 10. PR Review Mention' (line 707). The surrounding numbering is already inconsistent (two '### 8.' headings at lines 656 and 664; '### 9. Feature Ideation' at line 822 appears after '### 11.' at line 735), so renumber the conditional-workflow sections into a single sequential scheme (e.g. make this section 13) rather than only fixing the new heading. Flagged by gemini-code-assist (low priority) and still present at head.
  • info: GitHub Secret Protection MCP tool (run_secret_scanning) was not available in this environment; secret scan relied on the gitleaks CI check (passed). No secrets present in the diff.

Reviewed by the PR-review cascade (triage: haiku 4.5 → deep: opus 4.8 + duck: o4-mini → audit: fable 5). Reply if you need a human review.

Additional tasks

  1. Resolve all unresolved review thread comments from other reviewers
  2. Ensure all CI checks pass after your changes
  3. Rebase on the target branch if behind
  4. Do NOT modify files unrelated to the findings above

The review cascade will automatically re-review after new commits are pushed.

@don-petry

Copy link
Copy Markdown
Contributor Author

@donpetry-bot review please — code-owner approval still needed; CI is green (SonarCloud passing).

@donpetry-bot

Copy link
Copy Markdown
Contributor

@don-petry I'm on it — starting a fresh review now. Results will appear in a few minutes.

@donpetry-bot donpetry-bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review — APPROVED ✓

Risk: LOW
Reviewed commit: 3287e6746a8181d1925d0e6be79d32eb4929389a
Review mode: triage-approved (single reviewer)

Summary

Adds a clean initiative-planner thin caller stub (permissions: {}, correct first-party LOCAL ./ self-host ref — un-SHA-pinned per ci-standards.md, mirroring add-to-project.yml/pr-review-mention.yml; secrets: inherit; no untrusted-input interpolation; no secrets) plus a ci-standards.md section documenting the idea→initiative pipeline. Triage cleared this as low-risk and this confirmation review agrees: no security or GitHub Actions smell (the trusted-actor gate lives in the reusable by design), CI is fully green (SonarCloud/CodeQL/gitleaks/ShellCheck/Lint/AgentShield pass) and CodeRabbit approved at head. The only outstanding item is a cosmetic, non-blocking documentation nit (duplicate heading number).

Linked issue analysis

No GitHub-linked closing issues; PR references petry-projects/.github-private#817, #824, #825 (fleet-enablement initiative / S7-S8). The diff matches the stated intent: enroll petry-projects/.github in the idea→initiative pipeline via a thin caller stub and document the thin-stub→dispatch-reusable→central-planner architecture, the two human gates (idea:approved, initiative:auto), the hybrid project-board funnel, and the adoption runbook.

Findings

  • minor (non-blocking): The added '### 10. Idea → Initiative pipeline' (line 973) duplicates the existing '### 10. PR Review Mention' (line 707). The file's section numbering is already inconsistent independent of this PR (two '### 8.' at lines 656/664; '### 9. Feature Ideation' at line 822 follows '### 11.' at line 735), so a clean fix means renumbering the conditional-workflow sections into one sequential scheme rather than only touching the new heading. Cosmetic, no functional/render impact — not a merge blocker for a docs+stub PR with green CI.
  • info: GitHub Secret Protection MCP tool (run_secret_scanning) was not available in this environment; the secret scan relied on the gitleaks CI check (passed). No secrets present in the diff.

CI status

Green. SonarCloud, CodeQL, Lint, ShellCheck, Secret scan (gitleaks), AgentShield, Dependency-audit detect, and CodeRabbit all SUCCESS at head (3287e67). dev-lead dispatch/ci-relay jobs show CANCELLED (agent-dispatch jobs, non-gating); language-specific audit jobs SKIPPED as expected for this repo. mergeStateStatus is BLOCKED only pending code-owner (org-leads) approval.


Reviewed automatically by the PR-review agent (single-reviewer mode: fable 5). Reply if you need a human review.

@don-petry don-petry merged commit dfe9edc into main Jun 21, 2026
34 of 52 checks passed
@don-petry don-petry deleted the feat/enroll-github-idea-pipeline branch June 21, 2026 03:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants