docs(contributing): add lightweight PR flow and CODEOWNERS review gate#106
Merged
Conversation
BODMAT
approved these changes
Jun 29, 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.
What
Scale the contribution flow to the size and risk of a change, and enforce that split automatically.
CONTRIBUTING.md— new Lightweight Changes section (lightweight vs full flow, gated on scope/risk, not commit count). Small, low-risk changes skip the tracking issue, the full PR template, and the blocking approval; a lightweight PR is self-merged once CI is green, while a full-flow PR still needs a reviewer's approval. Documents how the split is enforced..github/PULL_REQUEST_TEMPLATE.md— the short What / Why / Testing form lives inline in an HTML comment at the top: a lightweight PR deletes the full template and uses it; a full PR leaves the comment (it stays hidden) and fills the sections below..github/CODEOWNERS— new file. With branch protection set to0baseline approvals + Require review from Code Owners, a PR that touches a sensitive path (database schema/migrations, any.env*.example, auth/middleware code,packages/types, CI workflows, deploy config, or the CODEOWNERS file itself) requires an owner's approval to merge; a PR that touches none can be self-merged.Why
Issue-per-change plus the full template and a mandatory approval is heavyweight for trivial work, and waiting on a second pair of eyes for a typo just stalls it. Gating on scope and risk rather than commit count keeps the process honest — features, schema, public API, and security changes still take the full flow and still need an approval, regardless of size. CODEOWNERS makes that gate automatic and path-based instead of relying on everyone classifying their own PR correctly: the risky paths are listed once, and GitHub blocks self-merge exactly there.
Testing
n/a — docs + config only, no code paths changed.