Skip to main content

Overview

The Task Board is a six-column Kanban board designed for AI agent orchestration. Track tasks from intake to completion with drag-and-drop status updates, priority management, agent assignments, and built-in quality review gates.
Tasks automatically advance through the workflow. Quality review approval is required before moving to Done.

Board Structure

The board has six status columns:
New tasks land here. Unassigned and awaiting triage.

Creating Tasks

1

Click New Task

Click the + New Task button in the board header.
2

Fill Form

Provide:
  • Title (required) — Brief task description
  • Description (optional) — Markdown-formatted details
  • Priority — Low, Medium, High, or Critical
  • Assign to — Select an agent from the dropdown
  • Tags — Comma-separated labels (e.g., frontend, urgent, bug)
3

Create

Click Create Task. The task appears in the Inbox column.

Via API

Create tasks programmatically:
curl -X POST http://localhost:3000/api/tasks \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "title": "Research competitor pricing models",
    "description": "Analyze top 5 competitors and summarize findings.",
    "priority": "high",
    "assigned_to": "researcher-01",
    "tags": ["research", "competitive-analysis"]
  }'

Priority Levels

Tasks display color-coded priority badges and left borders:

Low

🟢 Green border — Routine work

Medium

🟡 Yellow border — Standard priority

High

🟠 Orange border — Elevated urgency

Critical

🔴 Red border — Immediate attention required

Drag-and-Drop Status Updates

1

Select Task

Click and hold a task card.
2

Drag to Column

Drag the card to a different status column. The column highlights when hovering.
3

Drop

Release to update status. The board updates optimistically (instant UI feedback).
4

Validation

If the move violates quality gates (e.g., no Aegis approval), it’s reverted with an error message.
Tasks cannot move to Done without an approved quality review from Aegis. Attempting to do so shows: “Aegis approval is required before moving to done.”

Task Cards

Each task card displays:
  • Title — Task name
  • Priority badge — Low/Medium/High/Critical indicator
  • Aegis badge — Green “Aegis Approved” label if quality review passed
  • Description preview — Markdown-rendered snippet (3 lines max)
  • Agent assignment — Avatar and name of assigned agent
  • Relative timestamp — “5m ago”, “2h ago”, “3d ago”
  • Tags — Up to 3 tags with smart color coding (bug=orange, feature=green, etc.)
  • Due date (if set) — Turns red if overdue

Tag Colors

Tags automatically inherit semantic colors:
  • 🔴 Red — urgent, critical
  • 🟠 Orange — bug, fix
  • 🟢 Green — feature, enhancement
  • 🟣 Purple — research, analysis
  • 🔵 Blue — deploy, release
  • Gray — default for unrecognized tags

Task Detail Modal

Click any task card to open the detail view:

Tabs

View task metadata:
  • Status, priority, assigned agent
  • Created and updated timestamps
  • Full markdown description

Editing Tasks

1

Click Edit

In the task detail modal, click the Edit button in the header.
2

Update Fields

Modify title, description, status, priority, assignment, or tags.
3

Save

Click Save Changes. Updates apply immediately and sync to all connected clients.

Comments & Discussion

The Comments tab enables team collaboration:

Adding Comments

1

Set Author

Enter your name in the Author field (defaults to “system”).
2

Write Comment

Type your message in the textarea. Plain text and markdown supported.
3

Submit

Click Add Comment. The comment appears instantly.

Broadcasting to Subscribers

Send a message to all agents watching the task:
  1. Scroll to Broadcast to Subscribers section
  2. Type your message
  3. Click Broadcast
  4. Message is delivered via webhook to all subscribed agents
Broadcast status shows how many recipients received the message (e.g., “Sent to 3 subscribers”).

Quality Review System

Mission Control enforces quality gates to prevent premature task completion.

Submitting Reviews

1

Open Quality Tab

In the task modal, click the Quality Review tab.
2

Fill Review Form

  • Reviewer — Your identifier (default: “aegis”)
  • Status — Approved or Rejected
  • Notes (required) — Explanation of decision
3

Submit

Click Submit. The review is logged with timestamp.

Aegis Review Requirement

To move a task to Done:
  1. At least one review must exist where:
    • reviewer = "aegis"
    • status = "approved"
  2. If the condition isn’t met, drag-and-drop to Done is blocked
  3. An “Aegis Approved” badge appears on approved task cards

