Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.
Passing a gate is not the same as merging.plan-ok lets building begin. pr-ok is a
per-PR approval checkpoint. Land checks whether the Factory is authorized to merge the current PR.
Choose an autonomy level
policy.autonomy
Plan OK
PR OK
calibrating (default)
Required
Every PR
standard
Required
Protected changes only
autonomous
Still required in the standard Factory pipeline
Protected changes only
autonomous does not remove plan-ok in the shipped pipeline. The optional fast lane is a
separate path: a person-applied labels.fastLane can
preauthorize an eligible small, single-part plan outside protected paths. Review, PR approval rules
and holds still apply.For example, require PR approval for changes to authentication or migrations. Merge these keys
into your existing Factory file:
If the changed files can’t be read and the repository has protected globs, the Factory treats the
change as protected. This setting is a Factory gate, not a replacement for GitHub branch protection.
Approve or revise a plan
GitHub
CLI
Read the published plan on the issue.
Add factory:approved to approve, or comment with what needs to change and add factory:changes.
For revisions, read the replacement plan and approve that plan. Follow the approval instruction
posted with it rather than relying on an earlier approval.
The Factory consumes the plan labels. A card move isn’t approval. A bare /approve comment is a
legacy alias for an unchanged plan; it isn’t required.
Use the full run ID. Run only the command for the decision you intend:
architech factory runs approve "$RUN_ID" --gate plan --jsonarchitech factory runs approve "$RUN_ID" --gate plan --request-changes "Include a rollback step" --jsonarchitech factory runs approve "$RUN_ID" --gate plan --reject --note "Do not proceed" --json
Requesting changes re-plans in the same run; rejecting cancels it.
Approve or send back a PR
In GitHub use Review changes → Approve for the PR you reviewed. Use Request changes with a
note to send it back to build. If GitHub doesn’t let you review a PR you authored, apply the
configured labels.approve label (merge:ready by default), or use the CLI. For a board event
that reaches the Factory, a valid approval label can also count when it is already on the PR as the
gate opens. After a send-back, review and approve the changed work again.
architech factory runs approve "$RUN_ID" --gate pr --sub-item "$SUB_ITEM" --jsonarchitech factory runs approve "$RUN_ID" --gate pr --sub-item "$SUB_ITEM" --reject --note "Keep the public API unchanged" --json
Omitting --sub-item targets all waiting PR gates. Copy the specific command from the Inbox to
affect just one. An ordinary PR comment does not replace a GitHub review or the CLI decision.
Who can decide?
GitHub approval and changes labels: a person account with write, maintain or admin access,
applied directly, not by or through a GitHub App. The Factory verifies who last applied the
label and that it is still present. Use the names pinned to the run; yours may differ from the defaults.
GitHub reviews: a person with write access to the PR’s repository. GitHub does not let an
author approve their own PR. A Cloud Factory review is independent evidence, not your approval.
CLI/API: Mutagent workspace update permission, not GitHub repository permission.
Hold: anyone’s hold counts. Pickup is not a person-only approval; the Factory ignores its
own pickup signals. CI and origin labels are not gate decisions.
Stop or allow land
To stop the Factory’s merge, add merge:hold to the PR, parent issue or sub-item. Remove all
applicable holds to release it. Removing approval alone is not a reliable stop. The label does
not prevent someone with permission from merging directly on GitHub.
At land, a hold takes precedence over every merge preset and label:
as-ready (default): land can squash-merge an APPROVE or WATCH review on the current
head with green CI on that head. If the Factory verified there was no CI configured at review
time, it can also accept no CI at land. An unread check is not a green check.
standard merge preset and other names: ordinary review evidence alone does not authorize
land. Apply the configured approval or loosen label. This preset is separate from standard autonomy.
Person-applied merge:ready or merge:yolo: these labels can authorize land without the
ordinary as-ready evidence. merge:ready can also pass pr-ok; merge:yolo is not a substitute
for a pending PR gate. Neither overrides a hold, a stale head or GitHub’s own merge rules.
For a protected change, an eligible native GitHub approval on the exact head can also authorize
land when the Factory can reverify the approval, protected scope, current base and green CI.
If you merge on GitHub while pr-ok waits, the Factory can record the observed merge and your
approval instead of merging twice. An App’s merge or a merge under a hold is not person approval.A new head invalidates old review and CI evidence. Removing the approval label removes its label
authority, not the fact that the PR gate passed; as-ready can still merge on evidence. Use a hold
for a veto, or submit Request changes for rework.
When review runs out of rounds
policy.review.maxLoops is the send-back allowance per sub-item (default 2, valid 1–10).
It counts send-backs, not the initial review. Some automatic base refreshes are handled separately.
When review needs a further round, read the escalation and choose one of the offered options.
architech factory escalations answer "$ESCALATION_ID" "Send it back for one more round" --json
The other options are Approve it as it is and Cancel the run. The first passes the stopped
stage; it doesn’t make GitHub merge rules or other Factory controls disappear.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Mutagent Docs","description":"Documentation for Mutagent: the Software Factory, Helix, the CLI, the SDK and integrations for building and improving AI agents.","colors":{"primary":"#7E47D7","light":"#A78BFA","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/light-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=f11adc25a4173de6c845ef141777fe48","dark":"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/dark-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=08f852d5d91158e5ea4cba3f6fc12835"},"favicon":"https://mintcdn.com/architech/djP5ca9gPRM0LwAG/favicon-tile.svg?fit=max\u0026auto=format\u0026n=djP5ca9gPRM0LwAG\u0026q=85\u0026s=96d906a3ed948ae1dcc6b700cbc71f96","background":{"color":{"light":"#FFFFFF","dark":"#050208"}},"fonts":{"heading":{"family":"Space Grotesk","weight":600},"body":{"family":"Space Grotesk","weight":400}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"architech","hasAudioNarration":false,"actualSubdomain":"architech","customDomains":["docs.mutagent.io"],"gitSource":{"type":"github","owner":"architech-printworks","repo":"mutagent-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b005c79a671b9155321fa53","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Helix","count":45},{"language":"default","tag":"Factory","count":28},{"language":"default","tag":"CLI","count":26},{"language":"default","tag":"SDK","count":22},{"language":"default","tag":"Features","count":16},{"language":"default","tag":"Platform","count":15},{"language":"default","tag":"Architech","count":13},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"Helix Cloud","count":11},{"language":"default","tag":"Reference","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":".nav-logo{height:32px!important;max-height:32px!important}.sidebar-group-header{font-size:14px!important}link[rel=\"icon\"]{width:32px;height:32px}.callout[class*=\"border-neutral\"]{background-color:rgba(126, 71, 215, 0.10)!important;border-color:rgba(126, 71, 215, 0.32)!important}html:not(.dark) #table-of-contents-layout h2,html:not(.dark) #table-of-contents-layout h2 *{color:#4b4a50!important}html:not(.dark) a[href*=\"poweredBy\"]{color:#5f5e63!important}.flow-arrow{color:#6d3cc4}.dark .flow-arrow{color:#a98be8}.flow-rework{color:#b4235a}.dark .flow-rework{color:#f58ba8}.fx-panel{overflow-x:auto;margin:1.5rem 0;padding:12px;border-radius:12px;background:rgba(126, 71, 215, 0.12);border:1px solid rgba(126, 71, 215, 0.4)}.fx-grid{display:grid;row-gap:8px;align-items:stretch}.fx-map{grid-template-columns:minmax(0, 1fr) 24px minmax(0, 1fr) 24px minmax(0, 1fr);min-width:440px}.fx-chain{grid-template-columns:minmax(0, 1fr) 24px minmax(0, 1fr) 24px minmax(0, 1fr);min-width:440px}.fx-head{font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:0.04em;text-align:center;color:#4b2a8a}.dark .fx-head{color:#c9b5f2}.fx-box{background:#140d22;border:2px solid #7E47D7;color:#ede7f8;border-radius:10px;padding:8px 4px;text-align:center;font-size:13px;font-weight:600;line-height:1.3;display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:52px}.fx-box code{background:transparent;color:#ede7f8;font-size:12px;white-space:normal;overflow-wrap:anywhere;border:0;padding:0}.fx-box small{display:block;margin-top:2px;font-weight:500}.fx-gate{background:#3b2466;border-style:dashed;border-color:#F5B942}.fx-span{grid-row:span 2}.fx-arrow{font-size:22px;font-weight:700;text-align:center;align-self:center}.fx-rework{margin-top:8px;font-size:13px;text-align:center}"}]}
{"page":{"pagePath":"factory/gates","slug":"/factory/gates","pageMetadata":{"title":"Approvals and merge controls","description":"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.","href":"/factory/gates"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Passing a gate is not the same as merging.`}),` `,_jsx(_components.code,{children:`plan-ok`}),` lets building begin. `,_jsx(_components.code,{children:`pr-ok`}),` is a\nper-PR approval checkpoint. Land checks whether the Factory is authorized to merge the current PR.`]}),`\n`,_jsx(Heading,{level:`2`,id:`choose-an-autonomy-level`,children:`Choose an autonomy level`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`policy.autonomy`})}),_jsx(_components.th,{children:`Plan OK`}),_jsx(_components.th,{children:`PR OK`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`calibrating`}),` (default)`]}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Every PR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`standard`})}),_jsx(_components.td,{children:`Required`}),_jsx(_components.td,{children:`Protected changes only`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`autonomous`})}),_jsx(_components.td,{children:`Still required in the standard Factory pipeline`}),_jsx(_components.td,{children:`Protected changes only`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`autonomous`}),` does not remove `,_jsx(_components.code,{children:`plan-ok`}),` in the shipped pipeline. The optional fast lane is a\nseparate path: a person-applied `,_jsx(_components.a,{href:`/factory/reference/factory-yaml#labels`,children:_jsx(_components.code,{children:`labels.fastLane`})}),` can\npreauthorize an eligible small, single-part plan outside protected paths. Review, PR approval rules\nand holds still apply.`]}),`\n`,_jsxs(_components.p,{children:[`For example, require PR approval for changes to authentication or migrations. Merge these keys\ninto your existing `,_jsx(_components.a,{href:`/factory/reference/factory-yaml`,children:`Factory file`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`yaml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`yaml`,children:_jsxs(_components.code,{language:`yaml`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`policy`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` autonomy`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`standard`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` merge`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`preset`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`as-ready`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` review`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`maxLoops`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`repos`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` - `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`name`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`acme/web`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` defaultBranch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`main`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` zones`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:` protected`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'src/auth/**'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'db/migrations/**'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`If the changed files can’t be read and the repository has protected globs, the Factory treats the\nchange as protected. This setting is a Factory gate, not a replacement for GitHub branch protection.`}),`\n`,_jsx(Heading,{level:`2`,id:`approve-or-revise-a-plan`,children:`Approve or revise a plan`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`GitHub`,id:`github`,children:[_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Read the published plan on the issue.`}),`\n`,_jsxs(_components.li,{children:[`Add `,_jsx(_components.code,{children:`factory:approved`}),` to approve, or comment with what needs to change and add `,_jsx(_components.code,{children:`factory:changes`}),`.`]}),`\n`,_jsx(_components.li,{children:`For revisions, read the replacement plan and approve that plan. Follow the approval instruction\nposted with it rather than relying on an earlier approval.`}),`\n`]}),_jsxs(_components.p,{children:[`The Factory consumes the plan labels. A card move isn’t approval. A bare `,_jsx(_components.code,{children:`/approve`}),` comment is a\nlegacy alias for an unchanged plan; it isn’t required.`]})]}),_jsxs(Tab,{title:`CLI`,id:`cli`,children:[_jsx(_components.p,{children:`Use the full run ID. Run only the command for the decision you intend:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approve`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RUN_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --gate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approve`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RUN_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --gate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request-changes`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Include a rollback step\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approve`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RUN_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --gate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --reject`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --note`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Do not proceed\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),_jsx(_components.p,{children:`Requesting changes re-plans in the same run; rejecting cancels it.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`approve-or-send-back-a-pr`,children:`Approve or send back a PR`}),`\n`,_jsxs(_components.p,{children:[`In GitHub use `,_jsx(_components.strong,{children:`Review changes → Approve`}),` for the PR you reviewed. Use `,_jsx(_components.strong,{children:`Request changes`}),` with a\nnote to send it back to build. If GitHub doesn’t let you review a PR you authored, apply the\nconfigured `,_jsx(_components.code,{children:`labels.approve`}),` label (`,_jsx(_components.code,{children:`merge:ready`}),` by default), or use the CLI. For a board event\nthat reaches the Factory, a valid approval label can also count when it is already on the PR as the\ngate opens. After a send-back, review and approve the changed work again.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approve`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RUN_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --gate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pr`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --sub-item`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SUB_ITEM`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` approve`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RUN_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --gate`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pr`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --sub-item`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SUB_ITEM`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --reject`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --note`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Keep the public API unchanged\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Omitting `,_jsx(_components.code,{children:`--sub-item`}),` targets all waiting PR gates. Copy the specific command from the Inbox to\naffect just one. An ordinary PR comment does not replace a GitHub review or the CLI decision.`]}),`\n`,_jsx(Heading,{level:`3`,id:`who-can-decide`,children:`Who can decide?`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`GitHub approval and changes labels:`}),` a person account with write, maintain or admin access,\napplied directly, not by or through a GitHub App. The Factory verifies who last applied the\nlabel and that it is still present. Use the names pinned to the run; yours may differ from the defaults.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`GitHub reviews:`}),` a person with write access to the PR’s repository. GitHub does not let an\nauthor approve their own PR. A Cloud Factory review is independent evidence, not your approval.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`CLI/API:`}),` Mutagent workspace update permission, not GitHub repository permission.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Hold:`}),` anyone’s hold counts. Pickup is not a person-only approval; the Factory ignores its\nown pickup signals. CI and origin labels are not gate decisions.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`stop-or-allow-land`,children:`Stop or allow land`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`To stop the `,_jsx(_components.strong,{children:`Factory’s`}),` merge, add `,_jsx(_components.code,{children:`merge:hold`}),` to the PR, parent issue or sub-item. Remove all\napplicable holds to release it. Removing approval alone is not a reliable stop. The label does\nnot prevent someone with permission from merging directly on GitHub.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gh`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pr`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` edit`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PR_NUMBER`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --repo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` acme/web`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --add-label`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` merge:hold`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`At land, a hold takes precedence over every merge preset and label:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`as-ready`}),` (default):`]}),` land can squash-merge an `,_jsx(_components.code,{children:`APPROVE`}),` or `,_jsx(_components.code,{children:`WATCH`}),` review on the current\nhead with green CI on that head. If the Factory verified there was no CI configured at review\ntime, it can also accept no CI at land. An unread check is not a green check.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`standard`}),` merge preset and other names:`]}),` ordinary review evidence alone does not authorize\nland. Apply the configured approval or loosen label. This preset is separate from `,_jsx(_components.code,{children:`standard`}),` autonomy.`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Person-applied `,_jsx(_components.code,{children:`merge:ready`}),` or `,_jsx(_components.code,{children:`merge:yolo`}),`:`]}),` these labels can authorize land without the\nordinary `,_jsx(_components.code,{children:`as-ready`}),` evidence. `,_jsx(_components.code,{children:`merge:ready`}),` can also pass `,_jsx(_components.code,{children:`pr-ok`}),`; `,_jsx(_components.code,{children:`merge:yolo`}),` is not a substitute\nfor a pending PR gate. Neither overrides a hold, a stale head or GitHub’s own merge rules.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`For a protected change, an eligible native GitHub approval on the exact head can also authorize\nland when the Factory can reverify the approval, protected scope, current base and green CI.\nIf you merge on GitHub while `,_jsx(_components.code,{children:`pr-ok`}),` waits, the Factory can record the observed merge and your\napproval instead of merging twice. An App’s merge or a merge under a hold is not person approval.`]}),`\n`,_jsxs(_components.p,{children:[`A new head invalidates old review and CI evidence. Removing the approval label removes its label\nauthority, not the fact that the PR gate passed; `,_jsx(_components.code,{children:`as-ready`}),` can still merge on evidence. Use a hold\nfor a veto, or submit `,_jsx(_components.strong,{children:`Request changes`}),` for rework.`]}),`\n`,_jsx(Heading,{level:`2`,id:`when-review-runs-out-of-rounds`,children:`When review runs out of rounds`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`policy.review.maxLoops`}),` is the send-back allowance per sub-item (default `,_jsx(_components.strong,{children:`2`}),`, valid `,_jsx(_components.strong,{children:`1–10`}),`).\nIt counts send-backs, not the initial review. Some automatic base refreshes are handled separately.\nWhen review needs a further round, read the escalation and choose one of the offered options.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`architech`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` factory`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` escalations`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` answer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$ESCALATION_ID`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Send it back for one more round\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --json`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The other options are `,_jsx(_components.strong,{children:`Approve it as it is`}),` and `,_jsx(_components.strong,{children:`Cancel the run`}),`. The first passes the stopped\nstage; it doesn’t make GitHub merge rules or other Factory controls disappear.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Approvals and merge controls","description":"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.","href":"/factory/gates"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Choose an autonomy level","slug":"choose-an-autonomy-level","depth":2,"children":[]},{"title":"Approve or revise a plan","slug":"approve-or-revise-a-plan","depth":2,"children":[]},{"title":"Approve or send back a PR","slug":"approve-or-send-back-a-pr","depth":2,"children":[{"title":"Who can decide?","slug":"who-can-decide","depth":3,"children":[]}]},{"title":"Stop or allow land","slug":"stop-or-allow-land","depth":2,"children":[]},{"title":"When review runs out of rounds","slug":"when-review-runs-out-of-rounds","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"architech","siteName":"Mutagent Docs","title":"Approvals and merge controls - Mutagent Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-20T14:43:09.055Z","originalFileLocation":"factory/gates.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mutagent Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Approvals and merge controls - Mutagent Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mutagent Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mutagent.io/factory/gates\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://architech.mintlify.site/_mintlify/api/og/v2?division=Operate\u0026amp;title=Approvals+and+merge+controls\u0026amp;description=Choose+an+autonomy+level%2C+clear+plan+and+PR+gates%2C+and+control+when+the+Factory+can+merge.\u0026amp;theme=04efcec2e743ab4747e912cd\u0026amp;signature=134bab0118831d5a4db72de3e22befbb72b8a0a625c223287a2b7fa77ac172bc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Approvals and merge controls - Mutagent Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://architech.mintlify.site/_mintlify/api/og/v2?division=Operate\u0026amp;title=Approvals+and+merge+controls\u0026amp;description=Choose+an+autonomy+level%2C+clear+plan+and+PR+gates%2C+and+control+when+the+Factory+can+merge.\u0026amp;theme=04efcec2e743ab4747e912cd\u0026amp;signature=134bab0118831d5a4db72de3e22befbb72b8a0a625c223287a2b7fa77ac172bc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mutagent Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7E47D7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mutagent.io/factory/gates\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/factory/gates.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mutagent.io/#organization\",\"name\":\"Mutagent Docs\",\"url\":\"https://docs.mutagent.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/light-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=f11adc25a4173de6c845ef141777fe48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mutagent.io#website\",\"name\":\"Mutagent Docs\",\"url\":\"https://docs.mutagent.io\",\"publisher\":{\"@id\":\"https://docs.mutagent.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mutagent.io/factory/gates#webpage\",\"url\":\"https://docs.mutagent.io/factory/gates\",\"name\":\"Approvals and merge controls\",\"description\":\"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\",\"dateModified\":\"2026-11-20T14:43:09.055Z\",\"isPartOf\":{\"@id\":\"https://docs.mutagent.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mutagent.io/factory/gates#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mutagent.io/factory/gates#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Operate\",\"item\":\"https://docs.mutagent.io/factory/operating\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Approvals and merge controls\",\"item\":\"https://docs.mutagent.io/factory/gates\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mutagent.io/factory/gates#article\",\"headline\":\"Approvals and merge controls\",\"name\":\"Approvals and merge controls\",\"description\":\"Choose an autonomy level, clear plan and PR gates, and control when the Factory can merge.\",\"url\":\"https://docs.mutagent.io/factory/gates\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mutagent.io/factory/gates#webpage\"},\"dateModified\":\"2026-11-20T14:43:09.055Z\",\"publisher\":{\"@id\":\"https://docs.mutagent.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mutagent.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mutagent Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mutagent Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/factory/gates.md","siteName":"Mutagent Docs","nav":{"global":null,"tabs":[{"tab":"Factory","groups":[{"group":"Get started · Early Access","pages":[{"title":"Software Factory","href":"/factory/overview"},{"title":"Factory quickstart","href":"/factory/quickstart"}]},{"group":"Architech","pages":[{"title":"What is Architech","href":"/architech/overview"},{"title":"Install Architech","href":"/architech/install"},{"title":"Onboard your project","href":"/architech/onboard"},{"title":"Orchestrator and agents","href":"/architech/agents"},{"title":"Lifecycle commands","href":"/architech/lifecycle-commands"},{"group":"Features","pages":[{"title":"Overview","href":"/architech/features"},{"title":"Sub-agents","href":"/architech/features/sub-agents"},{"title":"Workflows","href":"/architech/features/workflows"},{"title":"Monitor","href":"/architech/features/monitor"},{"title":"Trace viewer","href":"/architech/features/trace-viewer"},{"title":"Project context","href":"/architech/features/project-context"},{"title":"MCP servers","href":"/architech/features/mcp"},{"title":"System agents","href":"/architech/features/framework-agents"}]}]},{"group":"Configuration","pages":[{"title":"Configure your Factory","href":"/factory/configuration"},{"title":"Memory and rules","href":"/architech/features/memory-and-rules"},{"title":"Context management","href":"/architech/features/context-management"},{"title":"Triggers and routines","href":"/factory/triggers"}]},{"group":"Operate","pages":[{"title":"Operate the Factory","description":"Follow a work item from pickup to merge. Know when the Factory is working and when it needs you.","href":"/factory/operating"},{"title":"Approvals and merge controls","href":"/factory/gates"},{"title":"Questions and dependencies","description":"Answer an escalation, wait for pull requests or a closed issue, and distinguish a paused stage from deferred planning.","href":"/factory/escalations"},{"title":"Usage, costs and capacity","href":"/factory/costs"},{"title":"Troubleshoot a Factory run","href":"/factory/troubleshooting"}]},{"group":"Cloud","pages":[{"title":"Factory on Mutagent Cloud","href":"/factory/cloud"}]},{"group":"Reference","pages":[{"title":"factory.yaml reference","href":"/factory/reference/factory-yaml"},{"title":"Statuses and approvals","href":"/factory/reference/statuses"},{"title":"Factory CLI reference","href":"/factory/reference/cli"}]}]},{"tab":"Helix","pages":[{"title":"Helix","href":"/helix/what-is-helix"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/introduction"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]}]},"basePath":"","title":"Approvals and merge controls - Mutagent Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}