MC

Mission Control / Product Review

产品级调研、设计目标与主界面 mockup

结论:Mission Control 应先做 agent ops console,再叠加 triage board。第一屏回答“现在该驱动什么”,而不是只展示项目列表。

Product thesis

控制室,不是普通任务管理器

draft for discussion

MC 的核心用户任务是让多项目 agent 系统持续前进:发现停滞、判断最大 KR gap、明确 next_owner、跟踪 release 和验证证据,并在必要时写入 COLLAB 路由。

primary frame
ops console
secondary frame
triage
success signal
UX progress

Decision needed

先讨论产品方向,再做视觉 polish

确认 MC 首页方向:agent ops console first, triage board second。
确认 token 方案:Tailwind v4 + semantic CSS variables + Radix primitives + Primer naming。
确认下一段产品建设:dashboard 内 Request/route 写入,而不是继续只做展示。

Research

参考项目与取舍

调研目标不是复制某个产品,而是拆出适合 MC 的产品力:项目运营、队列路由、问题证据链、可变 dashboard。

Vercel Projects

source
Borrow

以 project 为运营对象,把 repo、部署、状态、观测聚到一个入口。

Avoid

不要把 MC 做成部署控制台。release 只是一个信号,不是全部产品。

Linear Triage

source
Borrow

把进入队列的工作快速 accept、route、snooze 或 close,始终有 owner。

Avoid

不要让 issue board 成为首页主框架,否则 MC 自身健康和 registry 会被藏起来。

Sentry Issue Details

source
Borrow

一个问题页同时给 impact、last seen、owner、linked work 和 lifecycle。

Avoid

不要只围绕 error telemetry。MC 还管理 release、文档、验证和人类请求。

Grafana Dashboards

source
Borrow

panel 和变量让一个 dashboard 适配多个对象,数据源驱动视图。

Avoid

不要做被动图表墙。每个 panel 都要暗示下一步动作。

Design Goals

产品目标

这些目标直接来自当前 COLLAB gap:12h Initiative Mode、项目停滞检测、MC 自身透明度、Vibeful release 验证、Beefit pilot 观察。

减少被动等待

首页第一屏必须回答现在该驱动什么,而不是等待某个 agent 自己想起来。

暴露系统瓶颈

项目停滞、board drift、dirty worktree、release latest mismatch 和 open request 都要变成可见运营信号。

让路由可执行

Request、next_owner、needs_from 和 verify path 必须可从 dashboard 写入或至少一跳抵达。

保留证据链

所有绿灯都要能追到 COLLAB、commit、release、installed smoke 或 E2E 证据,避免只看 process metric。

Design Tokens

推荐 token 方案

选择标准:适配当前 Next/Tailwind 代码、能让状态色有产品语义、后续可落到 shadcn/Radix 组件,不制造一次性视觉债。
Utility engine

Tailwind CSS v4 theme variables

docs

当前项目已经是 Tailwind v4。用 theme variables 可以把 token 暴露成 utility,而不是散落硬编码色值。

Semantic tokens

shadcn-style CSS variables

docs

用 background、foreground、card、border、ring 这类语义变量稳定组件 API,后续改视觉不用重写 class。

Color primitives

Radix neutral plus status scales

docs

MC 需要 neutral、amber、red、emerald、cyan 这样的运营状态色,Radix scale 比自造 palette 更稳。

Naming discipline

Primer-style primitive / pattern / functional split

docs

防止 token 膨胀。primitive 是原始色阶,pattern 是 surface,functional 是 blocker、verified、drive 等产品语义。

--mc-bg
#050505
page background
--mc-surface
#0f0f10
default panel
--mc-surface-raised
#18181b
rows and queues
--mc-border
#27272a
separators
--mc-ok
#10b981
verified
--mc-drive
#f59e0b
active work
--mc-critical
#f43f5e
broken journey
--mc-link
#22d3ee
actions

Main Feature Mockup

第一屏应该长什么样

这个 mockup 不是最终视觉稿,而是产品结构稿:顶部驱动决策,其次是 MC 自身、Registry、Routing,再往下才是项目卡和详细 findings。
Patrol Decision
Drive Vibeful release handoff
drive

v0.2.30 source fixes are ready, but installed verification is blocked until public latest advances. Next owner: cursor for release handoff, codex for installed E2E after release.

commits 24h
28
human asks
1
open blockers
2
dashboard
live
Mission Control Self
main @ current head
build
pass
dirty
0
Current MC work: product review and request write flow.
Project Registry
3 registered · 1 discovered
mission-controloperational
self-health, registry, product design visible
vibefuldrive
v0.2.30 release/latest handoff and installed Browser Task verification
beefitwatch
supervised pilot green, watch for new findings
Routing Console
Open Requests
R-029 → cursor
Publish v0.2.30 latest.json, then hand back to Codex.
R-001 → jiansen
Review MC product direction and token strategy.

Near-term Scope

主要功能优先级

这组功能是从“能让明早 vibeful/beefit 有 UX 进步 + MC dashboard 可用”的验收标准倒推出来的。

Patrol Decision

把最大 KR gap 和下一步动作放在顶部,作为整页的 action header。

已在 dashboard 有 live signal,mockup 强化为首页主锚点。

Dependency Map

把 `blocked_by` 从隐形字段变成可维护关系图,按下游影响面决定先修哪个 blocker。

已上线 blocker ranking、edge visualization、verified/missing upstream maintenance warning。

Mission Control Self

MC 也作为一个项目被监控,显示 build、branch、dirty、queue、registry 健康。

已上线基础面板,下一步补 request write flow。

Project Registry

注册项目来自 `docs/projects.json`,候选项目来自 `~/Coding/*/docs/COLLAB.md` 扫描。

已上线 discover/register,mockup 说明它在信息架构中的位置。

Routing Console

把 open request、stalled owner、blocked verify 路由成可执行工作,而不是文件里的隐形文本。

下一阶段最高 ROI:dashboard 内写入 Request/route。

Source of truth: /Users/jiansenhe/Coding/mission-control/docs/product-design.md. Review surface: http://localhost:3000/product-design.