Review History

The Quality Review tab shows all reviews with:
  • Reviewer name
  • Approval status (approved/rejected)
  • Review notes
  • Timestamp
  1. Agent completes task and moves to Review
  2. Human reviewer opens task modal → Quality Review tab
  3. Reviewer sets status to approved with notes: “Verified all acceptance criteria met”
  4. Reviewer sets name to aegis and submits
  5. Task card gains “Aegis Approved” badge
  6. Task can now be dragged to Done
Filter tasks via API query parameters:
# Filter by status
curl http://localhost:3000/api/tasks?status=in_progress \
  -H "x-api-key: your-api-key"

# Filter by assignee
curl http://localhost:3000/api/tasks?assigned_to=researcher-01 \
  -H "x-api-key: your-api-key"

# Filter by priority
curl http://localhost:3000/api/tasks?priority=high \
  -H "x-api-key: your-api-key"

# Combine filters
curl http://localhost:3000/api/tasks?status=in_progress&priority=critical \
  -H "x-api-key: your-api-key"
UI-based filtering is planned for a future release. Currently filter via API or Global Search.

Real-Time Updates

The Task Board integrates with Mission Control’s real-time system:

Server-Sent Events (SSE)

When SSE is connected:
  • Task updates broadcast to all connected clients
  • Board refreshes automatically without polling
  • Status changes appear instantly across sessions

Smart Polling Fallback

When SSE is disconnected:
  • Board polls every 30 seconds for updates
  • Polling pauses when browser tab is hidden
  • Polling resumes immediately when tab becomes visible
The board uses the useSmartPoll hook with pauseWhenSseConnected: true. This means:
  1. SSE Active → No polling, live updates only
  2. SSE Inactive → Poll every 30s
  3. Tab Hidden → Pause polling completely
  4. Tab Visible → Resume polling immediately + fire one instant refresh

GitHub Issues Sync

Mission Control can sync issues from GitHub repositories:
curl -X POST http://localhost:3000/api/github \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "action": "sync",
    "repo": "owner/repo"
  }'
Synced issues appear on the Task Board with:
  • Label mapping (e.g., bugbug tag)
  • Assignee mapping (GitHub username → agent name)
  • Automatic status inference from issue state
GitHub sync requires a personal access token configured in Settings → Integrations.

Keyboard Shortcuts

ShortcutAction
NNew Task modal
RRefresh board
EscClose modal
1-6Jump to column (Inbox=1, Done=6)
Keyboard shortcuts coming in v1.1. Currently accessed via buttons only.

Common Workflows

Daily Standup Triage

1

Review Inbox

Check unassigned tasks in the Inbox column.
2

Assign Tasks

Click each task → Edit → Select agent → Save.
3

Set Priorities

Update priority levels based on urgency.
4

Add Context

Leave comments with additional instructions or blockers.

Agent Task Pickup

1

Agent Queries Tasks

curl http://localhost:3000/api/tasks?assigned_to=researcher-01&status=assigned
2

Agent Updates Status

curl -X PUT http://localhost:3000/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"tasks": [{"id": 42, "status": "in_progress"}]}'
3

Agent Reports Completion

curl -X PUT http://localhost:3000/api/tasks \
  -d '{"tasks": [{"id": 42, "status": "review"}]}'

Quality Gate Enforcement

1

Task Reaches Review

Agent drags task to Review column.
2

Human Reviews Work

Operator opens task modal → Quality Review tab.
3

Submit Review

Reviewer provides feedback and approves as Aegis.
4

Move to Done

Task can now be dragged to Done column.

API Reference

Create Task

POST /api/tasks
Body:
{
  "title": "string",
  "description": "string",
  "priority": "low" | "medium" | "high" | "critical",
  "assigned_to": "string",
  "tags": ["string"]
}

Update Task Status

PUT /api/tasks
Body:
{
  "tasks": [
    {"id": 42, "status": "in_progress"}
  ]
}

Add Comment

POST /api/tasks/{id}/comments
Body:
{
  "author": "string",
  "content": "string"
}

Submit Quality Review

POST /api/quality-review
Body:
{
  "taskId": 42,
  "reviewer": "aegis",
  "status": "approved" | "rejected",
  "notes": "string"
}

Next Steps

Agent Management

Assign tasks to specific agents based on capabilities

Real-Time Monitoring

Watch task progress in the activity feed