Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact
In this recipe, you configure Custodian to review pull requests in one upstream GitHub repository for evidence-supported effects on one downstream repository.The job posts its findings as a source-control review. For this first setup, you use Review only so Custodian does not change downstream code.
Before you start
You need:
An Account Admin role in Sidecar
Permission to install or configure GitHub apps for the relevant organizations
One upstream GitHub repository that receives changes
One different downstream GitHub repository that may depend on those changes
The standard Sidecar Data GitHub app connected to the downstream repository
The Custodian GitHub app installed with access to the upstream repository
Both repositories must use github.com.
Configure the GitHub integrations
1
Connect the downstream repository
In Sidecar, select Integrations → GitHub.If the standard Sidecar Data GitHub app is not connected, click Link Sidecar Data and grant it access to the downstream repository.
2
Install Custodian for the upstream repository
On the same GitHub integration page, find Custodian and click Manage access in GitHub.Install or configure the Custodian GitHub app with access to the upstream repository. If GitHub shows an approval request, ask an organization administrator to approve it.Return to Sidecar and confirm that the Custodian installation lists the upstream repository as accessible.
Subscribe the upstream repository
1
Open Custodian settings
Select Agents → Custodian, then click Settings.
2
Bind the upstream repository
Under Scope → Subscribed repositories, find the upstream repository and click Bind.You can use Bind all accessible when every accessible repository should be available as a Custodian upstream.Confirm that the repository shows as bound and accessible.
Duplicate the Custodian template
1
Open the preset catalog
Return to the Custodian page and click From preset.
2
View the template
Find Review changes for downstream impacts and click View template.The template is read-only and never runs directly.
3
Create an operational copy
Click Duplicate. Sidecar creates an inactive custom copy and opens its configuration page.
Duplicate the immutable template to create a configurable Custodian job.
Configure the review job
1
Name the job
Use a name that identifies the repository relationship, such as API changes → analytics impact review.Add a description that helps Account Admins recognize the job in the Console.
2
Review the instructions
Keep the default instructions for the first job. Add only constraints specific to this upstream and downstream relationship.
3
Select upstream and downstream
Under Scope, select:
Upstream repository — the repository you bound to Custodian
Downstream repository — the different repository connected through the standard Sidecar GitHub integration
Save the scope.
4
Choose review behavior
Under Review behavior, select Review only.Leave Suppress no-findings comments off for the first test. This lets you confirm that the workflow ran even when it finds no downstream impact.After validating the workflow, you can choose Draft PR when a safe fix is verified.
5
Check readiness
Confirm that the readiness panel marks the upstream and downstream repositories ready.Knowledge Store and Context Garage checks are informational. They do not block activation.
6
Activate the job
Switch the job to Active.Sidecar allows only one active Custodian downstream-impact job for a given upstream repository. If activation fails, pause the existing job or choose another upstream.
Test the workflow
1
Open or update an upstream pull request
Create a safe test pull request in the upstream repository, or push a new commit to an existing test pull request.Custodian starts from the GitHub pull-request webhook. This job does not have Run now.
2
Follow the run
Open Agents → Console and select the Custodian run. Review the evidence, findings, and delivery status.
3
Review the GitHub result
Return to the upstream pull request and find the Custodian review comment.With Review only, Custodian does not change downstream code. If you later enable draft remediation, review any downstream draft pull request before merging.
Maintain the job
Pause the job before changing a repository binding.
Restore GitHub app access if readiness reports an inaccessible repository.
Use Retry when the same pull-request snapshot should run again.
Use Run again when the upstream head or downstream base branch has moved.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sidecar Data","colors":{"primary":"#6C5CE7","light":"#A29BFE","dark":"#5A4BD1"},"logo":{"light":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/light.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=aec7588a8692437b4d852ab8853fe7f2","dark":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/dark.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=20ae096a0358923d866fe799a20ad512"},"favicon":"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/favicon.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=e509d86c08a6d2f23fcc026c6742c110","navbar":{"links":[{"href":"mailto:support@sidecardata.com","label":"Support"}],"primary":{"type":"button","label":"Login","href":"https://app.sidecardata.com"}},"footer":{"socials":{"website":"https://sidecardata.com","linkedin":"https://www.linkedin.com/company/sidecar-data"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"App","icon":"browser","href":"https://app.sidecardata.com"},{"anchor":"Contact Us","icon":"envelope","href":"mailto:support@sidecardata.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sidecardatainc","hasAudioNarration":false,"actualSubdomain":"sidecardatainc","customDomains":["docs.sidecardata.com"],"gitSource":{"type":"github","owner":"sidecar-data","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afcac5891717461faf6c9ad","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Integrations","count":26},{"language":"default","tag":"Products","count":23},{"language":"default","tag":"Agent Console","count":16},{"language":"default","tag":"MCP","count":7},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"BI \u0026 Analytics","count":6},{"language":"default","tag":"Set up","count":5},{"language":"default","tag":"Data Warehouses","count":4},{"language":"default","tag":"Jobs","count":3},{"language":"default","tag":"Guides","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":false},"customCss":[]}
{"page":{"pagePath":"products/agent-console/recipes/custodian-downstream-impact-review","slug":"/products/agent-console/recipes/custodian-downstream-impact-review","pageMetadata":{"title":"Review upstream changes for downstream impact","sidebarTitle":"Custodian downstream-impact review","description":"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact","icon":"shield-check","href":"/products/agent-console/recipes/custodian-downstream-impact-review"},"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: \"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\"\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={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`In this recipe, you configure Custodian to review pull requests in one upstream GitHub repository for evidence-supported effects on one downstream repository.`}),`\n`,_jsxs(_components.p,{children:[`The job posts its findings as a source-control review. For this first setup, you use `,_jsx(_components.strong,{children:`Review only`}),` so Custodian does not change downstream code.`]}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsx(_components.p,{children:`You need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An Account Admin role in Sidecar`}),`\n`,_jsx(_components.li,{children:`Permission to install or configure GitHub apps for the relevant organizations`}),`\n`,_jsx(_components.li,{children:`One upstream GitHub repository that receives changes`}),`\n`,_jsx(_components.li,{children:`One different downstream GitHub repository that may depend on those changes`}),`\n`,_jsx(_components.li,{children:`The standard Sidecar Data GitHub app connected to the downstream repository`}),`\n`,_jsx(_components.li,{children:`The Custodian GitHub app installed with access to the upstream repository`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Both repositories must use `,_jsx(_components.code,{children:`github.com`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-the-github-integrations`,children:`Configure the GitHub integrations`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Connect the downstream repository`,children:[_jsxs(_components.p,{children:[`In Sidecar, select `,_jsx(_components.strong,{children:`Integrations → GitHub`}),`.`]}),_jsxs(_components.p,{children:[`If the standard Sidecar Data GitHub app is not connected, click `,_jsx(_components.strong,{children:`Link Sidecar Data`}),` and grant it access to the downstream repository.`]})]}),_jsxs(Step,{title:`Install Custodian for the upstream repository`,children:[_jsxs(_components.p,{children:[`On the same GitHub integration page, find `,_jsx(_components.strong,{children:`Custodian`}),` and click `,_jsx(_components.strong,{children:`Manage access in GitHub`}),`.`]}),_jsx(_components.p,{children:`Install or configure the Custodian GitHub app with access to the upstream repository. If GitHub shows an approval request, ask an organization administrator to approve it.`}),_jsx(_components.p,{children:`Return to Sidecar and confirm that the Custodian installation lists the upstream repository as accessible.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`subscribe-the-upstream-repository`,children:`Subscribe the upstream repository`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Custodian settings`,children:_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Agents → Custodian`}),`, then click `,_jsx(_components.strong,{children:`Settings`}),`.`]})}),_jsxs(Step,{title:`Bind the upstream repository`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Scope → Subscribed repositories`}),`, find the upstream repository and click `,_jsx(_components.strong,{children:`Bind`}),`.`]}),_jsxs(_components.p,{children:[`You can use `,_jsx(_components.strong,{children:`Bind all accessible`}),` when every accessible repository should be available as a Custodian upstream.`]}),_jsx(_components.p,{children:`Confirm that the repository shows as bound and accessible.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`duplicate-the-custodian-template`,children:`Duplicate the Custodian template`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the preset catalog`,children:_jsxs(_components.p,{children:[`Return to the Custodian page and click `,_jsx(_components.strong,{children:`From preset`}),`.`]})}),_jsxs(Step,{title:`View the template`,children:[_jsxs(_components.p,{children:[`Find `,_jsx(_components.strong,{children:`Review changes for downstream impacts`}),` and click `,_jsx(_components.strong,{children:`View template`}),`.`]}),_jsx(_components.p,{children:`The template is read-only and never runs directly.`})]}),_jsxs(Step,{title:`Create an operational copy`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Duplicate`}),`. Sidecar creates an inactive custom copy and opens its configuration page.`]}),_jsx(Frame,{caption:`Duplicate the immutable template to create a configurable Custodian job.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=6e1496f60277c07bad9fb0634ec8ed28`,alt:`Immutable Custodian downstream-impact review template with Duplicate button`,\"data-og-width\":`1230`,width:`1230`,\"data-og-height\":`680`,height:`680`,\"data-path\":`images/agent-console/jobs/custodian-template.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=280\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=c5679c331e5175b12b8576d89a289a54 280w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=560\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=468bb94830eb1ebd58a4dbd002496d84 560w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=840\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=87483fcb7f0752158830fbed83b99242 840w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=1100\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=fa2deb74b242506fca9d589a7e14321a 1100w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=1650\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=a1dc9a7b8a19ad3d4be61decbc6bee7e 1650w, https://mintcdn.com/sidecardatainc/73rR_9_1tURjMaYe/images/agent-console/jobs/custodian-template.png?w=2500\u0026fit=max\u0026auto=format\u0026n=73rR_9_1tURjMaYe\u0026q=85\u0026s=a14a4d477b47e62ef62065f4017cbf37 2500w`})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`configure-the-review-job`,children:`Configure the review job`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Name the job`,children:[_jsxs(_components.p,{children:[`Use a name that identifies the repository relationship, such as `,_jsx(_components.code,{children:`API changes → analytics impact review`}),`.`]}),_jsx(_components.p,{children:`Add a description that helps Account Admins recognize the job in the Console.`})]}),_jsx(Step,{title:`Review the instructions`,children:_jsx(_components.p,{children:`Keep the default instructions for the first job. Add only constraints specific to this upstream and downstream relationship.`})}),_jsxs(Step,{title:`Select upstream and downstream`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Scope`}),`, select:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Upstream repository`}),` — the repository you bound to Custodian`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Downstream repository`}),` — the different repository connected through the standard Sidecar GitHub integration`]}),`\n`]}),_jsx(_components.p,{children:`Save the scope.`})]}),_jsxs(Step,{title:`Choose review behavior`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Review behavior`}),`, select `,_jsx(_components.strong,{children:`Review only`}),`.`]}),_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Suppress no-findings comments`}),` off for the first test. This lets you confirm that the workflow ran even when it finds no downstream impact.`]}),_jsxs(_components.p,{children:[`After validating the workflow, you can choose `,_jsx(_components.strong,{children:`Draft PR when a safe fix is verified`}),`.`]})]}),_jsxs(Step,{title:`Check readiness`,children:[_jsx(_components.p,{children:`Confirm that the readiness panel marks the upstream and downstream repositories ready.`}),_jsx(_components.p,{children:`Knowledge Store and Context Garage checks are informational. They do not block activation.`})]}),_jsxs(Step,{title:`Activate the job`,children:[_jsxs(_components.p,{children:[`Switch the job to `,_jsx(_components.strong,{children:`Active`}),`.`]}),_jsx(_components.p,{children:`Sidecar allows only one active Custodian downstream-impact job for a given upstream repository. If activation fails, pause the existing job or choose another upstream.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`test-the-workflow`,children:`Test the workflow`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open or update an upstream pull request`,children:[_jsx(_components.p,{children:`Create a safe test pull request in the upstream repository, or push a new commit to an existing test pull request.`}),_jsxs(_components.p,{children:[`Custodian starts from the GitHub pull-request webhook. This job does not have `,_jsx(_components.strong,{children:`Run now`}),`.`]})]}),_jsx(Step,{title:`Follow the run`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Agents → Console`}),` and select the Custodian run. Review the evidence, findings, and delivery status.`]})}),_jsxs(Step,{title:`Review the GitHub result`,children:[_jsx(_components.p,{children:`Return to the upstream pull request and find the Custodian review comment.`}),_jsxs(_components.p,{children:[`With `,_jsx(_components.strong,{children:`Review only`}),`, Custodian does not change downstream code. If you later enable draft remediation, review any downstream draft pull request before merging.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`maintain-the-job`,children:`Maintain the job`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Pause the job before changing a repository binding.`}),`\n`,_jsx(_components.li,{children:`Restore GitHub app access if readiness reports an inaccessible repository.`}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.strong,{children:`Retry`}),` when the same pull-request snapshot should run again.`]}),`\n`,_jsxs(_components.li,{children:[`Use `,_jsx(_components.strong,{children:`Run again`}),` when the upstream head or downstream base branch has moved.`]}),`\n`]})]})}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":"Review upstream changes for downstream impact","sidebarTitle":"Custodian downstream-impact review","description":"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact","icon":"shield-check","href":"/products/agent-console/recipes/custodian-downstream-impact-review"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Configure the GitHub integrations","slug":"configure-the-github-integrations","depth":2,"children":[]},{"title":"Subscribe the upstream repository","slug":"subscribe-the-upstream-repository","depth":2,"children":[]},{"title":"Duplicate the Custodian template","slug":"duplicate-the-custodian-template","depth":2,"children":[]},{"title":"Configure the review job","slug":"configure-the-review-job","depth":2,"children":[]},{"title":"Test the workflow","slug":"test-the-workflow","depth":2,"children":[]},{"title":"Maintain the job","slug":"maintain-the-job","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"sidecardatainc","siteName":"Sidecar Data","title":"Review upstream changes for downstream impact - Sidecar Data","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-29T22:32:37.888Z","originalFileLocation":"products/agent-console/recipes/custodian-downstream-impact-review.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=\"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sidecar Data\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Review upstream changes for downstream impact - Sidecar Data\">\u003cmeta data-mint-head property=\"og:description\" content=\"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sidecar Data\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sidecardatainc.mintlify.site/_mintlify/api/og/v2?division=Recipes\u0026amp;title=Review+upstream+changes+for+downstream+impact\u0026amp;description=Configure+a+Custodian+job+that+reviews+upstream+GitHub+pull+requests+for+downstream+impact\u0026amp;theme=5947409eff6b7237b55156b9\u0026amp;signature=51f8472f15a1d4363aaac4aa7737807f467ae2d87f7d6e2569f222f715d048c5\">\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=\"Review upstream changes for downstream impact - Sidecar Data\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sidecardatainc.mintlify.site/_mintlify/api/og/v2?division=Recipes\u0026amp;title=Review+upstream+changes+for+downstream+impact\u0026amp;description=Configure+a+Custodian+job+that+reviews+upstream+GitHub+pull+requests+for+downstream+impact\u0026amp;theme=5947409eff6b7237b55156b9\u0026amp;signature=51f8472f15a1d4363aaac4aa7737807f467ae2d87f7d6e2569f222f715d048c5\">\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/sidecardatainc/ohweD8I7CbJrnp7k/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sidecar Data\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C5CE7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/products/agent-console/recipes/custodian-downstream-impact-review.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sidecardata.com/#organization\",\"name\":\"Sidecar Data\",\"url\":\"https://docs.sidecardata.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sidecardatainc/oH82ndVaeyaRZZaR/logo/light.svg?fit=max\u0026auto=format\u0026n=oH82ndVaeyaRZZaR\u0026q=85\u0026s=aec7588a8692437b4d852ab8853fe7f2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sidecardata.com#website\",\"name\":\"Sidecar Data\",\"url\":\"https://docs.sidecardata.com\",\"publisher\":{\"@id\":\"https://docs.sidecardata.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review#webpage\",\"url\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review\",\"name\":\"Review upstream changes for downstream impact\",\"description\":\"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\",\"dateModified\":\"2026-07-29T22:32:37.888Z\",\"isPartOf\":{\"@id\":\"https://docs.sidecardata.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agent Console\",\"item\":\"https://docs.sidecardata.com/products/agent-console/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Review upstream changes for downstream impact\",\"item\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review#article\",\"headline\":\"Review upstream changes for downstream impact\",\"name\":\"Review upstream changes for downstream impact\",\"description\":\"Configure a Custodian job that reviews upstream GitHub pull requests for downstream impact\",\"url\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sidecardata.com/products/agent-console/recipes/custodian-downstream-impact-review#webpage\"},\"dateModified\":\"2026-07-29T22:32:37.888Z\",\"publisher\":{\"@id\":\"https://docs.sidecardata.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sidecardata.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sidecar Data\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Sidecar Data\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/products/agent-console/recipes/custodian-downstream-impact-review.md","siteName":"Sidecar Data","nav":{"global":{"anchors":[{"anchor":"App","icon":"browser","href":"https://app.sidecardata.com"},{"anchor":"Contact Us","icon":"envelope","href":"mailto:support@sidecardata.com"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"Products","groups":[{"group":"Agent Console","pages":[{"title":"Agent Console","sidebarTitle":"Overview","icon":"terminal","href":"/products/agent-console/overview"},{"title":"Create your first Agent Console job","sidebarTitle":"Quickstart","icon":"rocket","href":"/products/agent-console/quickstart"},{"group":"Agents","root":{"title":"Choose an agent","icon":"users","href":"/products/agent-console/agents/choose-an-agent"},"expanded":true,"pages":[{"title":"Builder","icon":"hammer","href":"/products/agent-console/agents/builder"},{"title":"Reliability","icon":"heart-pulse","href":"/products/agent-console/agents/reliability"},{"title":"Optimization","icon":"gauge-high","href":"/products/agent-console/agents/optimization"},{"title":"Custodian","icon":"shield-check","href":"/products/agent-console/agents/custodian"}]},{"group":"Set up","root":{"title":"Set up Agent Console","icon":"sliders","href":"/products/agent-console/setup/overview"},"pages":[{"title":"Connect repositories","icon":"git-branch","href":"/products/agent-console/setup/connect-repositories"},{"title":"Connect dbt context","icon":"diagram-project","href":"/products/agent-console/setup/connect-dbt"},{"title":"Give agents MCP access","icon":"key","href":"/products/agent-console/setup/give-agents-mcp-access"},{"title":"Provide knowledge to agents","icon":"book-open","href":"/products/agent-console/setup/provide-knowledge"},{"title":"Configure agent defaults","icon":"settings","href":"/products/agent-console/setup/configure-agent-defaults"}]},{"group":"Jobs","pages":[{"title":"Create a job","icon":"circle-plus","href":"/products/agent-console/jobs/create-a-job"},{"title":"Configure a job","icon":"sliders","href":"/products/agent-console/jobs/configure-a-job"},{"title":"Runs and approvals","icon":"list-check","href":"/products/agent-console/jobs/runs-and-approvals"}]},{"title":"Run an agent from Slack","description":"Send an ad hoc Agent Console request by direct message to the Sidecar Slack app","icon":"slack","href":"/products/agent-console/run-an-agent-from-slack"},{"group":"Recipes","pages":[{"title":"Review upstream changes for downstream impact","sidebarTitle":"Custodian downstream-impact review","icon":"shield-check","href":"/products/agent-console/recipes/custodian-downstream-impact-review"}]}]},{"group":"Observability","pages":[{"title":"Monitors as code","description":"Define custom, volume, and freshness monitors in your dbt project and sync them into Sidecar","icon":"code-branch","href":"/products/observability/monitors-as-code"},{"title":"Agent skill for monitors as code","icon":"robot","href":"/products/observability/monitors-as-code-agent-skill"}]},{"group":"Context Garage","pages":[{"title":"Context Garage key concepts","icon":"warehouse","href":"/products/context-garage/key-concepts"},{"title":"Context Garage quickstart","icon":"rocket","href":"/products/context-garage/quickstart"}]},{"group":"Agents","pages":[{"title":"Ask Sidecar with Snowflake query execution","icon":"snowflake","href":"/products/agents/ask-sidecar-snowflake"},{"title":"Contract Agent quickstart","icon":"file-contract","href":"/products/agents/contract-agent"},{"title":"Sidecar Engineer for Jira quickstart","icon":"jira","href":"/products/agents/sidecar-engineer/jira-quickstart"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/source-control/github"}]}]},"basePath":"","title":"Review upstream changes for downstream impact - Sidecar Data","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-BRsfsIIG.js","DynamicMarkdown-NFqqduU7.js","zoom-image-lightbox-BguUeq2N.js","lightbox-handle-r17bVUz3.js"]}