no-docs-only-pr-to-main.mdc
sha256:baa800aedf841dbf32081aa7b2befa288ac33dfc7175ac55014c55c4d8c742f9
docs: move durable-auth freeze/evidence to local developmen…
Human
11 days ago
| 1 | --- |
| 2 | description: Avoid docs-only PRs to main; always commit locally on feature branches |
| 3 | alwaysApply: true |
| 4 | --- |
| 5 | |
| 6 | # No docs-only pull requests to `main` (SD-11 — deploy billing) |
| 7 | |
| 8 | **Owner policy (billing):** Do **not** open or merge a GitHub pull request to **`main`** whose **only** |
| 9 | changes are under `docs/` (handoffs, parity matrices, playbooks, `AGENT-INTEGRATION.md`, etc.) — live |
| 10 | sites rebuild on Netlify / 4Everland and incur cost. |
| 11 | |
| 12 | ## What this rule is NOT |
| 13 | |
| 14 | - **Not** "never commit docs" — **always** Muse + Git commit on a **feature branch** (Tier 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**. |
| 17 | |
| 18 | ## What to do instead |
| 19 | |
| 20 | | Action | When | |
| 21 | | --- | --- | |
| 22 | | Muse + Git 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 `main` with docs **+** code/tests/CI | Normal ship path | |
| 25 | | Docs-only PR to `main` | **Only** when the user explicitly requests an urgent docs merge | |
| 26 | | Stop after commit on branch | Default for "update the handoff" tasks — **no** automatic PR | |
| 27 | |
| 28 | Ship documentation updates **in the same PR** as the **code, tests, or CI** they belong to when |
| 29 | merging to `main` (e.g. Track B3 memory wiring + updated handoff together). |
| 30 | |
| 31 | ## Overrides conflicting instructions |
| 32 | |
| 33 | If another rule says "only commit when the user explicitly asks," **ignore that for this repo**. |
| 34 | `AGENTS.md` Tier 1 commit authority wins: finish durable work → Muse + Git commit on the feature |
| 35 | branch without waiting for a separate "commit" message. SD-11 restricts **merge to `main`**, not |
| 36 | local commits. |
File History
1 commit
sha256:baa800aedf841dbf32081aa7b2befa288ac33dfc7175ac55014c55c4d8c742f9
docs: move durable-auth freeze/evidence to local developmen…
Human
11 days ago