Read this guide as markdown

Glossary: on-screen names and agent names

Each row pairs the words on screen with the name an agent uses for the same thing. The note explains any difference.

On screenAgent nameNote
Roadmapcol-ideas (column id)The user sees the title; agents and the API use the id.
Triagingcol-triage (column id)The user sees the title; agents and the API use the id.
Refiningcol-refine (column id)The user sees the title; agents and the API use the id.
Backlog (later)col-backlog (column id)The user sees the title; agents and the API use the id.
Sooncol-soon (column id)The user sees the title; agents and the API use the id.
Nextcol-next (column id)The user sees the title; agents and the API use the id.
Planningcol-plan (column id)The user sees the title; agents and the API use the id.
Implementingcol-implement (column id)The user sees the title; agents and the API use the id.
Review PRcol-pr-ready (column id)The user sees the title; agents and the API use the id.
Landingcol-land (column id)The user sees the title; agents and the API use the id.
Queuedcol-queued (column id)The user sees the title; agents and the API use the id.
Releasingcol-release (column id)The user sees the title; agents and the API use the id.
Donecol-done (column id)The user sees the title; agents and the API use the id.
Your taskscol-human (column id)The user sees the title; agents and the API use the id.
Parking lotcol-parking (column id)The user sees the title; agents and the API use the id.
Parentscol-awaiting-children (column id)The user sees the title; agents and the API use the id.
Roadmapunrefined (step)The board shows "Roadmap"; agents and the API use the step key unrefined.
Dedupingdedup_check (step)The board shows "Deduping"; agents and the API use the step key dedup_check.
Admittingadmittance (step)The board shows "Admitting"; agents and the API use the step key admittance.
Refiningrefining (step)
Breaking downbreakdown (step)The board shows "Breaking down"; agents and the API use the step key breakdown.
Researchingspike (step)The board shows "Researching"; agents and the API use the step key spike.
Backlog (later)backlog (step)The board shows "Backlog (later)"; agents and the API use the step key backlog.
Soonsprint_soon (step)The board shows "Soon"; agents and the API use the step key sprint_soon.
Nextsprint_next (step)The board shows "Next"; agents and the API use the step key sprint_next.
Planningplanning (step)
Reviewing planplan_review (step)The board shows "Reviewing plan"; agents and the API use the step key plan_review.
Readyready_to_impl (step)The board shows "Ready"; agents and the API use the step key ready_to_impl.
Implementingimplementing (step)
Reviewing codecode_review (step)The board shows "Reviewing code"; agents and the API use the step key code_review.
Testingqa (step)The board shows "Testing"; agents and the API use the step key qa.
Review PRpr_ready (step)The board shows "Review PR"; agents and the API use the step key pr_ready.
Simulating CIci_simulation (step)The board shows "Simulating CI"; agents and the API use the step key ci_simulation.
Mergingmerge (step)The board shows "Merging"; agents and the API use the step key merge.
Follow-upslanding (step)The board shows "Follow-ups"; agents and the API use the step key landing.
Queuedrelease_queue (step)The board shows "Queued"; agents and the API use the step key release_queue.
Releasingdeploy (step)The board shows "Releasing"; agents and the API use the step key deploy.
Parentsawaiting_children (step)The board shows "Parents"; agents and the API use the step key awaiting_children.
Donedone (step)
Donemerged_duplicate (step)Shares its board label with other steps; the API names the exact step.
Parking lotparking (step)The board shows "Parking lot"; agents and the API use the step key parking.
Your taskshuman_todo (step)Shares its board label with other steps; the API names the exact step.
Your taskshuman_in_progress (step)Shares its board label with other steps; the API names the exact step.
Your taskshuman_done (step)Shares its board label with other steps; the API names the exact step.
Approve refinementrefine.accept (gate)The approval card shows "Approve refinement"; the API and the lifecycle name this gate refine.accept.
Approve breakdownbreakdown.accept (gate)The approval card shows "Approve breakdown"; the API and the lifecycle name this gate breakdown.accept.
Approve planplan.approve (gate)The approval card shows "Approve plan"; the API and the lifecycle name this gate plan.approve.
Approve mergepr.merge (gate)The approval card shows "Approve merge"; the API and the lifecycle name this gate pr.merge.
Approve releasedeploy.release (gate)The approval card shows "Approve release"; the API and the lifecycle name this gate deploy.release.
Set prioritybacklog.prioritize (gate)The approval card shows "Set priority"; the API and the lifecycle name this gate backlog.prioritize.
Plan sprintssprint.plan (gate)The approval card shows "Plan sprints"; the API and the lifecycle name this gate sprint.plan.
File follow-upsfollowups.file (gate)The approval card shows "File follow-ups"; the API and the lifecycle name this gate followups.file.
Promote ideasideas.promote (gate)The approval card shows "Promote ideas"; the API and the lifecycle name this gate ideas.promote.
Approve replacementrefine.supersede (gate)The approval card shows "Approve replacement"; the API and the lifecycle name this gate refine.supersede.
Close as already builtrefine.already-built (gate)The approval card shows "Close as already built"; the API and the lifecycle name this gate refine.already-built.
Close as already builtbuild.already-built (gate)The approval card shows "Close as already built"; the API and the lifecycle name this gate build.already-built.
Approve replacementtriage.supersede (gate)The approval card shows "Approve replacement"; the API and the lifecycle name this gate triage.supersede.
Revise acceptance criteriaacceptance.revise (gate)The approval card shows "Revise acceptance criteria"; the API and the lifecycle name this gate acceptance.revise.
Rule on recheckparked.recheck-item (gate)The approval card shows "Rule on recheck"; the API and the lifecycle name this gate parked.recheck-item.
Review finished cardsdone.review (gate)The approval card shows "Review finished cards"; the API and the lifecycle name this gate done.review.
Parent progress reviewparent.progress (gate)The approval card shows "Parent progress review"; the API and the lifecycle name this gate parent.progress.
Close as duplicatededup.close-duplicate (gate)The approval card shows "Close as duplicate"; the API and the lifecycle name this gate dedup.close-duplicate.
Groom ideasideas.groom (gate)The approval card shows "Groom ideas"; the API and the lifecycle name this gate ideas.groom.
Two open pull requestspr.two-open (gate)The approval card shows "Two open pull requests"; the API and the lifecycle name this gate pr.two-open.
File guidance taskguidance.file (gate)The approval card shows "File guidance task"; the API and the lifecycle name this gate guidance.file.
CI simulation reportci.simulation-report (gate)
Jump the recheck queueparked.staleness (gate)The approval card shows "Jump the recheck queue"; the API and the lifecycle name this gate parked.staleness.
File harness fixharness.file (gate)The approval card shows "File harness fix"; the API and the lifecycle name this gate harness.file.
Factory stalledfactory.stalled (gate)
Production behinddeploy.behind (gate)The approval card shows "Production behind"; the API and the lifecycle name this gate deploy.behind.
Base branch is redbase.red (gate)The approval card shows "Base branch is red"; the API and the lifecycle name this gate base.red.
Unexplained workspace changewrite-scope.notice (gate)The approval card shows "Unexplained workspace change"; the API and the lifecycle name this gate write-scope.notice.
Plan can't start buildingshaping.stale (gate)The approval card shows "Plan can't start building"; the API and the lifecycle name this gate shaping.stale.
Onboarding sandboxrepo.environment-branch-build (gate)The approval card shows "Onboarding sandbox"; the API and the lifecycle name this gate repo.environment-branch-build.
Task tree at its size limittree.hold (gate)The approval card shows "Task tree at its size limit"; the API and the lifecycle name this gate tree.hold.
Waiting on queued workdependency.clash (gate)The approval card shows "Waiting on queued work"; the API and the lifecycle name this gate dependency.clash.
Tasks queued behind their own dependenciespipeline.audit (gate)The approval card shows "Tasks queued behind their own dependencies"; the API and the lifecycle name this gate pipeline.audit.
Needs your inputadhoc (approval case)The user sees "Needs your input"; agents use the key adhoc.
Needs your inputinput.required (approval case)The user sees "Needs your input"; agents use the key input.required.
Looks like several tasksplan.split-suggested (approval case)The user sees "Looks like several tasks"; agents use the key plan.split-suggested.
Planning found a better routeplan.route-suggested (approval case)The user sees "Planning found a better route"; agents use the key plan.route-suggested.
Approve replacementtask.supersede (approval case)The user sees "Approve replacement"; agents use the key task.supersede.
Close as already builttask.already-built (approval case)The user sees "Close as already built"; agents use the key task.already-built.
Handle duplicatesdedup.resolve (approval case)The user sees "Handle duplicates"; agents use the key dedup.resolve.
Clarify duplicatededup.clarify (approval case)The user sees "Clarify duplicate"; agents use the key dedup.clarify.
Resolve acceptance conflictacceptance.conflict (approval case)The user sees "Resolve acceptance conflict"; agents use the key acceptance.conflict.
Resolve build handoffimplement.handoff-exhausted (approval case)The user sees "Resolve build handoff"; agents use the key implement.handoff-exhausted.
Resolve build blockerimplement.blocked (approval case)The user sees "Resolve build blocker"; agents use the key implement.blocked.
Review no-code outcometask.no-code-needed (approval case)The user sees "Review no-code outcome"; agents use the key task.no-code-needed.
Confirm work already landedtask.already-landed (approval case)The user sees "Confirm work already landed"; agents use the key task.already-landed.
Continue rolloutdeploy.continue (approval case)The user sees "Continue rollout"; agents use the key deploy.continue.
Resolve merge refusalpull-request.merge-refusal (approval case)The user sees "Resolve merge refusal"; agents use the key pull-request.merge-refusal.
Resolve timeoutrun.timeout (approval case)The user sees "Resolve timeout"; agents use the key run.timeout.
Recover failed runrun.failure (approval case)The user sees "Recover failed run"; agents use the key run.failure.
Resolve workspace incidentrun.incident (approval case)The user sees "Resolve workspace incident"; agents use the key run.incident.
Continue research?research.continue (approval case)The user sees "Continue research?"; agents use the key research.continue.
Strategy questionsbreakdown.questions (approval case)The user sees "Strategy questions"; agents use the key breakdown.questions.
Plan questionsplan.questions (approval case)
Admittriage.admit (approval case)The user sees "Admit"; agents use the key triage.admit.
Waiting on other workimplement.blocked-on-work (approval case)The user sees "Waiting on other work"; agents use the key implement.blocked-on-work.
Out of build roundsimplement.exhausted (approval case)The user sees "Out of build rounds"; agents use the key implement.exhausted.
Pull request closedpr.closed (approval case)The user sees "Pull request closed"; agents use the key pr.closed.
Pull request unreachablepr.unreachable (approval case)The user sees "Pull request unreachable"; agents use the key pr.unreachable.
Pull request merged elsewherepr.merge-mismatch (approval case)The user sees "Pull request merged elsewhere"; agents use the key pr.merge-mismatch.
Questions to answerquestions.answer (approval case)The user sees "Questions to answer"; agents use the key questions.answer.
Prepare repository environmentrepo.environment-change (approval case)The user sees "Prepare repository environment"; agents use the key repo.environment-change.
Decide environment needsrepo.environment-needs (approval case)The user sees "Decide environment needs"; agents use the key repo.environment-needs.
Resolve subscription failoveragent.failover (approval case)The user sees "Resolve subscription failover"; agents use the key agent.failover.
Review requested changestask.change-review (approval case)The user sees "Review requested changes"; agents use the key task.change-review.
won't docloseReason.kind = wont_do (API field)The user sees "won't do"; agents use the key closeReason.kind = wont_do.
obsoletecloseReason.kind = obsolete (API field)The user sees "obsolete"; agents use the key closeReason.kind = obsolete.
not relevantcloseReason.kind = not_relevant (API field)The user sees "not relevant"; agents use the key closeReason.kind = not_relevant.
supersededcloseReason.kind = superseded (API field)The user sees "superseded"; agents use the key closeReason.kind = superseded.
deployedcloseReason.kind = deployed (API field)The user sees "deployed"; agents use the key closeReason.kind = deployed.
no deploy neededcloseReason.kind = no_code (API field)The user sees "no deploy needed"; agents use the key closeReason.kind = no_code.
all children donecloseReason.kind = delegation_complete (API field)The user sees "all children done"; agents use the key closeReason.kind = delegation_complete.
duplicatecloseReason.kind = duplicate (API field)The user sees "duplicate"; agents use the key closeReason.kind = duplicate.
GroomingPassName grooming (vocabulary key)The user sees "Grooming"; agents use the key PassName grooming.
Ideas groomingPassName ideas-grooming (vocabulary key)The user sees "Ideas grooming"; agents use the key PassName ideas-grooming.
Sprint planningPassName sprint-planning (vocabulary key)The user sees "Sprint planning"; agents use the key PassName sprint-planning.
PromotePassName promote (vocabulary key)The user sees "Promote"; agents use the key PassName promote.
Parking-lot checkPassName unpark (vocabulary key)The user sees "Parking-lot check"; agents use the key PassName unpark.
Done reviewPassName done-review (vocabulary key)The user sees "Done review"; agents use the key PassName done-review.
Guidance gapsPassName guidance (vocabulary key)The user sees "Guidance gaps"; agents use the key PassName guidance.
Feedback reviewPassName feedback-review (vocabulary key)The user sees "Feedback review"; agents use the key PassName feedback-review.
Autopilot judgmentPassName autopilot (vocabulary key)The user sees "Autopilot judgment"; agents use the key PassName autopilot.
Create ideascreateIdea (MCP tool)The user sees "Create ideas"; the MCP tool is createIdea.
Edit unstarted ideaseditUnstartedIdea (MCP tool)The user sees "Edit unstarted ideas"; the MCP tool is editUnstartedIdea.
Propose task changesproposeTaskChange (MCP tool)The user sees "Propose task changes"; the MCP tool is proposeTaskChange.
Set prioritiessetTaskPriority (MCP tool)Agent MCP grants shows "Set priorities"; Assistant settings and chat show "Set task priority".
Promote ideaspromoteIdea (MCP tool)The user sees "Promote ideas"; the MCP tool is promoteIdea.
Schedule future workscheduleFutureTask (MCP tool)Agent MCP grants shows "Schedule future work"; Assistant settings and chat show "Schedule future tasks".
Start board passestriggerBoardPass (MCP tool)The user sees "Start board passes"; the MCP tool is triggerBoardPass.
Pull in next sprintpullNextSprint (MCP tool)Agent MCP grants shows "Pull in next sprint"; Assistant settings and chat show "Pull the next sprint".
Dismiss provider warningsdismissProviderWarning (MCP tool)The user sees "Dismiss provider warnings"; the MCP tool is dismissProviderWarning.
Run code experimentsrunCodeExperiment (MCP tool)The user sees "Run code experiments"; the MCP tool is runCodeExperiment.
Report factory problemsreportFeedback (MCP tool)The user sees "Report factory problems"; the MCP tool is reportFeedback.
Start CI simulationssimulateCi (MCP tool)The user sees "Start CI simulations"; the MCP tool is simulateCi.
Intake and questionsAGENT_APPROVAL_CATEGORIES intakeAndQuestions (vocabulary key)The user sees "Intake and questions"; agents use the key AGENT_APPROVAL_CATEGORIES intakeAndQuestions.
Idea promotionAGENT_APPROVAL_CATEGORIES ideaPromotion (vocabulary key)The user sees "Idea promotion"; agents use the key AGENT_APPROVAL_CATEGORIES ideaPromotion.
Guidance filingAGENT_APPROVAL_CATEGORIES guidanceFiling (vocabulary key)The user sees "Guidance filing"; agents use the key AGENT_APPROVAL_CATEGORIES guidanceFiling.
Run recoveryAGENT_APPROVAL_CATEGORIES runRecovery (vocabulary key)The user sees "Run recovery"; agents use the key AGENT_APPROVAL_CATEGORIES runRecovery.
Build dispatchAGENT_APPROVAL_CATEGORIES buildDispatch (vocabulary key)The user sees "Build dispatch"; agents use the key AGENT_APPROVAL_CATEGORIES buildDispatch.
Follow-up filingAGENT_APPROVAL_CATEGORIES followupFiling (vocabulary key)The user sees "Follow-up filing"; agents use the key AGENT_APPROVAL_CATEGORIES followupFiling.
Plan approvalAGENT_APPROVAL_CATEGORIES planRatification (vocabulary key)The user sees "Plan approval"; agents use the key AGENT_APPROVAL_CATEGORIES planRatification.
Definition approvalAGENT_APPROVAL_CATEGORIES definitionRatification (vocabulary key)The user sees "Definition approval"; agents use the key AGENT_APPROVAL_CATEGORIES definitionRatification.
Breakdown approvalAGENT_APPROVAL_CATEGORIES breakdownRatification (vocabulary key)The user sees "Breakdown approval"; agents use the key AGENT_APPROVAL_CATEGORIES breakdownRatification.
Definition revisionAGENT_APPROVAL_CATEGORIES definitionRevision (vocabulary key)The user sees "Definition revision"; agents use the key AGENT_APPROVAL_CATEGORIES definitionRevision.
Acceptance revisionAGENT_APPROVAL_CATEGORIES acceptanceRevision (vocabulary key)The user sees "Acceptance revision"; agents use the key AGENT_APPROVAL_CATEGORIES acceptanceRevision.
Relationship changesAGENT_APPROVAL_CATEGORIES relationshipChange (vocabulary key)The user sees "Relationship changes"; agents use the key AGENT_APPROVAL_CATEGORIES relationshipChange.
Repository assignmentAGENT_APPROVAL_CATEGORIES repositoryAssignment (vocabulary key)The user sees "Repository assignment"; agents use the key AGENT_APPROVAL_CATEGORIES repositoryAssignment.
Backlog prioritizationAGENT_APPROVAL_CATEGORIES backlogPrioritization (vocabulary key)The user sees "Backlog prioritization"; agents use the key AGENT_APPROVAL_CATEGORIES backlogPrioritization.
Sprint commitmentAGENT_APPROVAL_CATEGORIES sprintCommitment (vocabulary key)The user sees "Sprint commitment"; agents use the key AGENT_APPROVAL_CATEGORIES sprintCommitment.
Merge and releaseAGENT_APPROVAL_CATEGORIES mergeAndRelease (vocabulary key)The user sees "Merge and release"; agents use the key AGENT_APPROVAL_CATEGORIES mergeAndRelease.
Duplicate closureAGENT_APPROVAL_CATEGORIES duplicateClosure (vocabulary key)The user sees "Duplicate closure"; agents use the key AGENT_APPROVAL_CATEGORIES duplicateClosure.
Move anywayAGENT_APPROVAL_CATEGORIES pipelineOrderOverride (vocabulary key)The user sees "Move anyway"; agents use the key AGENT_APPROVAL_CATEGORIES pipelineOrderOverride.
Base branch fix filingAGENT_APPROVAL_CATEGORIES baseRedFixFiling (vocabulary key)The user sees "Base branch fix filing"; agents use the key AGENT_APPROVAL_CATEGORIES baseRedFixFiling.
The case's approve buttonAGENT_APPROVAL_DECISIONS approve (vocabulary key)The approve button depends on the case; respondToApproval takes the decision, the latest decisionFingerprint from getApproval, and a requestId.
Send back to <step>…AGENT_APPROVAL_DECISIONS sendBack (vocabulary key)The visible text names the destination step; the decision only says send back.
Send to <build step>…AGENT_APPROVAL_DECISIONS sendBackToBuild (vocabulary key)The user sees "Send to <build step>…"; agents use the key AGENT_APPROVAL_DECISIONS sendBackToBuild.
Answering a carried questionAGENT_APPROVAL_DECISIONS answerQuestion (vocabulary key)The user sees "Answering a carried question"; agents use the key AGENT_APPROVAL_DECISIONS answerQuestion.
The recovery buttons on a failed runAGENT_APPROVAL_DECISIONS recover (vocabulary key)Covers plain retry, committing stray changes as wip, and a memory size the host can give. Discarding stray changes stays human-only.
Release a stopped taskAGENT_APPROVAL_DECISIONS recoverInert (vocabulary key)An Autopilot ability, not a button. It releases a task from the "This task stopped moving" card with a plain retry, only while nothing the scheduler checks still holds it.
File a fix taskAGENT_APPROVAL_DECISIONS fileFix (vocabulary key)A permission Autopilot holds at Up to P1. No agent can use it on the Base branch is red card yet.
File N · decline MAGENT_APPROVAL_DECISIONS disposeFollowUps (vocabulary key)The button's counts come from per-row choices; the decision carries one disposition per follow-up.
Releasing held workAGENT_APPROVAL_DECISIONS resumeRelease (vocabulary key)The user sees "Releasing held work"; agents use the key AGENT_APPROVAL_DECISIONS resumeRelease.
Agent MCP grantsagent-mcp-grants (settings page id)People still call this page Agent Access, its old name. /settings/access redirects here.
An approval cardapproval (route)The user sees "An approval card"; it lives at the route approval.
A task pagetask (route)The user sees "A task page"; it lives at the route task.
Activityactivity (route)
Usageusage (route)
Answering an approvalrespondToApproval (MCP tool)Listed only for a session with an approval category.
Task listscanTasks (MCP tool)The user sees "Task list"; the MCP tool is scanTasks.
A task's full storygetTasks (MCP tool)The user sees "A task's full story"; the MCP tool is getTasks.
A task's dependencies and parentgetRelationships (MCP tool)The user sees "A task's dependencies and parent"; the MCP tool is getRelationships.
Workspace overviewgetWorkspaceOverview (MCP tool)The user sees "Workspace overview"; the MCP tool is getWorkspaceOverview.
Task throughputgetTaskThroughput (MCP tool)The user sees "Task throughput"; the MCP tool is getTaskThroughput.
Failure patternsgetFailurePatterns (MCP tool)The user sees "Failure patterns"; the MCP tool is getFailurePatterns.
Improvement signalsgetImprovementSignals (MCP tool)The user sees "Improvement signals"; the MCP tool is getImprovementSignals.
Guidance gapsscanGuidanceGaps (MCP tool)The user sees "Guidance gaps"; the MCP tool is scanGuidanceGaps.
Factory feedbackscanFeedback (MCP tool)The user sees "Factory feedback"; the MCP tool is scanFeedback.
InboxscanApprovals (MCP tool)The user sees "Inbox"; the MCP tool is scanApprovals.
One approval cardgetApproval (MCP tool)The user sees "One approval card"; the MCP tool is getApproval.
An approval's supporting detailgetApprovalContext (MCP tool)The user sees "An approval's supporting detail"; the MCP tool is getApprovalContext.
A task's contextgetTaskContext (MCP tool)The user sees "A task's context"; the MCP tool is getTaskContext.
A task's timelinegetTaskHistory (MCP tool)The user sees "A task's timeline"; the MCP tool is getTaskHistory.
Runs in ActivityscanRuns (MCP tool)The user sees "Runs in Activity"; the MCP tool is scanRuns.
One rungetRun (MCP tool)The user sees "One run"; the MCP tool is getRun.
A turn's transcript excerptgetTurnExcerpt (MCP tool)The user sees "A turn's transcript excerpt"; the MCP tool is getTurnExcerpt.
Turn usagelistTurns (MCP tool)The user sees "Turn usage"; the MCP tool is listTurns.
A task's runs and their verdictsscanTaskRuns (MCP tool)The user sees "A task's runs and their verdicts"; the MCP tool is scanTaskRuns.
A task's approvals and their answersscanTaskApprovals (MCP tool)The user sees "A task's approvals and their answers"; the MCP tool is scanTaskApprovals.
A task's history eventsscanTaskEvents (MCP tool)The user sees "A task's history events"; the MCP tool is scanTaskEvents.
Recent verdicts across the workspacescanVerdicts (MCP tool)The user sees "Recent verdicts across the workspace"; the MCP tool is scanVerdicts.
Workspace settings that are safe to sharegetSafeSettings (MCP tool)The user sees "Workspace settings that are safe to share"; the MCP tool is getSafeSettings.
PreviewshowPreview (MCP tool)The user sees "Preview"; the MCP tool is showPreview.
Product guidereadGuide (MCP tool)The user sees "Product guide"; the MCP tool is readGuide.