title: "Rule — 待办登记（"想做但先不做"的归宿）" description: 用户/AI 想到要做但当前不做的事情如何登记，确保不遗忘 tags: [rule, todo, backlog, workflow] created: 2026-05-26 updated: 2026-05-26 type: rule status: stable related: - "_todo" - "[[00-meta-rule|00-元规则]]"

Rule — 待办登记¶

适用场景：用户提到「以后做」「先记下」「下次改」「想到了但现在不弄」时；或 AI 修一个 bug 时发现旁边还有个小问题。

一句话铁律¶

所有"想做但不立刻做"的事情都必须落档到 docs/ 某处，否则就会被遗忘。登记成本应该接近零 — 即使没时间评估也要先粘贴原话到 docs/raw/inbox/。

决策树：往哪登记？¶

是 bug 吗？
├─ 是 ──→ docs/issues/XXXX-*.md
│         · 已开始修但没修完  → status: in-progress
│         · 修过又犯           → status: recurring（同时补铁律）
│         · 现象在但根因未明  → status: observing
│
└─ 不是 ──→ 需要架构设计 / PRD 吗？
            ├─ 是 ──→ docs/specs/active/SPEC-XXX-*.md
            │         · 还在写        → status: draft
            │         · 评审通过      → status: approved
            │         · 开工中        → status: in-progress
            │         · 评估后暂缓    → 移到 docs/specs/parked/
            │
            └─ 不是 ──→ 用户原话 / 小想法 → docs/raw/...
                       · 反馈类（用户主动提）   → raw/feedback/
                       · 灵感 / 未来可能做     → raw/ideas/
                       · 还没分类的            → raw/inbox/
                       · 设置 status: unprocessed（默认）

兜底：登记速度大于一切¶

没空评估？粘到 raw/inbox/：

---
title: <一句话原话>
description: <30字内>
tags: [raw, inbox, todo]
created: YYYY-MM-DD
type: raw
source: user-mention | claude-noticed
status: unprocessed
---

> <原话粘贴>

## 上下文
- 何时提到：<对话节点>
- 当前版本：v0.10.XX
- 紧迫度：low | medium | high

不要因为"等想清楚再写"而拖延 — 想清楚的就直接 SPEC。

自动聚合在哪看¶

跑完 pnpm docs:rebuild 后看 docs/_todo.md：所有未完结状态的文档都会聚合在那里，新会话一开就能扫到。

AI 应该做什么¶

每次会话开始 → 看 docs/_todo.md 头几行的总数，知道有 backlog
用户说"我们以前提过 XX" → 在 _todo.md 搜，不要凭记忆答
修 bug 时发现旁边还有小问题 → 用 spawn_task 或当场补 raw/inbox/ 一条
完成一项 → 改对应文件 status；跑 pnpm docs:rebuild 同步聚合页
不要在 development-log.md 的"注意点"里写"以后做" — 那一节会沉底；要做的事去 raw/inbox/

反模式¶

❌ "我先记在心里，后面提醒用户" — AI 跨会话无记忆，必落档 ❌ "在 dev log 末尾加个注意点" — dev log 是历史，不是 backlog ❌ "评估完才写" — 评估前粘原话到 inbox，评估后再升级到 spec ❌ "用 TaskCreate 记" — TaskCreate 是会话内任务，关闭就丢