用途:通过一次一个问题的盘问式访谈,就计划的每个方面持续追问,直到达成共识;沿设计树各分支逐一解决决策间依赖,每个问题都给出推荐答案,等待反馈后再继续。若问题可通过探索代码库回答,则改为探索代码库。
主要能力:领域感知——探索代码库时同时寻找现有文档;对照 CONTEXT.md 词汇表质疑冲突术语;精炼模糊或过载语言,提出精确的规范术语;用具体场景压力测试领域关系与边界;与代码交叉引用,揭示陈述与实现之间的矛盾;术语确定时立即更新 CONTEXT.md,不批量处理;仅在满足难逆转、无上下文会令人惊讶、真实权衡结果三个条件时才提议创建 ADR。
使用方式:仓库通常只有一个上下文,根目录含 CONTEXT.md 与 docs/adr/;若根目录存在 CONTEXT-MAP.md 则说明存在多个上下文,其映射指向各上下文位置。文件懒创建:CONTEXT.md 在第一个术语确定时创建,docs/adr/ 在第一个 ADR 被需要时创建。格式参考 CONTEXT-FORMAT.md 与 ADR-FORMAT.md。
适用场景:根据项目语言与已记录决策压力测试计划,澄清领域术语与概念边界。
限制:CONTEXT.md 不应与实现细节耦合,只包含对领域专家有意义的术语;ADR 不宜滥用,三个条件缺一即跳过。资料未提供安装命令、收费、平台与具体实现方式等信息。