From bd9527c033ef4c9e1b341852e73d78e9a4aaf821 Mon Sep 17 00:00:00 2001 From: "jason.woltje" Date: Thu, 11 Jun 2026 23:56:20 +0000 Subject: [PATCH] docs(framework): canonize merge-authority policy (hard gate 13 + E2E gate note) (#537) --- packages/mosaic/framework/defaults/AGENTS.md | 1 + packages/mosaic/framework/guides/E2E-DELIVERY.md | 5 +++++ 2 files changed, 6 insertions(+) diff --git a/packages/mosaic/framework/defaults/AGENTS.md b/packages/mosaic/framework/defaults/AGENTS.md index 2ce6959..dac079c 100755 --- a/packages/mosaic/framework/defaults/AGENTS.md +++ b/packages/mosaic/framework/defaults/AGENTS.md @@ -34,6 +34,7 @@ At session start, additionally: 10. Manual `docker build` / `docker push` for deployment is FORBIDDEN when CI/CD pipelines exist in the repository. CI is the ONLY canonical build path for container images. 11. Before ANY build or deployment action, you MUST check for existing CI/CD pipeline configuration (`.woodpecker/`, `.woodpecker.yml`, `.github/workflows/`, etc.). If pipelines exist, use them — do not build locally. 12. The mandatory intake procedure is NOT conditional on perceived task complexity. A "simple" commit-push-deploy task has the same procedural requirements as a multi-file feature. Skipping intake because a task "seems simple" is the most common framework violation. +13. **Merge authority (coordinated work):** when a coordinator/orchestrator session is active for the work, the post-review MERGE GO-AHEAD is the coordinator's to give — once code has passed the required review gates, request the coordinator's go-ahead and merge on their confirmation; do NOT wait on the human owner personally. Solo (uncoordinated) delivery keeps the default: merge without routine confirmation per gates 2 and 9. A "No self-merge" note on a PR means no UNREVIEWED self-merge — it does not suspend coordinator-authorized merges. (Policy: Jason, 2026-06-11.) ## Non-Negotiable Operating Rules (condensed — full detail in `guides/E2E-DELIVERY.md`) diff --git a/packages/mosaic/framework/guides/E2E-DELIVERY.md b/packages/mosaic/framework/guides/E2E-DELIVERY.md index 4dd48cc..dfbb50f 100644 --- a/packages/mosaic/framework/guides/E2E-DELIVERY.md +++ b/packages/mosaic/framework/guides/E2E-DELIVERY.md @@ -88,6 +88,11 @@ For implementation work, you MUST run this cycle in order: ### Post-PR Hard Gate (Execute Sequentially, No Exceptions) +> **Merge authority:** if a coordinator/orchestrator session is active for this +> work, obtain the coordinator's merge go-ahead after review passes, then run +> the gate (AGENTS.md hard gate "Merge authority"). Solo delivery proceeds +> without asking. + 1. `~/.config/mosaic/tools/git/ci-queue-wait.sh --purpose merge -B main` 2. `~/.config/mosaic/tools/git/pr-merge.sh -n -m squash` 3. `~/.config/mosaic/tools/git/pr-ci-wait.sh -n `