task-queue-design

What problem does it solve?

This design guide codifies how to structure and manage task queues for Julia's TODO system and the Task Manager agent, reducing backlog chaos and improving visibility into work item lifecycles.

Core Features & Use Cases

• Task format YAML (TASK-NNN.yml): Defines a consistent task schema including id, title, status, priority, created, updated, assigned_to, tags, description, blockers, and notes.
• Task Index & Visibility: Maintains an index (todo/index.yml) with totals and per-task summaries for quick status checks and reporting.
• Priority Matrix & SLA: Establishes priority levels with SLA guidance to drive triage, escalation, and completion expectations.
• Task Lifecycle Patterns: Provides patterns for task creation, assignment, progression, stale detection, and completion with clear guardrails.
• Use Case Coverage: Supports weekly health summaries, backlog grooming, and cross-component coordination (bridge, backend, UI).

Quick Start

Create a new TASK-004.yml with a high-priority item and update the todo/index.yml accordingly.