用途:把项目中有意做出的选择——技术选型、架构决定、长期约束、编码规约——记录成永久性决策文档,避免上下文丢失导致重复讨论或 AI 给出与规约冲突的方案。
主要能力:将每条决策归入四类之一:tech-stack(技术/库/框架选型)、architecture(系统结构、模块划分、数据流)、constraint(硬约束,不允许做的事)、convention(软规约,统一做法)。文档写入 .codestable/compound/,命名 YYYY-MM-DD-decision-{slug}.md,frontmatter 带 doc_type: decision,category 仅限四种,status 仅限 active/superseded/deprecated。
使用方式:启动先读 .codestable/attention.md;流程分识别决策、查重叠与意图分流、提炼要点、起草并用户 review、归档、提示相关工作流更新。结论变更走 supersede(旧文档标 status: superseded 并保留原文),只补背景走 update。可用搜索工具查询:python .codestable/tools/search-yaml.py --dir .codestable/compound --filter doc_type=decision --filter status=active(可叠加 category、query、--json)。
限制:只归档已拍板的决定,讨论中的不归档;不替用户编造理由,说不出写"未做系统评估";不主动修改 attention.md 和 ARCHITECTURE.md,仅提示;只读写 doc_type: decision 的文档。