feat: bootstrap boss control plane prototype

README.md

@@ -0,0 +1,63 @@
+# Boss
+
+Boss 是一个面向多设备开发协作的 agent control plane。
+
+它的目标是让用户通过对话入口或独立控制台，持续管理多台 Windows、Mac 上的编码代理，支持任务拆分、实时进度、需求变更、审批和审计。
+
+## 当前状态
+
+当前仓库已经完成第一轮产品设计文档：
+
+- [文档总览](./docs/README.md)
+- [竞品对比](./docs/competitor-comparison.md)
+- [系统架构](./docs/system-architecture.md)
+- [MVP 功能清单](./docs/mvp-feature-plan.md)
+- [技术选型](./docs/technical-selection.md)
+- [消息协议与状态机](./docs/message-protocol-and-state-machine.md)
+- [实施路线图](./docs/implementation-roadmap.md)
+
+并且已经补入首版可运行原型：
+
+- Fastify API
+- 文件持久化状态存储
+- SSE 实时事件流
+- Web 控制台
+- `boss-worker` 模拟执行器
+
+## 当前推荐方向
+
+- 主控面：Web 为主，聊天入口为辅
+- Manager：Codex
+- 设备侧 worker：Codex CLI + Claude Code
+- 工具层：MCP
+- 调度：持久队列或工作流引擎
+
+## 下一步
+
+建议直接开始：
+
+1. 建立 Web 控制台和后端骨架
+2. 实现 `boss-worker` 注册与心跳
+3. 打通会话、任务树和子任务分发
+4. 接入审批和中途重规划
+
+## 本地运行
+
+```bash
+npm install
+npm run dev
+```
+
+浏览器打开：
+
+```bash
+http://127.0.0.1:43210
+```
+
+另开终端启动 worker：
+
+```bash
+npm run worker -- --name win-a --os windows --capability terminal --capability browser
+npm run worker -- --name win-b --os windows --capability terminal --capability test
+npm run worker -- --name mac-a --os macos --capability terminal --capability test --capability browser
+```