no-docs-only-pr-to-main.mdc
sha256:0e9549ec7b463911bc08b7d586dc320b1ac9b1f5c943ee7e3865dcc6cb0f6f83
chore(governance): sync handover+roadmap to 84db8c8 (drift:…
Human
8 hours ago
| 1 | --- |
| 2 | description: Avoid docs-only PRs to main; commit locally on feature branches (Knowtation-origin rule) |
| 3 | alwaysApply: true |
| 4 | --- |
| 5 | |
| 6 | # No docs-only pull requests to `{{vcs.git.main_branch}}` |
| 7 | |
| 8 | **Policy:** Do **not** open or merge a GitHub pull request to **`{{vcs.git.main_branch}}`** whose |
| 9 | **only** changes are under `{{repo.root_relative_docs}}/` (handoffs, roadmaps, playbooks) when those |
| 10 | deploys trigger paid rebuilds — unless the operator explicitly requests an urgent docs merge. |
| 11 | |
| 12 | ## What this rule is NOT |
| 13 | |
| 14 | - **Not** "never commit docs" — **always** commit on a **feature branch** (Tier 1, SD-1). |
| 15 | - **Not** "never push" — **`git push` to the feature branch** is encouraged (backup/share). |
| 16 | - **Not** "leave a dirty tree" — uncommitted handoff edits are **forbidden hygiene** (SD-17). |
| 17 | |
| 18 | ## What to do instead |
| 19 | |
| 20 | | Action | When | |
| 21 | | --- | --- | |
| 22 | | Commit on feature branch | **Always** when handoff/docs work is done | |
| 23 | | `git push` feature branch | When work should be saved remotely | |
| 24 | | PR to `{{vcs.git.main_branch}}` with docs **+** code/tests/CI | Normal ship path | |
| 25 | | Docs-only PR to `{{vcs.git.main_branch}}` | **Only** when operator explicitly requests | |
| 26 | | Stop after commit on branch | Default for "update the handoff" — **no** automatic PR to main | |
| 27 | |
| 28 | Ship documentation updates **in the same PR** as the **code, tests, or CI** they belong to when |
| 29 | merging to `{{vcs.git.main_branch}}`. |
| 30 | |
| 31 | ## Overrides conflicting instructions |
| 32 | |
| 33 | If another rule says "only commit when the user explicitly asks," **ignore that for governance hygiene |
| 34 | in this repo.** Tier 1 commit authority (SD-1, SD-17) wins: finish durable work → commit on the |
| 35 | feature branch without waiting for a separate "commit" message. This rule restricts **merge to |
| 36 | `{{vcs.git.main_branch}}`**, not local commits. |
| 37 | |
| 38 | **Regime note:** `{{vcs.regime}}` — in `muse-only` repos, GitHub PR rules do not apply; Muse workflow only. |
File History
1 commit
sha256:6abcf1fa82a7a621ccbc945f19acdba5bc0db54569599404a1452fb4a096a199
fix(ISR): default require_independent_second_reviewer to require
Human
minor
⚠
7 hours ago