feat(pr): org-wide PR template kit v1.0.0 with intent reconciliation and gates - #15
Merged
Conversation
…ion promotion (pr-template-kit v1.0.0)
…ion promotion (pr-template-kit v1.0.0)
… promotion (pr-template-kit v1.0.0)
|
This was referenced Jul 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.



Problem
The org has a single flat
PULL_REQUEST_TEMPLATE.mdwith no enforcement — PR quality (problem statement, risk assessment, evidence) depends entirely on author discipline.Fix
Deploys pr-template-kit v1.0.0 (sha256-verified against MANIFEST.json):
.github/pull_request_template.md— default template: Problem → Fix → Risk → Evidence → Gates → Reviewer focus → Changes by intent → Files touched.github/PULL_REQUEST_TEMPLATE/EXAMPLE.md— fully worked reference PR.github/PULL_REQUEST_TEMPLATE/infra.md— terraform plan, blast radius, IAM gates.github/PULL_REQUEST_TEMPLATE/release.md— changelog, version-bump gates.github/workflows/pr-files.yml— writes Files touched block, reconciles intent vs diff.github/workflows/pr-gates.yml— validates Problem/Risk/Evidence/Gatesdocs/DEPLOY.md— 5-step rollout + rollback runbookdocs/DESIGN.md— rationale for each sectionBoth workflows ship with minimal top-level
permissions:blocks and actions pinned to full commit SHAs (actions/checkout@11bd719,actions/github-script@60a0d83).Risk
.githubrepo do not auto-run for other repos; distribution requiresworkflow_callcallers or sync (see rollout).PULL_REQUEST_TEMPLATE.mdis left in place; GitHub prefers.github/pull_request_template.md, so this PR's template wins. Delete or merge the legacy governance checklist in a follow-up.Evidence
MANIFEST.jsonsha256 + byte counts before install.pr-files.ymlb7185315…742fec9pr-gates.yml6ab39da7…91ea04Changes by intent
.github/pull_request_template.md,.github/PULL_REQUEST_TEMPLATE/EXAMPLE.md,.github/PULL_REQUEST_TEMPLATE/infra.md,.github/PULL_REQUEST_TEMPLATE/release.md.github/workflows/pr-gates.yml,.github/workflows/pr-files.ymldocs/DEPLOY.md,docs/DESIGN.mdRollout (from docs/DEPLOY.md)
main— templates take effect immediately for new PRs.workflow_callcallers pinned to@v1(seeops/tag-v1.sh).core.setFailed), then makePR gates / checkandPR files touched / annotaterequired via org ruleset.Files touched
8 files — 8 files changed, 604 insertions(+)
.github/pull_request_template.md— added.github/PULL_REQUEST_TEMPLATE/EXAMPLE.md— addedinfra.md— addedrelease.md— added.github/workflows/pr-files.yml— addedpr-gates.yml— addeddocs/DEPLOY.md— addedDESIGN.md— added