name: command-center description: "Operate the Command Center task tracker at stacean.vercel.app. Use when creating, updating, or managing tasks via Beads CLI, syncing to Vercel KV, or working with the dashboard UI. Covers the 6-status workflow (todo → in_progress → needs-you → review → ready → shipped), beads commands, KV sync, and all tracker APIs."

Command Center Skill

The Command Center is a task tracker deployed at stacean.vercel.app. Tasks are managed locally via Beads CLI and synced to Vercel KV for the production frontend.

6-Status Workflow

TODO → IN_PROGRESS → NEEDS_YOU → REVIEW → READY → SHIPPED

Status	Who Sets	Description
`todo`	System	Created, not started
`in_progress`	Agent	Agent actively working
`needs-you`	Agent	Blocked on human decision
`review`	Agent	Code done, requesting review
`ready`	Human	Approved, ready to merge
`shipped`	Human	Merged/deployed

Agent Workflow (Quick Start)

# 1. Create task
bd create "Task title" -p 1

# 2. Start working
bd update <id> --status in_progress

# 3. If blocked on human
bd update <id> --status needs_jordan

# 4. Submit for review
bd update <id> --status in_review

# 5. Sync to Vercel (makes visible on deployment)
npm run bd:sync

# 6. After human approves, they close it
bd update <id> --status ready_to_commit
bd close <id>

Beads ↔ KV Mapping

Frontend	Beads CLI
`in_progress`	`--status in_progress`
`needs-you`	`--status needs_jordan`
`review`	`--status in_review`
`ready`	`--status ready_to_commit`
`shipped`	`bd close`

For complete mapping details, see status-mapping.md

APIs

Endpoint	Method	Purpose
`/api/tracker/tasks`	GET	List all tasks
`/api/tracker/tasks`	POST	Create task
`/api/tracker/tasks/[id]`	PUT	Update task
`/api/tracker/tasks/[id]`	DELETE	Soft delete
`/api/tracker/agents`	GET	List agents

For request/response formats, see api.md

Key Files

File	Purpose
`types/task.ts`	TaskStatus, TaskPriority types
`components/common/StatusBadge.tsx`	Status badge component
`lib/integrations/kv/tracker.ts`	KV adapter (creates/updates tasks)
`scripts/sync-beads-to-kv.ts`	Beads → KV sync script
`app/page.tsx`	Main dashboard with 4 views

Dashboard Views

The main page (/) has 4 views:

Objectives - Task list grouped by status
Agents - Agent status cards
Energy - Tasks grouped by priority bands
Live - Recent activity feed

Priorities

Priority	Value	Color
`urgent`	P0	Red
`high`	P1	Orange
`medium`	P2	Blue
`low`	P3	Zinc

Syncing to Production

Tasks appear on Vercel only after syncing:

npm run bd:sync

This runs scripts/sync-beads-to-kv.ts which:

Reads all open beads issues (bd list --json)
Maps statuses to frontend values
Writes to Vercel KV (Upstash Redis)
Cleans up closed tasks from KV

No git commit needed - sync writes directly to cloud KV.

Dynamic Projects

Projects are discovered automatically from tasks in KV. To register a project with a custom label or emoji so it looks polished on the dashboard, use the management script:

# Register a new project
bun run scripts/manage-projects.ts --id=my-app --label="My App" --emoji="🚀"

# List all registered projects
bun run scripts/manage-projects.ts --list

# Delete a registered project
bun run scripts/manage-projects.ts --delete=my-app

References

status-mapping.md - Complete status mapping table
api.md - API endpoint documentation
workflow.md - Detailed task lifecycle

Name	command-center
Description	Operate the Command Center task tracker at stacean.vercel.app. Use when creating, updating, or managing tasks via Beads CLI, syncing to Vercel KV, or working with the dashboard UI. Covers the 6-status workflow (todo → in_progress → needs-you → review → ready → shipped), beads commands, KV sync, and all tracker APIs.

command-center

SKILL.md