View and manage Plans

A Plan is a durable project grouping for related tasks. Open Plans from a project to create a Plan, manage one task membership at a time, and review normally listed or archived Plans without changing how their tasks are ordered or worked.

Choose Create Plan from the Plans area. Enter a title, add optional Markdown, and choose any available organization or project labels. A title is required, but it does not need to be unique. You can create the Plan without tasks and assign them later.

Plan labels are independent from task labels. Selecting a new label from the same scoped group replaces the previous scoped choice. If a selected label is no longer available, refresh the labels and choose again before saving.

Choose Plans or Archived to move between the normal Plans list and Archived Plans. On Plans, open the Progress button and select any combination of Unstarted, Started, and Completed. The list matches any selected category. Clear every selection to show all Plans again. Empty Plans count as Unstarted for filtering, but still show no completion percentage. The archived list does not offer this filter because archiving is independent from completion.

Select a sortable Plan, Title, Tasks, Progress, or Updated column header to order the current result set. Your selected progress categories and sort selection stay in the page address, so refreshing or sharing that address restores the same view. When you return to Plans without a progress filter in the address, it remembers the last category combination you chose for that project. Valid progress categories in the address take precedence, so shared links still open the specified view. Choose Show all Plans when a progress filter has no matching Plans.

Completion is the number of Done tasks divided by the number of actionable tasks: total tasks minus Closed tasks. It counts Done tasks of either type and is based on task count, not Mass. Empty and all-Closed Plans show no percentage because neither has an actionable denominator. Closed tasks remain in the total and are counted separately; they are not Done or a successful Plan outcome.

Open a Plan by its number or title. Archived Plans remain available from the archived list and through their direct detail page.

You can also find Plan work from the project task list. Search for and combine individual active Plans, Incomplete plans, Complete plans, and Unplanned tasks, or choose All Plans to include every task, including tasks whose Plans are archived. Plan choices use match-any behavior with each other and intersect with label and other task filters.

The detail page puts the total task count beside its state summary and shows count-based completion in a progress meter with the percentage and Done count over actionable tasks. Its six summary counts are Backlog, Queued, Working, Reviewing, Done, and Closed. Working combines Agent working and In progress; task rows keep their individual states. The page also shows the Plan's Markdown, labels, and total size. Archived Plans also show their archive state. The Plan tasks table uses a subtle task-type icon: hover over or focus it to read Coding Agent Task or Person Task. Closed members stay visible with their state, so you can open any Plan task and review its durable record.

The table shows up to 20 tasks per page. Use the page controls to browse all members. Pagination remains available on archived Plans.

When Sprints or Milestones are enabled, the table also shows each task's current membership in those features. Compact numbered links appear in Planning at every screen width. Resize columns using their header handles, or scroll the table horizontally to reach all enabled columns. For keyboard resizing, focus a handle, press Enter, use the arrow keys, then press Enter or Tab to finish. Widths are remembered in this browser; Reset column widths restores the defaults. Select a link to inspect its Sprint or Milestone, or select the rest of the row to open the task. The Plan you are already viewing is not repeated in each row. Disabled features are hidden independently, and no Planning column is needed when both are disabled. These links do not change membership or the task's workflow.

When a member has unfinished direct dependencies, the table shows a red blocker icon and count beside its title. Select the count to see each unfinished dependency's task number, title, and state. Open a dependency from the popover to inspect it; use Back to return to the originating Plan. Only Done dependencies are complete, so a Closed dependency stays in the blocker list. The blocker disappears after the task data refreshes when all direct dependencies are Done or the incomplete dependency relationships are removed or replaced. Archived Plans keep this read-only blocker information visible.

For a Backlog Coding agent member, choose Queue in the Plan tasks table, select a coding agent, and confirm. If dependencies are unfinished, review and acknowledge them before queueing. A Backlog Person member shows Start work. These task actions remain available when the Plan is archived; archive state only restricts membership editing. After queueing succeeds, the task state and Plan counts refresh.

Plan membership only groups tasks. It does not change task state, assignee, Mass, labels, dependencies, comments, work runs, or list order. Plan labels and task labels also remain independent.

Open a Plan and choose Edit Plan to change its title, optional Markdown, or complete label selection. Saving these fields does not add, remove, or update member tasks.

On an active Plan, use Add or move a task to search project tasks by number or title. Each result shows the task-type icon with hover text and includes task type in its screen-reader name. It also shows task state and whether the task is Unplanned or belongs to another numbered Plan. Choosing one result immediately adds or moves only that task to the open Plan; no confirmation is required.

Choose Remove on a current member to make only that task Unplanned. Removing membership preserves the task and all task-owned content and workflow state. Repeat the action separately for each task you want to change; Plans do not provide bulk membership editing.

You can also create or edit a task to choose one active Plan or Unplanned. Task detail links its numbered Plan beside the other task metadata. If the Plan is later archived, existing task membership and the detail link remain visible; the archived Plan is not offered for new membership, but you can clear or move the existing membership.

Open the Plan's more-actions menu and choose Archive Plan when it should leave the normal Plans list. Open it from Archived Plans and choose Restore Plan when it should return.

Archiving changes visibility only. The Plan's Markdown, labels, tasks, and task memberships stay intact, and its detail page remains available. Restoring the Plan returns it to the Plans list with the same membership.

An archived Plan keeps its member tasks visible but does not show controls for adding, moving, or removing them. Restore the Plan before changing membership.

Next, learn how to organize individual tasks or manage the labels available to Plans and tasks.