#Factory 演进路线图

这是 retaintive 自己的工厂演进计划。三个阶段，按需推进——每个阶段都能独立交付价值，不需要等下一阶段才能跑通。

最后更新：2026-03

#三阶段总览

Phase 现在（已有）          Phase 中期（1-2 个月）      Phase 成熟期（触发条件满足后）
────────────────────        ──────────────────────        ──────────────────────────────
Claude Code native          + Beads 单独引入              + Gas Town 全套
git worktree 手动管理        共享任务数据库                 Mayor 自动调度
Meegle MCP 已有              依赖图 + 防碰撞               Meegle → Beads bridge
你是调度员                   你还是调度员                   AI 是调度员

核心原则：不要为了"工厂"而工厂。每一步都以"这个阶段是否明显减少你的手动操作"为标准。

#Phase 现在：Claude Code native（已有，能用）

#你已经有的

基础设施：
  CLAUDE.md（每个 repo）              ← agent 读取规则的入口
  .claude/rules/execution-policy.md  ← 预写决策，agent 遇到分叉不需要问你
  ~/.claude/skills/（23 个 skills）   ← 专业化操作能力
  Meegle MCP（7 个 tools）            ← 任务管理集成

工作流：
  Phase 0-2：你 + AI 交互式设计，产出 Task Spec
  Phase 3：手动启动 Claude Code → git worktree × N → 并行 PR

注意：这里的「Phase 0-2 / Phase 3」指任务工作流阶段（见 操作手册）。本文「Phase 现在 / 中期 / 成熟期」指 factory 工具演进阶段——是两套不同的命名体系，不要混淆。

#当前瓶颈

#现在就能做的增量优化（0 额外工具）

• 补全 .claude/working-memory/_template.md（防 context 丢失）
• 补全 .claude/templates/plans/（impl.md 模板）
• 确保每次 Phase 3 前 Task Spec 里有明确的"受影响文件边界"（防碰撞）

#Phase 中期：引入 Beads（单独用，不装 Gas Town）

#触发条件（满足任意一个就可以考虑）

• 一周内出现过 2 次"两个 agent 改了同一文件"
• 开始并行 > 3 个任务，手动分配开始出错
• 需要表达任务依赖："GAP 7 必须等 GAP 3 完成才能开始"

#安装（5 分钟）

brew install beads
# 或
npm install -g @beads/bd

# 在 repo 根目录初始化
cd callytics-infrastructure
bd init
# 如果不想把 .beads/ 提交进 git：
bd init --stealth

#怎么用

每次 Phase 2 拆完子任务后，用 Beads 管理执行层：

# Phase 2 产出子任务后，写进 Beads
bd create "实现 contacts 表 phone 索引" --priority high
bd create "更新 AI 分析 prompt" --priority normal
bd dep add <task-2-id> --depends-on <task-1-id>  # task-2 依赖 task-1

# Agent 启动时认领任务（防止两个 agent 做同一件事）
bd update --claim <task-id>

# 查看当前状态
bd show

# 查看哪些任务现在可以开始（依赖已满足）
bd ready

和 Meegle 的分工：

Meegle = 业务/产品层（Phase 0-2，你看的）
             "这个 sprint 做 Feature X"
Beads  = 执行层（Phase 3，agent 看的）
             "Feature X 的 task-1 Agent A 正在做，task-2 等待中"

#这个阶段不需要装

• ❌ Dolt（Beads 单独用有内置的轻量后端）
• ❌ Go（brew/npm 安装的 Beads 是预编译二进制）
• ❌ tmux（不装 Gas Town 就不需要）
• ❌ Gas Town 本体

#Phase 成熟期：Gas Town 全套（Mayor 自动调度）

⚠️ 前提条件：Phase 中期已稳定运行 4+ 周，Beads 已融入日常工作流。

#触发条件（必须全部满足）

• 每周并行任务量稳定 > 10 个
• 有一台可以 24/7 运行的机器（Mac 不睡眠，或专用服务器）
• Phase 1 的 Task Spec 产出流程已标准化（每个 spec 都有清晰验收标准）
• Meegle → Beads bridge 已写好并经过测试

如果上面有任何一条没满足，不要进入这个阶段。Mayor 的价值来自于"任务持续涌入"，没有量就没有杠杆。

#Gas Town 带来什么

#安装步骤（届时参考）

# 1. 安装依赖
brew install go dolt
brew install beads  # 如果 Phase 中期已装则跳过

# 2. 安装 Gas Town
go install github.com/steveyegge/gastown/cmd/gt@latest

# 3. 初始化 workspace
mkdir ~/gt && cd ~/gt
gt init

# 4. 添加 repo（Rig）
gt rig add callytics-infrastructure ~/workspace/callytics-infrastructure
gt rig add callytics-dashboard ~/workspace/callytics-dashboard

# 5. 启动 Mayor
gt mayor attach
# 然后告诉 Mayor："你的任务来自 Beads 队列，请查看并分配"

#Meegle → Beads Bridge 设计草图

Gas Town 不原生读 Meegle，需要一个 bridge 脚本（届时实现，现在是设计草图）：

逻辑流程：

1. 从 Meegle 拉取 Phase 2 已完成的子任务
   → 使用 Meegle MCP: get_node_detail(sprint_node_id)
   → 过滤条件：task.hasAcceptanceCriteria === true

2. 写入 Beads
   → bd create "<task_title>" --metadata "meegle_id=<id>"
   → 如有依赖：bd dep add <task_id> --depends-on <dep_id>

3. 完成同步（Beads 完成 → 关闭 Meegle 工单）
   → 查询 Beads status=done 的任务
   → 调用 Meegle MCP: finish_node(meegle_id)

关键约束：
  只同步 Phase 2 已完成（有验收标准）的子任务
  Phase 0-1 的模糊任务绝不进 Beads
  Mayor 不会自动执行没有验收标准的任务

#阶段对比一览

#不演进也是合理的选择

Gas Town 成熟期不是"终点"，是"可选项"。如果：

• 你的任务量一直维持在 3-5 个/周 → Phase 现在已经够用
• Phase 中期（Beads）已经解决了碰撞和依赖问题 → 停在这里完全合理
• Gas Town 的运维成本（版本耦合、tmux 不稳定）超过了收益 → 不引入

正确的问题不是"我们应该用 Gas Town 吗"，而是"当前阶段的瓶颈是什么，最小成本的解法是什么"。

#参考资料

• Gas Town + Beads 技术详解 — 本目录下的知识库文档
• Agentic Software Factory — 完整参考 — 工厂设计原则
• Agentic Software Factory — 操作手册 — Phase 0-3 工作流