{ "release_tag": "v0.15.0", "release_notes": [ { "note": "Plans now declare a required finish key, returning the plan's result shape on success and one standard error shape on failure", "sha": "648d34e", "short_sha": "648d34e" }, { "note": "Workbench agents now work on plans through the same artifact tools as agents and tools, folding 17 workbench tools into 7", "sha": "cd01c05", "short_sha": "cd01c05" } ], "commits": [ … ]}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"graph","colors":{"primary":"#16A34A","light":"#22C55E","dark":"#15803D"},"favicon":"https://mintcdn.com/graph/Ha85FhxHesay9r1W/favicon.svg?fit=max\u0026auto=format\u0026n=Ha85FhxHesay9r1W\u0026q=85\u0026s=2a0afa5800528a6e2386c904722fddf3","navbar":{"links":[]},"footer":{"socials":{"github":"https://github.com/tylerdavis/graph"}},"variables":{"release_version":"v0.16.0","config_file_version":"4","plan_file_version":"2","tool_file_version":"2","agent_file_version":"1","data_directory_version":"2","pack_file_version":"1","pack_lock_version":"1"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"graph","hasAudioNarration":false,"actualSubdomain":"graph","customDomains":[],"gitSource":{"type":"github","owner":"tylerdavis","repo":"graph","deployBranch":"docs-live","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"2fea3d6f-2d42-495b-900b-9b429fd7f4e5","liveDeploymentHistoryId":"6acefbf9d9195feef044da4d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6acefbf9d9195feef044da4d"},"feedback":{"edits":true,"issues":true,"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad69b95267d46225e8c7235","clientVersion":"0.0.3888","searchFilterCounts":[{"language":"default","tag":"Reference","count":129},{"language":"default","tag":"CLI","count":53},{"language":"default","tag":"Tools","count":38},{"language":"default","tag":"Guides","count":27},{"language":"default","tag":"Plans","count":23},{"language":"default","tag":"Integrating","count":20},{"language":"default","tag":"Agents","count":18},{"language":"default","tag":"MCP","count":18},{"language":"default","tag":"Workbench tools","count":16},{"language":"default","tag":"MCP server tools","count":14}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","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":"editor-private-page-search","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":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"plans/guides/draft-in-workbench","slug":"/plans/guides/draft-in-workbench","pageMetadata":{"title":"Draft a plan in the workbench","description":"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.","keywords":["workbench","plan drafter","compose_plan","draft a plan"],"href":"/plans/guides/draft-in-workbench"},"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: \"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\"\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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);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(Heading,{level:`2`,id:`draft-the-plan`,children:`Draft the plan`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the workbench in plan mode`,children:_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:`graph`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` workbench`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`})]}),`\n`]})})})}),_jsxs(Step,{title:`Describe the goal`,children:[_jsx(_components.p,{children:`Say what the plan should produce and from what:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`a plan that writes a one-line release`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`note for each commit since the latest`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GitHub release, from its subject and`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`the files it changed`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`The plan drafter finds the tools for each part of the goal, writes the plan, checks it, and puts it in the pane:`}),_jsx(Frame,{caption:`The drafted plan in the pane: the release, the commits since it, each commit's changed files, and one infer step that writes the notes.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=88e17589cd327119318f80b9921c42ad`,alt:`The workbench after drafting: the goal and the plan drafter's summary on the left, and the release_notes_since_latest_release plan on the right with steps release, commits, a file_changes map over changed and row, notes, and the output, marked valid.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/plan-drafted.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=6ff01e34c659066811410c2416eb63ba 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=a8b56e3a2dae676f09a8e0b6ace20624 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=75c7343ecd25884c935930cdaccf151f 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=f083dc4e333d084802d4ea86d87fd171 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=f8444667da45e77bc1b4e35a3846fe01 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafted.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=3db7dfa93a407f1021a3e76bf6475d57 2500w`})})]}),_jsxs(Step,{title:`Answer its questions`,children:[_jsx(_components.p,{children:`The drafter may ask for clarification on statuses or labels that it needs to draft the plan. Answer the questions in the form to continue.`}),_jsx(Frame,{caption:`The drafter's questions, each filled in with its guess.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=2adf99080dc5af16f3e3fea970f36283`,alt:`The workbench's answer form over the chat, asking whether merge commits should get a release note (no) and whether to leave out commits that only change .github/, with a field for anything else the planner should know.`,\"data-og-width\":`1044`,width:`1044`,\"data-og-height\":`720`,height:`720`,\"data-path\":`images/workbench/plan-drafting-questions.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=280\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=22705f83ca3e69c824f2aa283630c01f 280w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=560\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=8e4430f75584b5267b1c8ccbac703d0a 560w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=840\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=bdbf8427ed96967957576a717b44459e 840w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=9fae8cf8a77484824bdef14e49f85db3 1100w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=0a94d4776137177b6f0984ea4375fbd8 1650w, https://mintcdn.com/graph/s-Ce0Orb66xMgIkN/images/workbench/plan-drafting-questions.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=s-Ce0Orb66xMgIkN\u0026q=85\u0026s=01079d8c52d07dea928f758a853f7428 2500w`})})]}),_jsxs(Step,{title:`Rename it`,children:[_jsx(_components.p,{children:`The plan editor takes over once the draft is in the pane. Ask it for the identifier you want:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`rename it unreleased_changes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Save`,children:_jsxs(_components.p,{children:[`Press `,_jsx(`kbd`,{children:`Ctrl`}),`+`,_jsx(`kbd`,{children:`S`}),`. graph writes the plan to `,_jsx(_components.code,{children:`./.graph/plans/unreleased_changes.yaml`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`run-the-plan`,children:`Run the plan`}),`\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:`graph`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` plan`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` run`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` unreleased_changes`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`json`,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:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_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\":`#9CDCFE`},children:` \"release_tag\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"v0.15.0\"`}),_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\":`#9CDCFE`},children:` \"release_notes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_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\":`#9CDCFE`},children:` \"note\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Plans now declare a required finish key, returning the plan's result shape on success and one standard error shape on failure\"`}),_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\":`#9CDCFE`},children:` \"sha\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"648d34e\"`}),_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\":`#9CDCFE`},children:` \"short_sha\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"648d34e\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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\":`#9CDCFE`},children:` \"note\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Workbench agents now work on plans through the same artifact tools as agents and tools, folding 17 workbench tools into 7\"`}),_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\":`#9CDCFE`},children:` \"sha\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cd01c05\"`}),_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\":`#9CDCFE`},children:` \"short_sha\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cd01c05\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_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\":`#9CDCFE`},children:` \"commits\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [ `}),_jsx(_components.span,{style:{color:`#82071E`,\"--shiki-light-font-style\":`italic`,\"--shiki-dark\":`#F44747`,\"--shiki-dark-font-style\":`inherit`},children:`…`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related guides`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Debug a plan`,icon:`bug`,href:`/plans/guides/debug-a-plan`,children:_jsx(_components.p,{children:`Step through a run in the workbench.`})}),_jsx(Card,{title:`Plan file`,icon:`file-code`,href:`/plans/reference/plan-file`,children:_jsx(_components.p,{children:`Every field a plan file takes.`})}),_jsx(Card,{title:`Create a tool in the workbench`,icon:`wrench`,href:`/tools/guides/create-in-workbench`,children:_jsx(_components.p,{children:`Draft a tool the plan needs.`})})]})]})}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":"Draft a plan in the workbench","description":"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.","keywords":["workbench","plan drafter","compose_plan","draft a plan"],"href":"/plans/guides/draft-in-workbench"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Draft the plan","slug":"draft-the-plan","depth":2,"children":[]},{"title":"Run the plan","slug":"run-the-plan","depth":2,"children":[]},{"title":"Related guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"graph","siteName":"graph","title":"Draft a plan in the workbench - graph","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T22:37:21.111Z","originalFileLocation":"plans/guides/draft-in-workbench.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"graph\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_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/graph/dDHy2CkfKrjxpFva/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Draft a plan in the workbench - graph\">\u003cmeta data-mint-head property=\"og:description\" content=\"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"graph\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://graph.mintlify.app/plans/guides/draft-in-workbench\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Draft a plan in the workbench - graph\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/graph/dDHy2CkfKrjxpFva/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"graph\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://graph.mintlify.app/plans/guides/draft-in-workbench\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/plans/guides/draft-in-workbench.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://graph.mintlify.app/#organization\",\"name\":\"graph\",\"url\":\"https://graph.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://graph.mintlify.app#website\",\"name\":\"graph\",\"url\":\"https://graph.mintlify.app\",\"publisher\":{\"@id\":\"https://graph.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench#webpage\",\"url\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench\",\"name\":\"Draft a plan in the workbench\",\"description\":\"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\",\"dateModified\":\"2026-10-19T22:37:21.111Z\",\"isPartOf\":{\"@id\":\"https://graph.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Plans\",\"item\":\"https://graph.mintlify.app/plans/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Draft a plan in the workbench\",\"item\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench#article\",\"headline\":\"Draft a plan in the workbench\",\"name\":\"Draft a plan in the workbench\",\"description\":\"Draft unreleased_changes, a plan that writes a one-line release note for each commit since the latest release, then save and run it.\",\"url\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench\",\"mainEntityOfPage\":{\"@id\":\"https://graph.mintlify.app/plans/guides/draft-in-workbench#webpage\"},\"dateModified\":\"2026-10-19T22:37:21.111Z\",\"keywords\":\"workbench, plan drafter, compose_plan, draft a plan\",\"publisher\":{\"@id\":\"https://graph.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://graph.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"graph\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"graph","nav":{"global":null,"pages":[{"title":"Introducing Graph","icon":"hand-wave","sidebarTitle":"Introduction","href":"/introduction"},{"title":"Quick start","icon":"rocket","href":"/quickstart"},{"group":"Getting started","icon":"person-ski-jumping","expanded":true,"pages":[{"title":"Installation","href":"/getting-started/installation"},{"title":"Core concepts","href":"/getting-started/concepts"},{"title":"Models and providers","href":"/getting-started/models"},{"title":"The workbench","href":"/getting-started/workbench"}]},{"group":"Agents","icon":"robot","expanded":true,"pages":[{"title":"Agents","sidebarTitle":"Overview","href":"/agents/overview"},{"group":"Guides","pages":[{"title":"Create an agent in the workbench","href":"/agents/guides/create-in-workbench"},{"title":"Talk to an agent","href":"/agents/guides/talk-to-an-agent"},{"title":"Optimize an agent with plans","href":"/agents/guides/optimize-with-plans"},{"title":"Build a multi-agent network","href":"/agents/guides/multi-agent-networks"},{"title":"Customize a built-in agent","href":"/agents/guides/customize-built-ins"},{"title":"Steer tool choice","href":"/agents/guides/steer-tool-choice"},{"title":"Manage threads","href":"/agents/guides/threads"}]},{"group":"Reference","pages":[{"title":"Agent file","playground":"none","href":"/agents/reference/agent-file"},{"group":"Built-in agents","root":{"title":"Built-in agents","href":"/agents/reference/built-in-agents"},"pages":[{"group":"Global","pages":[{"title":"chat","sidebarTitle":"chat","playground":"none","href":"/agents/reference/built-in/chat"},{"title":"agent_drafter","sidebarTitle":"agent_drafter","playground":"none","href":"/agents/reference/built-in/agent_drafter"},{"title":"tool_drafter","sidebarTitle":"tool_drafter","playground":"none","href":"/agents/reference/built-in/tool_drafter"}]},{"group":"Workbench","pages":[{"title":"front_desk (workbench)","sidebarTitle":"front_desk","playground":"none","href":"/agents/reference/built-in/workbench/front_desk"},{"title":"plan_drafter (workbench)","sidebarTitle":"plan_drafter","playground":"none","href":"/agents/reference/built-in/workbench/plan_drafter"},{"title":"plan_loader (workbench)","sidebarTitle":"plan_loader","playground":"none","href":"/agents/reference/built-in/workbench/plan_loader"},{"title":"plan_editor (workbench)","sidebarTitle":"plan_editor","playground":"none","href":"/agents/reference/built-in/workbench/plan_editor"},{"title":"agent_drafter (workbench)","sidebarTitle":"agent_drafter","playground":"none","href":"/agents/reference/built-in/workbench/agent_drafter"},{"title":"tool_drafter (workbench)","sidebarTitle":"tool_drafter","playground":"none","href":"/agents/reference/built-in/workbench/tool_drafter"}]}]}]}]},{"group":"Plans","icon":"list-radio","expanded":true,"pages":[{"title":"Plans","sidebarTitle":"Overview","description":"A plan is a YAML file of steps that runs the same way every time, with a model call only where you put one.","href":"/plans/overview"},{"group":"Guides","pages":[{"title":"Draft a plan in the workbench","href":"/plans/guides/draft-in-workbench"},{"title":"Run a plan","description":"Run a plan with input and pipe its output to jq.","href":"/plans/guides/run-a-plan"},{"title":"Debug a plan","href":"/plans/guides/debug-a-plan"},{"group":"Steps","pages":[{"title":"Stop early with exit gates","href":"/plans/guides/exit-gates"},{"title":"Branch with route","href":"/plans/guides/branching"},{"title":"Select items with filter","href":"/plans/guides/filter"},{"title":"Iterate with map and reduce","href":"/plans/guides/map-and-reduce"},{"title":"Delegate a step to an agent","href":"/plans/guides/agent-steps"},{"title":"Ask for input mid-run","href":"/plans/guides/ask-steps"}]},{"title":"Compose plans","href":"/plans/guides/compose-plans"},{"title":"Handle failures","href":"/plans/guides/handle-failures"}]},{"group":"Reference","pages":[{"title":"Plan file","playground":"none","href":"/plans/reference/plan-file"},{"title":"Conditions and bodies","href":"/plans/reference/conditions-and-bodies"},{"group":"Control steps","root":{"title":"Control steps","href":"/plans/reference/control-steps"},"pages":[{"title":"route","sidebarTitle":"route","playground":"none","href":"/plans/reference/steps/route"},{"title":"filter","sidebarTitle":"filter","playground":"none","href":"/plans/reference/steps/filter"},{"title":"map","sidebarTitle":"map","playground":"none","href":"/plans/reference/steps/map"},{"title":"reduce","sidebarTitle":"reduce","playground":"none","href":"/plans/reference/steps/reduce"},{"title":"exit","sidebarTitle":"exit","playground":"none","href":"/plans/reference/steps/exit"},{"title":"agent","sidebarTitle":"agent","playground":"none","href":"/plans/reference/steps/agent"},{"title":"ask","sidebarTitle":"ask","playground":"none","href":"/plans/reference/steps/ask"}]},{"group":"Built-in plans","root":{"title":"Built-in plans","href":"/plans/reference/built-in-plans"},"pages":[{"title":"compose_plan","sidebarTitle":"compose_plan","playground":"none","href":"/plans/reference/built-in/compose_plan"},{"title":"search_tools","sidebarTitle":"search_tools","playground":"none","href":"/plans/reference/built-in/search_tools"}]}]}]},{"group":"Tools","icon":"toolbox","expanded":true,"pages":[{"title":"Tools","sidebarTitle":"Overview","href":"/tools/overview"},{"group":"Guides","pages":[{"title":"Create a tool in the workbench","href":"/tools/guides/create-in-workbench"},{"title":"Test a tool","href":"/tools/guides/test-a-tool"},{"title":"Improve what graph knows about a tool","href":"/tools/guides/tool-shapes"}]},{"group":"Reference","pages":[{"group":"Tool file","root":{"title":"Tool file","playground":"none","href":"/tools/reference/tool-file"},"pages":[{"title":"exec tools","sidebarTitle":"kind: exec","playground":"none","href":"/tools/reference/tool-file/exec"},{"title":"prompt tools","sidebarTitle":"kind: prompt","playground":"none","href":"/tools/reference/tool-file/prompt"},{"title":"reshape tools","sidebarTitle":"kind: reshape","playground":"none","href":"/tools/reference/tool-file/reshape"},{"title":"decision tools","sidebarTitle":"kind: decision","playground":"none","href":"/tools/reference/tool-file/decision"}]},{"group":"Built-in tools","root":{"title":"Built-in tools","href":"/tools/reference/builtin-tools"},"pages":[{"title":"builtin__infer","sidebarTitle":"builtin__infer","playground":"none","href":"/tools/reference/builtin/infer"},{"title":"builtin__decide","sidebarTitle":"builtin__decide","playground":"none","href":"/tools/reference/builtin/decide"},{"title":"builtin__reshape","sidebarTitle":"builtin__reshape","playground":"none","href":"/tools/reference/builtin/reshape"}]},{"group":"Native tools","root":{"title":"Native tools","href":"/tools/reference/native-tools"},"pages":[{"group":"Plan authoring","pages":[{"title":"builtin__validate_plan","sidebarTitle":"builtin__validate_plan","playground":"none","href":"/tools/reference/native/validate_plan"},{"title":"builtin__check_plan","sidebarTitle":"builtin__check_plan","playground":"none","href":"/tools/reference/native/check_plan"},{"title":"builtin__compose_context","sidebarTitle":"builtin__compose_context","playground":"none","href":"/tools/reference/native/compose_context"},{"title":"builtin__question_form","sidebarTitle":"builtin__question_form","playground":"none","href":"/tools/reference/native/question_form"},{"title":"builtin__find_tools","sidebarTitle":"builtin__find_tools","playground":"none","href":"/tools/reference/native/find_tools"}]},{"group":"Tool search","pages":[{"title":"builtin__catalog_tools","sidebarTitle":"builtin__catalog_tools","playground":"none","href":"/tools/reference/native/catalog_tools"},{"title":"builtin__score_candidates","sidebarTitle":"builtin__score_candidates","playground":"none","href":"/tools/reference/native/score_candidates"},{"title":"builtin__describe_tools","sidebarTitle":"builtin__describe_tools","playground":"none","href":"/tools/reference/native/describe_tools"}]},{"group":"Drafting","pages":[{"title":"builtin__try_tool","sidebarTitle":"builtin__try_tool","playground":"none","href":"/tools/reference/native/try_tool"},{"title":"builtin__save_tool","sidebarTitle":"builtin__save_tool","playground":"none","href":"/tools/reference/native/save_tool"},{"title":"builtin__save_agent","sidebarTitle":"builtin__save_agent","playground":"none","href":"/tools/reference/native/save_agent"}]}]},{"group":"Workbench tools","root":{"title":"Workbench tools","href":"/tools/reference/workbench-tools"},"pages":[{"group":"Drafts","pages":[{"title":"workbench__list_artifacts","sidebarTitle":"workbench__list_artifacts","playground":"none","href":"/tools/reference/workbench/list_artifacts"},{"title":"workbench__show_artifact","sidebarTitle":"workbench__show_artifact","playground":"none","href":"/tools/reference/workbench/show_artifact"},{"title":"workbench__load_artifact","sidebarTitle":"workbench__load_artifact","playground":"none","href":"/tools/reference/workbench/load_artifact"},{"title":"workbench__set_artifact","sidebarTitle":"workbench__set_artifact","playground":"none","href":"/tools/reference/workbench/set_artifact"},{"title":"workbench__try_artifact","sidebarTitle":"workbench__try_artifact","playground":"none","href":"/tools/reference/workbench/try_artifact"},{"title":"workbench__save_artifact","sidebarTitle":"workbench__save_artifact","playground":"none","href":"/tools/reference/workbench/save_artifact"},{"title":"workbench__discard_artifact","sidebarTitle":"workbench__discard_artifact","playground":"none","href":"/tools/reference/workbench/discard_artifact"}]},{"group":"Plan edits","pages":[{"title":"workbench__update_metadata","sidebarTitle":"workbench__update_metadata","playground":"none","href":"/tools/reference/workbench/update_metadata"},{"title":"workbench__add_step","sidebarTitle":"workbench__add_step","playground":"none","href":"/tools/reference/workbench/add_step"},{"title":"workbench__update_step","sidebarTitle":"workbench__update_step","playground":"none","href":"/tools/reference/workbench/update_step"},{"title":"workbench__delete_step","sidebarTitle":"workbench__delete_step","playground":"none","href":"/tools/reference/workbench/delete_step"},{"title":"workbench__restore_draft","sidebarTitle":"workbench__restore_draft","playground":"none","href":"/tools/reference/workbench/restore_draft"}]},{"group":"Catalog","pages":[{"title":"workbench__describe_tool","sidebarTitle":"workbench__describe_tool","playground":"none","href":"/tools/reference/workbench/describe_tool"}]},{"group":"Files","pages":[{"title":"workbench__read_file","sidebarTitle":"workbench__read_file","playground":"none","href":"/tools/reference/workbench/read_file"},{"title":"workbench__glob","sidebarTitle":"workbench__glob","playground":"none","href":"/tools/reference/workbench/glob"},{"title":"workbench__grep","sidebarTitle":"workbench__grep","playground":"none","href":"/tools/reference/workbench/grep"}]}]}]}]},{"group":"Packs","icon":"box","expanded":true,"pages":[{"title":"Packs","sidebarTitle":"Overview","href":"/packs/overview"},{"group":"Guides","pages":[{"title":"Install and update packs","href":"/packs/guides/install-packs"},{"title":"Write a pack","href":"/packs/guides/write-a-pack"}]},{"group":"Reference","pages":[{"title":"pack.toml","playground":"none","href":"/packs/reference/pack-file"}]}]},{"group":"Integrating","icon":"plug","pages":[{"group":"MCP","root":{"title":"MCP","href":"/integrating/mcp/overview"},"pages":[{"group":"Guides","pages":[{"title":"Connect an MCP server","href":"/integrating/mcp/guides/connect-mcp-server"},{"title":"Serve plans over MCP","href":"/integrating/mcp/guides/serve-over-mcp"},{"title":"Filter and override a server's tools","href":"/integrating/mcp/guides/filter-and-override-tools"},{"title":"Test an MCP server","href":"/integrating/mcp/guides/test-an-mcp-server"}]},{"group":"Reference","pages":[{"group":"MCP server tools","root":{"title":"MCP server tools","href":"/integrating/mcp/reference/server-tools"},"pages":[{"title":"graph_plan_list","sidebarTitle":"graph_plan_list","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_list"},{"title":"graph_plan_show","sidebarTitle":"graph_plan_show","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_show"},{"title":"graph_plan_new","sidebarTitle":"graph_plan_new","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_new"},{"title":"graph_plan_draft","sidebarTitle":"graph_plan_draft","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_draft"},{"title":"graph_plan_set","sidebarTitle":"graph_plan_set","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_set"},{"title":"graph_plan_unset","sidebarTitle":"graph_plan_unset","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_unset"},{"title":"graph_plan_step_add","sidebarTitle":"graph_plan_step_add","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_add"},{"title":"graph_plan_step_update","sidebarTitle":"graph_plan_step_update","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_update"},{"title":"graph_plan_step_rename","sidebarTitle":"graph_plan_step_rename","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_rename"},{"title":"graph_plan_step_rm","sidebarTitle":"graph_plan_step_rm","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_step_rm"},{"title":"graph_plan_validate","sidebarTitle":"graph_plan_validate","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_plan_validate"},{"title":"graph_tools_list","sidebarTitle":"graph_tools_list","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_list"},{"title":"graph_tools_show","sidebarTitle":"graph_tools_show","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_show"},{"title":"graph_tools_test","sidebarTitle":"graph_tools_test","playground":"none","href":"/integrating/mcp/reference/server-tools/graph_tools_test"}]}]}]},{"group":"Observability","pages":[{"title":"OpenTelemetry","href":"/integrating/observability/opentelemetry"},{"title":"Stream run events","href":"/integrating/observability/run-events"}]}]},{"group":"Reference","icon":"book","pages":[{"group":"CLI","root":{"title":"CLI reference","href":"/reference/cli/overview"},"pages":[{"title":"graph ask","sidebarTitle":"graph ask","playground":"none","href":"/reference/cli/ask"},{"title":"graph chat","sidebarTitle":"graph chat","playground":"none","href":"/reference/cli/chat"},{"group":"graph plan","root":{"title":"graph plan","sidebarTitle":"graph plan","playground":"none","href":"/reference/cli/plan"},"pages":[{"title":"graph plan list","sidebarTitle":"list","playground":"none","href":"/reference/cli/plan/list"},{"title":"graph plan show","sidebarTitle":"show","playground":"none","href":"/reference/cli/plan/show"},{"title":"graph plan validate","sidebarTitle":"validate","playground":"none","href":"/reference/cli/plan/validate"},{"title":"graph plan migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/plan/migrate"},{"title":"graph plan run","sidebarTitle":"run","playground":"none","href":"/reference/cli/plan/run"},{"title":"graph plan new","sidebarTitle":"new","playground":"none","href":"/reference/cli/plan/new"},{"title":"graph plan draft","sidebarTitle":"draft","playground":"none","href":"/reference/cli/plan/draft"},{"title":"graph plan set","sidebarTitle":"set","playground":"none","href":"/reference/cli/plan/set"},{"title":"graph plan unset","sidebarTitle":"unset","playground":"none","href":"/reference/cli/plan/unset"},{"group":"graph plan step","root":{"title":"graph plan step","sidebarTitle":"graph plan step","playground":"none","href":"/reference/cli/plan/step"},"pages":[{"title":"graph plan step add","sidebarTitle":"add","playground":"none","href":"/reference/cli/plan/step/add"},{"title":"graph plan step update","sidebarTitle":"update","playground":"none","href":"/reference/cli/plan/step/update"},{"title":"graph plan step rename","sidebarTitle":"rename","playground":"none","href":"/reference/cli/plan/step/rename"},{"title":"graph plan step unset","sidebarTitle":"unset","playground":"none","href":"/reference/cli/plan/step/unset"},{"title":"graph plan step rm","sidebarTitle":"rm","playground":"none","href":"/reference/cli/plan/step/rm"}]}]},{"group":"graph tool","root":{"title":"graph tool","sidebarTitle":"graph tool","playground":"none","href":"/reference/cli/tool"},"pages":[{"title":"graph tool list","sidebarTitle":"list","playground":"none","href":"/reference/cli/tool/list"},{"title":"graph tool show","sidebarTitle":"show","playground":"none","href":"/reference/cli/tool/show"},{"title":"graph tool test","sidebarTitle":"test","playground":"none","href":"/reference/cli/tool/test"},{"title":"graph tool migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/tool/migrate"}]},{"group":"graph agent","root":{"title":"graph agent","sidebarTitle":"graph agent","playground":"none","href":"/reference/cli/agent"},"pages":[{"title":"graph agent list","sidebarTitle":"list","playground":"none","href":"/reference/cli/agent/list"},{"title":"graph agent show","sidebarTitle":"show","playground":"none","href":"/reference/cli/agent/show"},{"title":"graph agent validate","sidebarTitle":"validate","playground":"none","href":"/reference/cli/agent/validate"},{"title":"graph agent migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/agent/migrate"}]},{"group":"graph thread","root":{"title":"graph thread","sidebarTitle":"graph thread","playground":"none","href":"/reference/cli/thread"},"pages":[{"title":"graph thread list","sidebarTitle":"list","playground":"none","href":"/reference/cli/thread/list"},{"title":"graph thread show","sidebarTitle":"show","playground":"none","href":"/reference/cli/thread/show"},{"title":"graph thread rm","sidebarTitle":"rm","playground":"none","href":"/reference/cli/thread/rm"}]},{"group":"graph mcp","root":{"title":"graph mcp","sidebarTitle":"graph mcp","playground":"none","href":"/reference/cli/mcp"},"pages":[{"title":"graph mcp list","sidebarTitle":"list","playground":"none","href":"/reference/cli/mcp/list"},{"title":"graph mcp tools","sidebarTitle":"tools","playground":"none","href":"/reference/cli/mcp/tools"},{"title":"graph mcp test","sidebarTitle":"test","playground":"none","href":"/reference/cli/mcp/test"},{"title":"graph mcp serve","sidebarTitle":"serve","playground":"none","href":"/reference/cli/mcp/serve"},{"title":"graph mcp probe","sidebarTitle":"probe","playground":"none","href":"/reference/cli/mcp/probe"}]},{"group":"graph shape","root":{"title":"graph shape","sidebarTitle":"graph shape","playground":"none","href":"/reference/cli/shape"},"pages":[{"title":"graph shape list","sidebarTitle":"list","playground":"none","href":"/reference/cli/shape/list"},{"title":"graph shape show","sidebarTitle":"show","playground":"none","href":"/reference/cli/shape/show"}]},{"group":"graph config","root":{"title":"graph config","sidebarTitle":"graph config","playground":"none","href":"/reference/cli/config"},"pages":[{"title":"graph config show","sidebarTitle":"show","playground":"none","href":"/reference/cli/config/show"},{"title":"graph config init","sidebarTitle":"init","playground":"none","href":"/reference/cli/config/init"},{"title":"graph config path","sidebarTitle":"path","playground":"none","href":"/reference/cli/config/path"},{"title":"graph config check","sidebarTitle":"check","playground":"none","href":"/reference/cli/config/check"},{"title":"graph config migrate","sidebarTitle":"migrate","playground":"none","href":"/reference/cli/config/migrate"}]},{"group":"graph pack","root":{"title":"graph pack","sidebarTitle":"graph pack","playground":"none","href":"/reference/cli/pack"},"pages":[{"title":"graph pack add","sidebarTitle":"add","playground":"none","href":"/reference/cli/pack/add"},{"title":"graph pack list","sidebarTitle":"list","playground":"none","href":"/reference/cli/pack/list"},{"title":"graph pack update","sidebarTitle":"update","playground":"none","href":"/reference/cli/pack/update"},{"title":"graph pack remove","sidebarTitle":"remove","playground":"none","href":"/reference/cli/pack/remove"},{"title":"graph pack new","sidebarTitle":"new","playground":"none","href":"/reference/cli/pack/new"},{"title":"graph pack check","sidebarTitle":"check","playground":"none","href":"/reference/cli/pack/check"},{"title":"graph pack run","sidebarTitle":"run","playground":"none","href":"/reference/cli/pack/run"},{"title":"graph pack test","sidebarTitle":"test","playground":"none","href":"/reference/cli/pack/test"},{"title":"graph pack release","sidebarTitle":"release","playground":"none","href":"/reference/cli/pack/release"}]},{"group":"graph workbench","root":{"title":"graph workbench","sidebarTitle":"graph workbench","playground":"none","href":"/reference/cli/workbench"},"pages":[{"title":"graph workbench plan","sidebarTitle":"plan","playground":"none","href":"/reference/cli/workbench/plan"},{"title":"graph workbench agent","sidebarTitle":"agent","playground":"none","href":"/reference/cli/workbench/agent"},{"title":"graph workbench tool","sidebarTitle":"tool","playground":"none","href":"/reference/cli/workbench/tool"}]},{"title":"graph version","sidebarTitle":"graph version","playground":"none","href":"/reference/cli/version"},{"title":"Error handling","href":"/reference/cli/error-handling"}]},{"title":"config.toml","playground":"none","href":"/reference/configuration"},{"title":"Environment variables","playground":"none","href":"/reference/environment-variables"},{"title":"Template language","href":"/reference/template-language"},{"title":"File versions","href":"/reference/file-versions"},{"title":"Data directory","href":"/reference/data-directory"},{"title":"Glossary","href":"/reference/glossary"}]},{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog"}]},"title":"Draft a plan in the workbench - graph","buildId":"dpl_CJQjyFMo3m7wZruKi1248oJzrnYG","deploymentId":"dpl_CJQjyFMo3m7wZruKi1248oJzrnYG","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DPQvot1W.js","DynamicMarkdown-XfgpN2Wi.js","zoom-image-lightbox-6J4uLOST.js","PlusIcon-Bs8LLFlB.js","lightbox-handle-r17bVUz3.js"]}
