# Claude Code 复现指南

> 把这套 PRD + SDD 喂给一个全新的 Claude Code session，让它从空仓库（仅有 LemonBoss 既有代码）重建整套 DevLoop 系统。本页含：执行 prompt 模板 + manifest 抽取脚本 + 验收清单。

## 三步法

<!-- 图见原 HTML -->

## 步骤 ① · 抽取 build-manifest.json

需要 node + cheerio。脚本 ~80 行：

```js
// scripts/extract-manifest.js · NEW
const fs = require('fs');
const path = require('path');
const cheerio = require('cheerio');

const docsDir  = path.resolve(__dirname, '../docs/prd/newfunction');
const manifest = {
  meta: { source: 'docs/prd/newfunction', prdRev: 'v0.2' },
  model: [], view: [], control: [], process: [],
  units: [],
};

// 1. 从 sdd-{mvcp}.html 抽 4 象限
for (const mvcp of ['model', 'view', 'control', 'process']) {
  const html = fs.readFileSync(path.join(docsDir, `sdd-${mvcp}.html`), 'utf8');
  const $ = cheerio.load(html);
  $('[data-def-name]').each((_, el) => {
    manifest[mvcp].push({
      name:     $(el).attr('data-def-name'),
      path:     $(el).find('code.path').first().text() ||
                $(el).find('code.path.mono').first().text(),
      shape:    $(el).find('pre.shape').text() ||
                $(el).find('pre.code.shape').text(),
      contract: $(el).find('ul.contract li').map((_,li) => $(li).text()).get(),
      tests:    $(el).find('ul.tests li').map((_,li) => $(li).text()).get(),
    });
  });
}

// 2. 从 prd-feature-tree.html 抽 Unit 列表（粗）
// 这步实际由 Architect Agent 做 P1 时的拆分；脚本只做最简取出 file tree 中的 Unit id

fs.writeFileSync('build-manifest.json', JSON.stringify(manifest, null, 2));
console.log(`✓ extracted ${manifest.model.length + manifest.view.length + manifest.control.length + manifest.process.length} definitions`);
```

跑一下：

```js
cd lemonboss
node scripts/extract-manifest.js
# → build-manifest.json (~30KB)
```

## 步骤 ② · 复现 Prompt 模板

把以下 prompt 喂给一个全新的 Claude Code session（在空 lemonboss 仓库根目录启动）。

```js
# 复现 prompt · 直接粘到 claude code

我手上有一份 LemonBoss DevLoop 系统的完整 PRD + SDD（HTML 形式），位于
docs/prd/newfunction/ 下，共 41 页。我已用脚本抽出 build-manifest.json。

请你扮演 Architect + Coder + Tester 三个角色，完成以下工作：

【阶段 A · 拆 Unit】
1. 读 docs/prd/newfunction/prd-feature-tree.html，确认 34 个 Unit
2. 读 build-manifest.json，把 MVCP 四象限的定义映射到 Unit
3. 在 data/companies/c-repro/projects/p-init/units.json 落地 DAG

【阶段 B · 实现每个 Unit】
对每个 Unit 顺次：
1. 读对应 Unit 的所有 MVCP 定义（manifest 里的 model/view/control/process）
2. 按 path 字段落盘，按 shape 字段写代码骨架
3. 按 contract 列表实现行为
4. 按 tests 列表写 vitest 用例（后端 supertest + 内存 SQLite，前端 @vue/test-utils）
5. 跑 vitest，红了反思（参考 docs/prd/newfunction/loops-l1.html 的 retryWithReflection
   章节），重写直到绿

【阶段 C · 集成】
1. 读 docs/prd/newfunction/sdd-process.html 实现 LoopController.runProject
2. 启动后端 + 前端，cd 到 docs/prd/newfunction，用 docs 自己做 demo 项目跑一遍
3. 注入「contract_mismatch」演示自愈

【约束】
- 严格遵守 docs/prd/newfunction/agents-coder.html 的沙箱规则
- 任何带 JSON body 的 curl 必须先写 /tmp/*.json 再 -d @file
  （参见 CLAUDE.md L91-99）
- 不动 server/services/evolution-loop.js（参见 arch-mapping.html PATCH 说明）
- 不动 packages/acp-core/ · core/master-session.js · core/agent-manager.js

【验收】
完成后跑 npm test，所有 vitest 必须通过。然后跑：
  curl -X POST http://localhost:3010/api/devloop/projects -d @/tmp/test.json
  （/tmp/test.json 单行紧凑：
   {"company_id":"c-001","name":"todo","requirement":"做个 TODO API"}）
应在 60 秒内看到 prd.html + sdd.html + units.json 三份文档生成。

开始吧。
```

