--- status: active system: tasks specification_version: 1 migration: in_progress owners: - kandev --- # Task and workflow system ## Purpose The task and workflow system owns durable work items, task relationships, execution lifecycle, workflow steps, queued launches, and the contracts that move a task through its configured process. ## Ownership This system owns task identity and metadata, task documents and attachments, parent and dependency relationships, task creation and launch behavior, task runtime state publication, workflow definitions and transitions, completion signals, and task-scoped scheduling contracts. ## Exclusions - Agent identity, permissions, and runtime profiles belong to the [agent system](../agents). - Repository and worktree ownership belongs to the [workspace system](../workspaces). - Office-specific autonomous agent identities and dashboards belong to the [Office system](../office). - Presentation-only behavior belongs to the [UI specifications](../ui). ## Specification map ### Requirements - [Initial task brief](requirements/initial-task-brief.md) - [Task completion, conversation follow-ups, and workspace access](requirements/task-completion.md) - [Agent-Generated Task Titles](requirements/agent-generated-titles.md) - [Additional Session Workspace Reuse](requirements/additional-session-workspace-reuse.md) - [Task Archive Confirmation](requirements/archive-confirmation.md) - [Task removal navigation](requirements/removal-navigation.md) - [Attach Workspace Sources](requirements/attach-workspace-sources.md) - [Task Autopilot Mode](requirements/autopilot-mode.md) - [Blocked Task Escalation](requirements/blocked-task-escalation.md) - [Board priority sort and filter](requirements/board-priority-sort-filter.md) - [Board priority sort and filter ordering](requirements/board-priority-sort-filter-order.md) - [Board priority sort and filter view state](requirements/board-priority-sort-filter-view-state.md) - [Command-panel archived task results](requirements/command-panel-archived-task-results.md) - [Active clarification lifecycle scenarios](requirements/clarification-active-lifecycle-scenarios.md) - [Active clarification lifecycle](requirements/clarification-active-lifecycle.md) - [Clarification response reliability](requirements/clarification-response-reliability.md) - [Task Documents](requirements/documents.md) - [Detached Workspace Continuity](requirements/detached-workspace-continuity.md) - [Task plan append-mode write](requirements/plan-write-append-mode.md) - [Task Execution Stages](requirements/execution-stages.md) - [External task ID idempotency boundaries](requirements/external-id-idempotency-boundaries.md) - [External task ID idempotency scenarios](requirements/external-id-idempotency-scenarios.md) - [External task ID idempotency](requirements/external-id-idempotency.md) - [Interrupted Task Indicator](requirements/interrupted-task-indicator.md) - [Kanban task cache preserves executor fields across merges](requirements/kanban-task-executor-cache-staleness.md) - [Task Labels](requirements/labels.md) - [Link Existing Task to External References](requirements/link-existing-task-github-issue.md) - [MCP-Created Task Agent Profile Default](requirements/mcp-task-agent-profile-default.md) - [MCP Tool Name Stability](requirements/mcp-tool-name-stability.md) - [MCP workspace modes](requirements/mcp-workspace-mode.md) - [Missing task route recovery](requirements/missing-task-route-recovery.md) - [Task model unification](requirements/model-unification.md) - [Multi-branch tasks](requirements/multi-branch.md) - [Parent-Child Message Interrupt](requirements/parent-child-message-interrupt.md) - [Parent-Child Task Stop](requirements/parent-child-task-stop.md) - [Passthrough Queued Prompt Dispatch](requirements/passthrough-queued-prompt-dispatch.md) - [Task plan content size limit](requirements/plan-content-size-limit.md) - [Task Plan Comments](requirements/plan-comments.md) - [Task plan write consistency](requirements/plan-write-consistency.md) - [Passthrough Initial Prompt Turn Boundary](requirements/passthrough-initial-prompt-turn-boundary.md) - [Prevent Agent Auto-Start On Open](requirements/prevent-agent-autostart-on-open.md) - [Prompt attachments](requirements/prompt-attachments.md) - [Saved Prompt Delivery](requirements/saved-prompt-delivery.md) - [Quick Chat Sessions, Persistence, and Expiration](requirements/quick-chat-expiration.md) - [Quick Chat Agent Titles](requirements/quick-chat-agent-titles.md) - [Quick Chat Repository Context](requirements/quick-chat-repository-context.md) - [Remote Contribution Tasks](requirements/remote-contribution-tasks.md) - [Rich task title previews](requirements/rich-task-title-previews.md) - [Queued run scheduling](requirements/run-scheduling.md) - [Resume prompt queue](requirements/resume-prompt-queue.md) - [Task Runtime Cleanup](requirements/runtime-cleanup.md) - [Managed Branch Compaction](requirements/managed-branch-compaction.md) - [Task Terminal Persistence](requirements/task-terminal-persistence.md) - [Runtime Task-State Publication Order](requirements/runtime-state-publication-order.md) - [Session Delete Preserves Task Workspaces](requirements/session-delete-resource-cleanup.md) - [Sidebar Task Editing](requirements/sidebar-task-edit.md) - [Task Actions Menu on Preview and Detail Surfaces](requirements/task-actions-menu.md) - [Task menu grouping](requirements/task-menu-grouping.md) - [Task Actions Menu In-Flight and Concurrency](requirements/task-actions-menu-concurrency.md) - [Task Actions Menu Action Outcomes](requirements/task-actions-menu-outcomes.md) - [Subtasks as Workflow Checklist](requirements/subtask-checklist.md) - [Subtask Completion Trigger](requirements/subtask-completion-trigger.md) - [Subtask detachment](requirements/subtask-detachment.md) - [Subtask re-parenting by drag and drop](requirements/subtask-reparenting-drag-drop.md) - [Task Subtree Controls](requirements/subtree-controls.md) - [Create Task Escape Dismissal](requirements/task-create-escape-dismissal.md) - [Task Create Agent Compatibility Recovery](requirements/task-create-agent-executor-compatibility.md) - [Task Create Executor Default](requirements/task-create-executor-default.md) - [Task Create Launch Preview](requirements/task-create-launch-preview.md) - [Task Create Workflow Memory](requirements/task-create-workflow-memory.md) - [Task-create advanced settings disclosure](requirements/task-dependencies-create-dialog-advanced-settings.md) - [Task-create dependency selector refinement](requirements/task-dependencies-create-dialog-dependency-selector.md) - [Edit task dependencies](requirements/task-dependency-detail-editing.md) - [Task Dependencies and Auto-Start Chains](requirements/task-dependencies.md) - [Dependency Gate Skip Visibility](requirements/dependency-gate-skip-visibility.md) - [Session Launch Repository Resolution](requirements/launch-repository-resolution.md) - [Session stall visibility and orphan healing](requirements/session-stall-visibility.md) - [Task Launch Failure Recovery](requirements/task-launch-failure-recovery.md) - [Worktree metadata recovery](requirements/worktree-metadata-recovery.md) - [Task priority visibility](requirements/task-priority-visibility.md) - [Threads task actions](requirements/threads-task-actions.md) - [Task Title Length Limit](requirements/title-length-limit.md) - [User Question Turn Boundary](requirements/user-question-turn-boundary.md) - [WIP Limits and Visible Overflow Queues](requirements/wip-limit-pull-system.md) - [Tasks Without Repositories](requirements/without-repositories.md) - [Workflow completion-signal payload delivery](requirements/workflow-completion-signal-payload-delivery.md) - [Cancelled Turn Completion](requirements/workflow-cancelled-turn-completion.md) - [Workflow Cycle Guardrails](requirements/workflow-cycle-guardrails.md) - [Workflow Duplication](requirements/workflow-duplication.md) - [Explicit Workflow-Step Completion Signal](requirements/workflow-explicit-completion-signal.md) - [Workflow Profile Session Lifecycle and Recipients](requirements/workflow-profile-session-lifecycle.md) - [Agent decision recording](requirements/workflow-quorum-decision-recording-agent-surface.md) - [Quorum ordering and concurrency](requirements/workflow-quorum-decision-recording-concurrency.md) - [Quorum diagnostics](requirements/workflow-quorum-decision-recording-diagnostics.md) - [Quorum participant slate](requirements/workflow-quorum-decision-recording-participant-slate.md) - [Decision-triggered quorum re-evaluation](requirements/workflow-quorum-decision-recording-reevaluation.md) - [Quorum regression behavior](requirements/workflow-quorum-decision-recording-regression.md) - [Quorum step binding and thresholds](requirements/workflow-quorum-decision-recording-step-binding.md) - [Quorum verdict vocabulary](requirements/workflow-quorum-decision-recording-verdict-vocabulary.md) - [Workflow quorum decision recording](requirements/workflow-quorum-decision-recording.md) - [Conditional Workflow Session Settings](requirements/workflow-session-settings.md) - [Workflow Settings Autosave](requirements/workflow-settings-autosave.md) - [Workflow Step Agent Start Ownership](requirements/workflow-step-agent-start-ownership.md) - [Workflow Sync — Per-User Workspace Authorization](requirements/workflow-sync-workspace-authz.md) - [Workflow task-step transition ledger scenarios](requirements/workflow-task-step-transition-ledger-scenarios.md) - [Workflow task-step transition ledger](requirements/workflow-task-step-transition-ledger.md) - [Human Assignee and Actor Attribution](requirements/human-assignee.md) ### System design - [Initial task brief](system-design/initial-task-brief.md) - [Task completion, conversation follow-ups, and workspace access](system-design/task-completion.md) - [Additional Session Workspace Reuse](system-design/additional-session-workspace-reuse.md) - [Environment-Owned Git Status](system-design/environment-owned-git-status.md) - [Attach Workspace Sources](system-design/attach-workspace-sources.md) - [Command-panel archived task results](system-design/command-panel-archived-task-results.md) - [Detached Workspace Continuity](system-design/detached-workspace-continuity.md) - [Quick Chat Agent Titles](system-design/quick-chat-agent-titles.md) - [Quick Chat Session Resumption](system-design/quick-chat-session-resumption.md) - [Active clarification lifecycle](system-design/clarification-active-lifecycle.md) - [Clarification response reliability](system-design/clarification-response-reliability.md) - [External task ID idempotency operations](system-design/external-id-idempotency-operations.md) - [External task ID idempotency](system-design/external-id-idempotency.md) - [Task model unification](system-design/model-unification.md) - [MCP Tool Name Stability](system-design/mcp-tool-name-stability.md) - [MCP workspace modes](system-design/mcp-workspace-mode.md) - [Remote Contribution Tasks](system-design/remote-contribution-tasks.md) - [Branch history explanations](system-design/branch-history-explanations.md) - [Passthrough Queued Prompt Dispatch](system-design/passthrough-queued-prompt-dispatch.md) - [Saved Prompt Delivery](system-design/saved-prompt-delivery.md) - [Passthrough Initial Prompt Turn Boundary](system-design/passthrough-initial-prompt-turn-boundary.md) - [Prompt attachments](system-design/prompt-attachments.md) - [Task Actions Menu on Preview and Detail Surfaces](system-design/task-actions-menu.md) - [Task menu grouping](system-design/task-menu-grouping.md) - [Subtask re-parenting by drag and drop](system-design/subtask-reparenting-drag-drop.md) - [Task Archive Confirmation](system-design/archive-confirmation.md) - [Task removal navigation](system-design/removal-navigation.md) - [Task plan content size limit](system-design/plan-content-size-limit.md) - [Task Plan Comments](system-design/plan-comments.md) - [Task plan write consistency](system-design/plan-write-consistency.md) - [Task plan write lifecycle](system-design/plan-write-lifecycle.md) - [Task plan append-mode write](system-design/plan-write-append-mode.md) - [Task plan append-mode agent text](system-design/plan-write-append-mode-agent-text.md) - [Task Runtime Cleanup](system-design/runtime-cleanup.md) - [Managed Branch Compaction](system-design/managed-branch-compaction.md) - [Task Cleanup Preparation](system-design/runtime-cleanup-preparation.md) - [Task Terminal Persistence](system-design/task-terminal-persistence.md) - [Runtime Task-State Publication Order](system-design/runtime-state-publication-order.md) - [Queued Run Scheduling](system-design/run-scheduling.md) - [Resume prompt queue](system-design/resume-prompt-queue.md) - [Session Delete Preserves Task Workspaces](system-design/session-delete-resource-cleanup.md) - [Task Dependencies and Auto-Start Chains](system-design/task-dependencies.md) - [Dependency Gate Skip Visibility](system-design/dependency-gate-skip-visibility.md) - [Edit task dependencies](system-design/task-dependency-detail-editing.md) - [Session Launch Repository Resolution](system-design/launch-repository-resolution.md) - [Session stall visibility and orphan healing](system-design/session-stall-visibility.md) - [Task Launch Failure Recovery](system-design/task-launch-failure-recovery.md) - [Worktree metadata recovery](system-design/worktree-metadata-recovery.md) - [Task Create Launch Preview](system-design/task-create-launch-preview.md) - [Task priority visibility](system-design/task-priority-visibility.md) - [Board priority sort and filter](system-design/board-priority-sort-filter.md) - [Threads task actions](system-design/threads-task-actions.md) - [WIP Limits and Visible Overflow Queues](system-design/wip-limit-pull-system.md) - [Workflow completion-signal payload delivery](system-design/workflow-completion-signal-payload-delivery.md) - [Signal-Gated Manual Move Visibility](system-design/workflow-signal-gated-manual-move-visibility.md) - [Workflow quorum decision recording](system-design/workflow-quorum-decision-recording.md) - [Workflow Step Agent Start Ownership](system-design/workflow-step-agent-start-ownership.md) - [Workflow Step Fixed-Profile Routing](system-design/workflow-step-fixed-profile-routing.md) - [Workflow Profile Session Lifecycle and Recipients](system-design/workflow-profile-session-lifecycle.md) - [Workflow task-step transition ledger](system-design/workflow-task-step-transition-ledger.md) - [Human Assignee](system-design/human-assignee.md) - [Task Create Agent Compatibility Recovery](system-design/task-create-agent-executor-compatibility.md) ## Migration record Migration remains in progress. Files that retain migration wrappers still need extraction before this system can return to a complete migration state. ## Related systems - [Agents](../agents): supplies agent identity and execution profiles. - [Office](../office): builds autonomous workflows on task primitives. - [UI](../ui): owns presentation-only task surfaces. - [Workspaces](../workspaces): owns repositories and task worktrees.