Task Board

Kanban-style task management with drag-and-drop, quality gates, priority levels, and agent assignments

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:

Inbox

New tasks land here. Unassigned and awaiting triage.

Assigned

Tasks assigned to an agent but not yet started.

In Progress

Active work. Agent is currently executing the task.

Review

Task complete and awaiting human review.

Quality Review

Tasks with Aegis approval badge, ready to close.

Done

Completed and approved tasks. Requires Aegis sign-off.

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

Details

View task metadata:

• Status, priority, assigned agent
• Created and updated timestamps
• Full markdown description

Comments

Add threaded comments with author attribution. Comments support markdown and auto-refresh every 15 seconds.

Quality Review

Submit quality reviews as Aegis or other reviewers. View review history with timestamps.

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

Example Review Flow

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

Filtering & Search

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

Technical Details

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., bug → bug 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

Shortcut	Action
N	New Task modal
R	Refresh board
Esc	Close modal
1-6	Jump 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