## 步骤 ③ · 验收清单

Claude Code 跑完后，人类只需对照以下 12 条逐项检查：

| # | 检查点 | 判定 |
| --- | --- | --- |
| 1 | `server/src/core/loop-controller.js` 存在且导出 loopController | ✓ require 不报错 |
| 2 | `server/services/doc-store.js` 存在 | ✓ |
| 3 | `server/services/unit-registry.js` 存在 | ✓ |
| 4 | `server/services/sse-broker.js` 存在 | ✓ |
| 5 | `server/routes/devloop.js` 存在且 7 个端点全 | ✓ `curl /api/health` + grep |
| 6 | `system/templates/devloop-{pm,architect,coder,tester,integrator,triager}.md` 全部存在 | ✓ ls 应见 6 个 |
| 7 | `system/templates/_registry.json` 含 devloop-* 六条 | ✓ grep |
| 8 | `web/src/views/DevLoopDashboard.vue` + 7 个子组件 | ✓ ls web/src/components/devloop/ |
| 9 | npm test 全绿 | ✓ |
| 10 | POST /api/devloop/projects 60s 内生成 3 份文档 | ✓ file 存在 |
| 11 | SSE 流持续推 unit.state 事件 | ✓ curl -N 看到 |
| 12 | 整套 DevLoop 能**对自己做增量**（用 DevLoop 给 DevLoop 加新需求） | ✓ 元-自举测试 |

## 典型失败模式与诊断

| 失败 | 诊断 | 修 |
| --- | --- | --- |
| 缺某个 MVCP 定义 | build-manifest.json 该项空 | 检查对应 SDD 页是否漏 data-def-name |
| shape 抽不到 | HTML class 不规范 | 用 pre.shape 不是 pre.code 也不是 pre.code.shape，统一 |
| Claude Code 写出的代码风格与 LemonBoss 不一致 | prompt 缺约束 | 在复现 prompt 顶部 require 它先读 CLAUDE.md |
| contract.json 与 SDD 不一致 | Architect 没遵循 hashContract 算法 | 看 docs/prd/newfunction/api-contracts.html 第 4 节 |
| L2 修复死循环 | l2_budget 没设 | project.json 默认值校验 |
| SSE 不断重连 | 心跳没发 | 看 sse-broker.js 25s setInterval |

## 「文档驱动」承诺

**这套 PRD + SDD 的一致性是项目本身的健康指标。**

如果未来某次实际代码与文档脱节超过 20%（脚本扫描 unit id 对齐率），系统会发 SSE 警告，提示要么改文档要么改代码。文档永远是 source of truth；代码是执行结果。

## 下一步

完成本页所述复现一次，相当于：

- ✓ 验证 PRD + SDD 的**可执行性**（不只是写给人看）
- ✓ 验证 Claude Code + LemonBoss ACP 的**能力上限**
- ✓ 给团队和投资人一个明确的**能力证明**（demo 时直接放复现录屏）

复现成功的录屏 + 时间戳 + manifest hash 应保存在 `docs/prd/newfunction/repro-evidence/`，作为项目交付物的一部分。