Tasks

The workspace is a two-panel layout. The left panel (Navigator) shows your task list and graph. The right panel (Detail) shows the selected task's full information, or a project-level chat when no task is selected.

Navigator Panel

The left panel displays tasks in two modes:

Structure Mode

A categorized task list grouped by the project's categories (e.g., "backend", "frontend", "mcp"). Each task shows its title, status badge, and tags. Tasks are ordered by their order field within each category.

Graph Mode

An interactive force-directed graph visualization. See Graph View for details.

Detail Panel

Clicking a task in either mode opens the detail panel on the right. The detail panel shows:

• Title (editable inline).
• Status with lifecycle indicator: draft, planned, in_progress, done.
• Description (editable).
• Category selector (from project categories).
• Tags (editable).
• Acceptance criteria -- checkable items that define "done".
• Decisions -- technical choices with rationale.
• Implementation plan -- detailed plan written during the planning phase.
• Execution record -- summary of what was built.
• Files -- paths touched during implementation.
• Relationships -- connected tasks with edge types and notes.
• Context tabs -- agent and planning context views.

All fields are editable directly in the panel. Changes save automatically.

Project Chat

When no task is selected, the right panel shows a project-level chat. This is an AI conversation scoped to the project, useful for asking questions about the project structure, requesting analysis, or triggering actions like task creation.

Task States

Beyond the four statuses (draft, planned, in_progress, done), Piyaz derives an actionable state that accounts for dependencies:

The navigator panel shows these derived states so you can immediately see what's actionable.