Phoenix Flow

指挥棒

人类和代理共享任务图——React Kanban UI、MCP服务器和phoenixvc组织的双向YAML同步。

指挥棒 是凤凰生态系统的工作可见性层。它为人类和人工智能代理提供了一个共享的工作视图：投资组合→ 项目→ 任务层次结构以看板的形式出现，其中有一个MCP服务器，可以让代理直接从他们的工具调用中读写任务。工作状态与中的YAML文件双向同步 org-meta，使项目图版本可控，代理可访问。这个名字来源于接力赛接力棒——工作在人类和代理人之间干净利落地交接，然后再回来。

______________________________________________________________________

它做什么

• 看板 --React+Vite+Tailwind前端，具有3层层次结构：投资组合→ 项目→ Task.拖放、检查表支持和状态跟踪。
• MCP服务器 --Express后端公开了一个MCP（模型上下文协议）服务器，以便AI代理 deck, cognitive-mesh，以及 retort 项目可以在不离开工具循环的情况下查询和更新任务。
• YAML同步 --Postgres任务数据库和提交的YAML文件之间的双向同步 org-meta任务图始终受版本控制。
• 组织上下文传递 --后端代理来自以下位置的组织级数据（路线图、项目、任务） mcp-org 因此代理通过单个MCP端点获得完整的组织上下文。
• 铁路部署 --在Railway上部署为web服务。Monorepo与单独 backend/ 和 frontend/ 包装。

______________________________________________________________________

建筑

frontend (React/Vite/Tailwind)
         │
         ▼
backend (Express + MCP server)
         │
    ┌────┴─────────────────┐
    │                      │
 Postgres              mcp-org
 (task store)          (org context — roadmap, projects)
    │
    └──▶  org-meta (YAML sync)

部署在铁路上。代理可以通过HTTP传输访问MCP服务器。

______________________________________________________________________

仓库布局

baton/
├── backend/                # Express API + MCP server
│   ├── src/
│   │   ├── db/schema.ts    # Drizzle ORM schema
│   │   ├── mcp/server.ts   # MCP tool definitions
│   │   ├── mcp/orgClient.ts# mcp-org JSON-RPC client
│   │   └── routes/         # REST API routes (tasks, org)
│   └── package.json
├── frontend/               # React Kanban UI
│   ├── src/
│   │   ├── components/     # Board, Card, Column components
│   │   └── hooks/          # Data fetching hooks
│   └── package.json
├── railway.toml            # Railway deployment config
└── README.md

______________________________________________________________________

先决条件

• 启用corepack的Node.js 22+（pnpm从以下位置激活 package.jsons packageManager 现场）
• PostgreSQL（通过铁路或本地）
• MCP_ORG_URL + MCP_ORG_SECRET 用于组织上下文传递

______________________________________________________________________

快速启动

backend/ 和 frontend/ 是独立的pnpm项目（每个项目都有自己的锁文件），因此每个铁路服务都是独立构建的。

corepack enable          # one-time, activates pnpm@10.x from packageManager field

# Backend
cd backend && pnpm install && pnpm dev

# Frontend
cd frontend && pnpm install && pnpm dev

复制 .env.example 到 .env 并填写：

• DATABASE_URL --PostgreSQL连接字符串
• MCP_ORG_URL --mcp-org端点（默认：铁路部署）
• MCP_ORG_SECRET --mcp-org身份验证的共享密钥

______________________________________________________________________

MCP工具

MCP服务器为代理提供工具：

______________________________________________________________________

生态系统

接力棒是凤凰平台的工作可见性层。它连接到：

______________________________________________________________________

灵感

• linear.app --项目跟踪用户体验和三层层次模型（团队→ 项目→ 问题）
• 计划如此 --开源项目管理，双向同步模式