feat(workflows): pin reusable callers to @v1 and document tier model - #88
Conversation
Pins all stubs in standards/workflows/ and the central repo's own .github/workflows/claude.yml from @main to @v1. From here on, a bad commit on main cannot break every downstream repo simultaneously — breaking changes will publish v2 and downstream repos opt in. Adds a "Centralization tiers" section to ci-standards.md documenting the three tiers (stub / per-repo template / free per-repo) so future agents know whether a workflow file is editable, what they may tune, and where to send fixes when behavior needs to change. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|
Warning Rate limit exceeded
Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 4 minutes and 40 seconds. ⌛ How to resolve this issue?After the wait time has elapsed, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout. Please see our FAQ for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: Organization UI Review profile: ASSERTIVE Plan: Pro Run ID: 📒 Files selected for processing (2)
📝 WalkthroughWalkthroughUpdated CI standards documentation to define workflow centralization tiers and pinned multiple stub workflows to stable version tag ( Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~12 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 3✅ Passed checks (3 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
claude-code-action validates that .github/workflows/claude.yml in a PR is byte-identical to main, so updating it within a normal PR is impossible — the validation fails before the merge can land. Updating the central repo's own caller will be done as a tiny separate change after this lands. Standards stubs remain pinned to @v1 — that is the change that matters for downstream repos. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
There was a problem hiding this comment.
Pull request overview
Pins the org’s thin caller workflow stubs to the newly created @v1 reusable-workflow tag (instead of @main) to reduce downstream breakage risk, and updates CI standards documentation to explain the workflow centralization tier model.
Changes:
- Updated all
standards/workflows/*thin caller stubs to usepetry-projects/.github/.github/workflows/*-reusable.yml@v1. - Updated this repo’s own
.github/workflows/claude.ymlto call the@v1reusable. - Added “Centralization tiers” documentation and a tier column to the “Available templates” table in
standards/ci-standards.md.
Reviewed changes
Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.
Show a summary per file
| File | Description |
|---|---|
| standards/workflows/feature-ideation.yml | Pins reusable call from @main to @v1. |
| standards/workflows/dependency-audit.yml | Pins reusable call from @main to @v1. |
| standards/workflows/dependabot-rebase.yml | Pins reusable call from @main to @v1. |
| standards/workflows/dependabot-automerge.yml | Pins reusable call from @main to @v1. |
| standards/workflows/claude.yml | Pins reusable call from @main to @v1. |
| standards/workflows/agent-shield.yml | Pins reusable call from @main to @v1. |
| standards/ci-standards.md | Documents centralization tiers and adds tier column to the templates table. |
| .github/workflows/claude.yml | Pins reusable call from @main to @v1 for this repo’s own caller. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Address Copilot review on #88: 1. feature-ideation.yml: prepend the same SOURCE OF TRUTH header block used by the other Tier 1 stubs so the claim "Tier 1 stubs all carry an identical header" is actually true. 2. ci-standards.md tier table: drop the inaccurate "~30-line" claim (feature-ideation.yml is ~95 lines because of the `project_context` input). Replace with "thin caller stub" and call out feature-ideation's required input alongside agent-shield's optional ones. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
|



Summary
Follow-up to #87. Now that the v1 tag exists on the central repo's reusables, pin every stub from
@mainto@v1so downstream repos are insulated from breaking changes onmain. Also documents the centralization tier model inci-standards.md.Changes
standards/workflows/(claude, dependency-audit, dependabot-automerge, dependabot-rebase, agent-shield, feature-ideation).github/workflows/claude.ymlci-standards.md: Added a "Centralization tiers" section documenting the three tiers (Tier 1 stub / Tier 2 per-repo template / Tier 3 free per-repo). Includes a tier column in the templates table and explains the@v1pinning rationale.Test plan
actionlintclean on all 8 changed files@v1Risk
Low. The v1 tag was created in #87's merge commit (9524890) and points to identical content. Switching from
@mainto@v1is a no-op for the next run; the value comes from future immunity to bad commits on main.🤖 Generated with Claude Code
Summary by CodeRabbit
Documentation
Chores