用途：为软件项目建立结构化项目记忆，把未来待办和过往经验分别归档。三个表面按时间方向和访问方式划分：TODO.md 回答“以后可能做什么”，按优先级泳道从上到下阅读；backlog/<slug>.md 回答“某个想法背后的分析是什么”，由 TODO.md 索引；pitfalls/<slug>.md 回答“是否遇到过错误 X”，通过症状关键词 grep 查找。已有 agent 契约的项目还可用 AGENTS.md 硬性不变量回答规则问题。
主要能力：捆绑五个脚本与多个模板。init.sh 一次性创建 TODO.md、backlog/、pitfalls/ 并追加 agent 指引与 README 片段，默认幂等，已有文件跳过，需 --force 才覆盖；todo-kanban.sh 校验格式并渲染看板，支持 --json 与 --validate-only；add-todo.sh 按优先级插入条目，可加 --backlog 生成文档；promote-todo.sh 将活动条目移入 Done 并复验；sweep-inbox.sh 整理 backlog/inbox.md。
使用方式：初始化示例：scripts/init.sh --target /path/to/project --project-name "My Project" --deployment chezmoi，部署方式还可用 npm | pip | docker | none。添加待办示例：scripts/add-todo.sh --priority "P?" --effort M --title "Try Rspress for docs" --description "Evaluate AI-native docs framework alternative"。实现某项时运行 scripts/promote-todo.sh --title "<substring>" --summary "<what shipped>"。调试完成后立即用模板写 pitfalls 文档，标题按症状而非根因，错误信息原样复制。
限制：不用于当前冲刺规划（用 issue 跟踪器）、临时 agent 草稿（用 .claude/plans/）或当前功能文档（用 docs/）。init.sh 不会编辑忽略文件，部署排除行需按 references/deployment-exclusion.md 手动添加。其他收费、价格、平台与效果信息暂未提供。