SDD · MVCP 总览

为什么是 MVCP 而不是 MVC

传统 MVC 三分对一个有大量「长进程 / 异步循环」的系统不够用。DevLoop 系统里：

• L1/L2/L3 是长时运行的状态机
• 每个 Agent 是长寿子进程（ACP session 复用）
• SSE Broker 是持续推送通道

这些都不属于 Controller（即时响应请求），也不属于 Model（数据）。给它们一个独立象限 Process 才有归处。

四象限

每个定义的「五字段标准」

所有 MVCP 页里的每条定义都强制遵循下表结构，便于 Claude Code 用同一套抽取器处理：

HTML 模板示例

<section data-def-name="DocStore.writePRD" data-mvcp="control">
  <h3>DocStore.writePRD(pid, html)</h3>
  <code class="path">server/services/doc-store.js</code>

  <pre class="shape">
async function writePRD(pid: string, html: string): Promise<{rev: number}>
  </pre>

  <ul class="contract">
    <li>前置：html 必须包含顶级 article[data-doc="prd"]</li>
    <li>后置：旧版本归档到 history/prd-rev-{rev}.html</li>
  </ul>

  <ul class="tests">
    <li>写入后 readPRD 能读回完全一致内容</li>
    <li>非法 HTML 抛 ValidationError</li>
  </ul>
</section>

本套文档因美观需要不完全遵守这个最严格的 HTML 模板，但每条定义至少含 name + path + shape。完全机械化版会在 P1 实施时由 Architect Agent 产出。

抽取流程

// Claude Code 抽取 build-manifest 的伪代码
const manifest = { model: [], view: [], control: [], process: [] };
for (const mvcp of ['model', 'view', 'control', 'process']) {
  const html = await fetch(`sdd-${mvcp}.html`).then(r => r.text());
  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(),
      shape:    $(el).find('pre.shape').text(),
      contract: $(el).find('ul.contract li').map((_,li) => $(li).text()).get(),
      tests:    $(el).find('ul.tests li').map((_,li) => $(li).text()).get(),
    });
  });
}
fs.writeFileSync('build-manifest.json', JSON.stringify(manifest, null, 2));

结果是一份 build-manifest.json，能直接喂给 Architect Agent 生成 units.json + Unit spec 文件。

四象限对应 Agent