# Maestro

> 仓库地址：https://github.com/ReinaMacCredy/maestro
> 作者/组织：ReinaMacCredy
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
Local-first 的多 agent 软件工程协调 CLI，通过磁盘状态管理和 handoff protocol 实现无服务器的 agent 协作。

## 项目定位与架构
Maestro 解决的核心问题是：多个 agent session 如何在没有服务器、数据库或后台服务的情况下协作？答案是将所有协调状态存储在 `.maestro/` 目录中——plain files，可 inspect、可 diff、可 git track。

工作组织为 Mission → Milestones → Features → Validation Assertions 四层结构。**UKI v5.4 handoff protocol** 通过紧凑的 transfer string 在 agent session 之间传递上下文（planning 或 execution mode）。Memory system 捕获 corrections 和 learnings 作为未来工作的可复用 guidance。

## 关键技术特性
- **Disk-based State**：`.maestro/` 目录存储所有协调数据，可 inspect/diff
- **UKI v5.4 Handoff Protocol**：紧凑 transfer string 在 agent session 间传递上下文
- **Mission Structure**：Mission → Milestones → Features → Assertions 四层
- **Memory System**：捕获 corrections/learnings 复用于未来工作
- **Mission Control**：read-only terminal dashboard + JSON snapshot
- **Local-first Runtime**：仅依赖 filesystem、git、config、terminal

## 设计亮点与创新
"没有 orchestration server"的设计极为优雅——人类操作者在多个 terminal 间切换，每个 agent 通过同一个 CLI 读写 mission 状态。这种设计消除了服务器依赖，同时保持了协调能力。

## 局限性与风险
- 依赖人类在 terminal 间手动切换，不支持自动化 agent 调度
- 手动 handoff 限制了并行 agent 的数量
- UKI v5.4 protocol 是自定义标准，互操作性有限

## 与生态系统的关联
与 ExecPlan（单项目分阶段执行）互补，Maestro 侧重多 agent 协调。Local-first 理念与 PLUR 的本地优先 memory 系统共鸣。