Choose review, decomposition, or discovered work without losing issue ownership.
Delegate a bounded task when another agent can make progress independently. Decide where the work belongs before starting the agent, because placement controls ownership, worktrees, and issue history.
Choose the work shape
Match the delegated task to one of these placements:
Situation
Placement
Review or research on the current issue
Another session on the same issue
Required implementation with its own deliverable
Child issue with its own worktree
Useful work that can ship later
Top-level issue related as discovered-from
Add a reviewer to the current issue
Spawn another session on the same issue for bounded review:
podium agent spawn \ --issue your_issue_ref \ --title "Reviewer: error handling" \ --prompt "Placement: stay on this issue and work read-only. Review the \changed error paths and report concrete failures only. The coordinator and \implementation agent share this machine; send findings to the issue with \podium issue mail send your_issue_ref --body '<finding>'."
Use this shape for read-only review or other work that does not need concurrent edits in the same checkout.
Create required implementation work
Create and start a child issue in one command:
podium issue create \ --parent-id your_issue_ref \ --title "Cache regression coverage" \ --description "Add the regression tests required by the parent issue." \ --brief "Own only the cache regression test files. Start with podium \session title 'Cache regression tests'. Coordinate with the parent through \issue mail." \ --start
--start already creates the worktree and agent. Do not follow it with podium agent spawn for the same child.
File discovered work for later
To record useful work that the current issue can ship without, stay on the current issue and create a top-level proposal:
podium issue create \ --title "Cache telemetry cleanup" \ --description "Remove obsolete cache telemetry in a separate change."podium issue dep-add new_issue_ref current_issue_ref \ --type discovered-from
Do not claim, start, or stage the proposal for another agent. If you are explicitly moving this session onto the new work instead, use podium issue attach --spinoff "Cache telemetry cleanup" --confirm-rehome; that command creates the top-level issue and relationship before rehoming the session.
Track a running child
Use the child issue or session identifier to read its state:
podium agent status child_issue_refpodium agent await child_session_id --timeout 60
await has a bounded timeout and reports current status when the child is still working.
Send cross-agent context
Address durable coordination to the issue unless one specific session must receive it:
podium mail send \ --to child_issue_ref \ --body "The API contract changed in commit abc1234. Rebase before editing."
Add --expect-response only when you need a reply. Use interrupt urgency only when continuing would waste work or create a conflict.
Podium does not serialize agents editing one worktree. Give each concurrent implementation its own issue and worktree, or assign explicit file ownership before both sessions edit.
For a shared resource that cannot be split by file or worktree, every participating session can take the same advisory lease with podium lock acquire resource_name --wait. A lease expires and does not enforce access, so it works only when every participant uses the same lock. Use podium merge-lock for branch merges rather than inventing another merge lock name.
Last modified on September 16, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Podium ADE","description":"Get started with Podium ADE. Explore guides for coordinating coding agents, managing tasks, shaping workflows, and running agents on your own VPS.","colors":{"primary":"#14222E","light":"#D5F36B","dark":"#14222E"},"logo":{"light":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=dcf3138d694db2bbff745fe4993c735d","dark":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=fd381d430739d8f0509f1be391285e07","href":"https://podium.do"},"favicon":"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=6a0cbef28ea17fcc5a8c24f51bf0af7a","appearance":{"default":"system","strict":false},"background":{"color":{"light":"#F7F3EA","dark":"#14222E"}},"navbar":{"links":[{"href":"https://podium.do","label":"Website"},{"href":"https://github.com/madeinorbit/podium","type":"github"}]},"footer":{"socials":{"x":"https://x.com/podium_ade","github":"https://github.com/madeinorbit/podium","website":"https://podium.do"},"links":[{"header":"Documentation","items":[{"label":"First issue","href":"/docs/quickstart"},{"label":"CLI reference","href":"/docs/reference/cli"},{"label":"Troubleshooting","href":"/docs/troubleshooting"},{"label":"Contribute","href":"/docs/guides/local-development"}]},{"header":"Podium","items":[{"label":"Website","href":"https://podium.do"},{"label":"X","href":"https://x.com/podium_ade"},{"label":"GitHub","href":"https://github.com/madeinorbit/podium"}]}]},"fonts":{"family":"DM Sans"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":false},"integrations":{"ga4":{"measurementId":"G-K1H7ZVMS51"}},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or has not been written yet. Use the navigation to keep exploring."}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":true},"metadata":{"timestamp":true},"navigation":{"global":{"tabs":[{"tab":"Docs","href":"/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"podium-420ab911","hasAudioNarration":false,"actualSubdomain":"podium-420ab911","customDomains":["podium.do"],"gitSource":{"type":"github","owner":"madeinorbit","repo":"podium-cloud","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6aee4ecf6e4c119f8a1c3dba","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Understand Podium","count":4},{"language":"default","tag":"Operate Podium","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Work in Podium","count":3},{"language":"default","tag":"Coordinate agents","count":2},{"language":"default","tag":"Contribute","count":2},{"language":"default","tag":"Reference","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".light #search-bar-entry,.light .breadcrumb-item,.light #header button,.light button .space-x-3>span,.light #footer a{color:#626363}.dark,.dark body{background-color:#14222e}.dark #footer a{color:#a8a8a8}.code-block code{display:block;max-width:100%;overflow-wrap:anywhere;white-space:pre-wrap}"}],"page":{"pagePath":"guides/delegate-agents","slug":"/guides/delegate-agents","pageMetadata":{"title":"Delegate work to other agents","description":"Choose review, decomposition, or discovered work without losing issue ownership.","contentType":"How-to","href":"/guides/delegate-agents"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Choose review, decomposition, or discovered work without losing issue ownership.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Delegate a bounded task when another agent can make progress independently. Decide where the work belongs before starting the agent, because placement controls ownership, worktrees, and issue history.`}),`\n`,_jsx(Heading,{level:`2`,id:`choose-the-work-shape`,children:`Choose the work shape`}),`\n`,_jsx(_components.p,{children:`Match the delegated task to one of these placements:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Situation`}),_jsx(_components.th,{children:`Placement`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Review or research on the current issue`}),_jsx(_components.td,{children:`Another session on the same issue`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Required implementation with its own deliverable`}),_jsx(_components.td,{children:`Child issue with its own worktree`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Useful work that can ship later`}),_jsxs(_components.td,{children:[`Top-level issue related as `,_jsx(_components.code,{children:`discovered-from`})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`add-a-reviewer-to-the-current-issue`,children:`Add a reviewer to the current issue`}),`\n`,_jsx(_components.p,{children:`Spawn another session on the same issue for bounded review:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,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:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` spawn`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --title`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Reviewer: error handling\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --prompt`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Placement: stay on this issue and work read-only. Review the `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`changed error paths and report concrete failures only. The coordinator and `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`implementation agent share this machine; send findings to the issue with `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`podium issue mail send your_issue_ref --body '\u003cfinding>'.\"`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Use this shape for read-only review or other work that does not need concurrent edits in the same checkout.`}),`\n`,_jsx(Heading,{level:`2`,id:`create-required-implementation-work`,children:`Create required implementation work`}),`\n`,_jsx(_components.p,{children:`Create and start a child issue in one command:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --parent-id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` your_issue_ref`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --title`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Cache regression coverage\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --description`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Add the regression tests required by the parent issue.\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --brief`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Own only the cache regression test files. Start with podium `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`session title 'Cache regression tests'. Coordinate with the parent through `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:`\\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`issue mail.\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --start`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--start`}),` already creates the worktree and agent. Do not follow it with `,_jsx(_components.code,{children:`podium agent spawn`}),` for the same child.`]}),`\n`,_jsx(Heading,{level:`2`,id:`file-discovered-work-for-later`,children:`File discovered work for later`}),`\n`,_jsx(_components.p,{children:`To record useful work that the current issue can ship without, stay on the current issue and create a top-level proposal:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,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:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --title`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Cache telemetry cleanup\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --description`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Remove obsolete cache telemetry in a separate change.\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` issue`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` dep-add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` new_issue_ref`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` current_issue_ref`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --type`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` discovered-from`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Do not claim, start, or stage the proposal for another agent. If you are explicitly moving this session onto the new work instead, use `,_jsx(_components.code,{children:`podium issue attach --spinoff \"Cache telemetry cleanup\" --confirm-rehome`}),`; that command creates the top-level issue and relationship before rehoming the session.`]}),`\n`,_jsx(Heading,{level:`2`,id:`track-a-running-child`,children:`Track a running child`}),`\n`,_jsx(_components.p,{children:`Use the child issue or session identifier to read its state:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` child_issue_ref`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` await`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` child_session_id`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --timeout`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 60`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`await`}),` has a bounded timeout and reports current status when the child is still working.`]}),`\n`,_jsx(Heading,{level:`2`,id:`send-cross-agent-context`,children:`Send cross-agent context`}),`\n`,_jsx(_components.p,{children:`Address durable coordination to the issue unless one specific session must receive it:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`podium`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` mail`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` send`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --to`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` child_issue_ref`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --body`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"The API contract changed in commit abc1234. Rebase before editing.\"`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Add `,_jsx(_components.code,{children:`--expect-response`}),` only when you need a reply. Use interrupt urgency only when continuing would waste work or create a conflict.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Podium does not serialize agents editing one worktree. Give each concurrent implementation its own issue and worktree, or assign explicit file ownership before both sessions edit.`})}),`\n`,_jsxs(_components.p,{children:[`For a shared resource that cannot be split by file or worktree, every participating session can take the same advisory lease with `,_jsx(_components.code,{children:`podium lock acquire resource_name --wait`}),`. A lease expires and does not enforce access, so it works only when every participant uses the same lock. Use `,_jsx(_components.code,{children:`podium merge-lock`}),` for branch merges rather than inventing another merge lock name.`]})]})}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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Delegate work to other agents","description":"Choose review, decomposition, or discovered work without losing issue ownership.","contentType":"How-to","href":"/guides/delegate-agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Choose the work shape","slug":"choose-the-work-shape","depth":2,"children":[]},{"title":"Add a reviewer to the current issue","slug":"add-a-reviewer-to-the-current-issue","depth":2,"children":[]},{"title":"Create required implementation work","slug":"create-required-implementation-work","depth":2,"children":[]},{"title":"File discovered work for later","slug":"file-discovered-work-for-later","depth":2,"children":[]},{"title":"Track a running child","slug":"track-a-running-child","depth":2,"children":[]},{"title":"Send cross-agent context","slug":"send-cross-agent-context","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/podium-420ab911/07c52c163b7febf9/accessibility.js"],"subdomain":"podium-420ab911","siteName":"Podium ADE","title":"Delegate work to other agents - Podium ADE","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-18T14:45:08.274Z","gitLastModified":"2026-09-16T23:38:39.000Z","originalFileLocation":"guides/delegate-agents.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose review, decomposition, or discovered work without losing issue ownership.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Podium ADE\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_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=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Delegate work to other agents - Podium ADE\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose review, decomposition, or discovered work without losing issue ownership.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Podium ADE\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://podium.do/docs/guides/delegate-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://podium-420ab911.mintlify.site/docs/_mintlify/api/og/v2?division=Coordinate+agents\u0026amp;title=Delegate+work+to+other+agents\u0026amp;description=Choose+review%2C+decomposition%2C+or+discovered+work+without+losing+issue+ownership.\u0026amp;theme=0b194e13f127fe4eafb1cad0\u0026amp;signature=c32608d9804e2f23b4c227539a9c887ec5f1a32c0545d3e8e9415efac112d582\">\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=\"Delegate work to other agents - Podium ADE\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose review, decomposition, or discovered work without losing issue ownership.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://podium-420ab911.mintlify.site/docs/_mintlify/api/og/v2?division=Coordinate+agents\u0026amp;title=Delegate+work+to+other+agents\u0026amp;description=Choose+review%2C+decomposition%2C+or+discovered+work+without+losing+issue+ownership.\u0026amp;theme=0b194e13f127fe4eafb1cad0\u0026amp;signature=c32608d9804e2f23b4c227539a9c887ec5f1a32c0545d3e8e9415efac112d582\">\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=\"/docs/mintlify-assets/_mintlify/favicons/podium-420ab911/OhfedqdHTTKOtdLh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Podium ADE\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#14222E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://podium.do/docs/guides/delegate-agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/delegate-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://podium.do/#organization\",\"name\":\"Podium ADE\",\"url\":\"https://podium.do\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/podium-420ab911/ppJxC5__R4gH8WLs/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=ppJxC5__R4gH8WLs\u0026q=85\u0026s=dcf3138d694db2bbff745fe4993c735d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://podium.do/docs#website\",\"name\":\"Podium ADE\",\"url\":\"https://podium.do/docs\",\"publisher\":{\"@id\":\"https://podium.do/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://podium.do/docs/guides/delegate-agents#webpage\",\"url\":\"https://podium.do/docs/guides/delegate-agents\",\"name\":\"Delegate work to other agents\",\"description\":\"Choose review, decomposition, or discovered work without losing issue ownership.\",\"dateModified\":\"2026-09-16T23:38:39.000Z\",\"isPartOf\":{\"@id\":\"https://podium.do/docs#website\"},\"breadcrumb\":{\"@id\":\"https://podium.do/docs/guides/delegate-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://podium.do/docs/guides/delegate-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Podium ADE\",\"item\":\"https://podium.do/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Delegate work to other agents\",\"item\":\"https://podium.do/docs/guides/delegate-agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://podium.do/docs/guides/delegate-agents#article\",\"headline\":\"Delegate work to other agents\",\"name\":\"Delegate work to other agents\",\"description\":\"Choose review, decomposition, or discovered work without losing issue ownership.\",\"url\":\"https://podium.do/docs/guides/delegate-agents\",\"mainEntityOfPage\":{\"@id\":\"https://podium.do/docs/guides/delegate-agents#webpage\"},\"dateModified\":\"2026-09-16T23:38:39.000Z\",\"publisher\":{\"@id\":\"https://podium.do/#organization\"},\"isPartOf\":{\"@id\":\"https://podium.do/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Podium ADE\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Podium ADE\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/guides/delegate-agents.md","siteName":"Podium ADE","nav":{"global":{"tabs":[{"tab":"Docs","href":"/"}]},"groups":[{"group":"Get started","pages":[{"title":"Run coding agents with Podium","href":"/index"},{"title":"Install and set up Podium","href":"/getting-started/install"},{"title":"Complete your first issue","href":"/quickstart"}]},{"group":"Understand Podium","pages":[{"title":"Understand how Podium runs agents","href":"/concepts/how-podium-works"},{"title":"Understand issues, sessions, agents, and harnesses","href":"/concepts/agents"},{"title":"Understand repositories, worktrees, and machines","href":"/concepts/workspaces"},{"title":"Check feature availability","href":"/reference/feature-availability"}]},{"group":"Work in Podium","pages":[{"title":"Create and track issue work","href":"/guides/create-track-issues"},{"title":"Supervise a running agent session","href":"/guides/supervise-sessions"},{"title":"Review and accept agent work","description":"Use diffs, checks, artifacts, and offers to make a clear review decision.","href":"/guides/review-work"}]},{"group":"Coordinate agents","pages":[{"title":"Delegate work to other agents","href":"/guides/delegate-agents"},{"title":"Add a remote machine","description":"Pair another Linux host, verify its harnesses, and place issue work on it.","href":"/guides/add-machine"}]},{"group":"Operate Podium","pages":[{"title":"Configure a Podium installation","href":"/reference/configuration"},{"title":"Update and back up Podium","href":"/guides/update-backup"},{"title":"Protect Podium data and credentials","href":"/security/privacy"},{"title":"Troubleshoot Podium by layer","href":"/troubleshooting"}]},{"group":"Reference","pages":[{"title":"Use the Podium CLI","href":"/reference/cli"},{"title":"Reference issue and session states","href":"/reference/lifecycle"}]},{"group":"Contribute","pages":[{"title":"Develop the documentation","href":"/guides/local-development"},{"title":"Deploy the documentation","href":"/guides/deployment"}]}]},"basePath":"","title":"Delegate work to other agents - Podium ADE","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":[],"chunks":[]}