# AGENTS.md 片段 · design.md 盲测复述（spawn ≠ fork）

把下面整段粘进项目的 `AGENTS.md` / 团队约定即可。中英并列；执行时以英文 prompt 为准（与原帖一致）。

---

## Design doc blind restatement (spawn ≠ fork)

**Before writing code from a design doc:**

1. Spawn a **new** subagent — **not** a fork of the current conversation.
2. Give it **only** the path to `design.md` (or the agreed design file). **No summary.** No paste of “what we just decided.”
3. Have it:
   - Write two paragraphs in its own words (2–5 sentences each): what this doc proposes, and how the existing system works according to the doc.
   - Mark any part it can't explain back as a **blocker**.
   - List project-specific terms the doc never defines or links to, and setup steps the doc assumes the reader already knows but never writes down.
4. The subagent is **read-only** and changes no files.
5. Compare its version with the plan we agreed on. **Wherever they don't match, fix the doc first, then write the code.**

**Why not fork:** Fork mode carries the whole conversation, so restatement looks perfect and fails to catch ambiguity.

### 中文摘要

写码前：spawn **新**子 agent（不要 fork）；只给 `design.md` 路径、不给摘要；让它用自己的话复述提议与「文档中的现有系统」、标 blocker、列出未定义术语与未写明的 setup。只读。对不上先改文档再写代码。Fork 会带着对话把含糊补上，测不出来。

### Copy-paste prompt (EN, verbatim)

```
Spawn a new subagent, not a fork. Give it only the path to design.md, no summary. Have it:
1. Write two paragraphs in its own words (2-5 sentences each): what this doc proposes, and how the existing system works according to the doc.
2. Mark any part it can't explain back as a blocker.
3. List project-specific terms the doc never defines or links to, and setup steps the doc assumes the reader already knows but never writes down.
It's read-only and changes no files. Compare its version with the plan we agreed on. Wherever they don't match, fix the doc first, then write the code.
```