用途：在按书面规格（PRD、设计文档、GitHub issue、已批准计划或多段提示）实施多文件、多提交改动时，维护一份实时的 implementation-notes.md，把设计决策、有意偏离、被否决的备选方案和待解问题记录下来，避免评审者从 diff 反推理由。
主要能力：文件分四节——Decisions（规格含糊或未提时的选择及理由）、Deviations（有意偏离规格之处，需引用规格原文并说明原因）、Tradeoffs（考虑过但被否决的备选方案及否决标准）、Open questions（需人工回答的问题，措辞应便于是/否或从短列表中选择）。每条 1–3 句，引用文件路径、行号或 commit SHA，不粘贴完整 diff。
使用方式：在首次编辑前启动，默认放在规格根目录的 implementation-notes.md，若根目录另有用途则放 .notes/<spec-slug>.md；规格在 PR 中时随同一 PR 提交。决策发生时即时追加，禁止会话结束后回填；忘记补写需标注 [reconstructed]。模板保留四个标题，即使为空。
适用场景：存在书面规格、跨多文件或多提交、且规格至少含一处歧义或缺口时。
限制：单行或单文件修复、纯调查调试、一次性脚本、约 50 行以内且只产生一次提交的规格应跳过，理由写进 commit body；空笔记文件比没有更糟。子代理实现时由父级维护，禁止多个子代理并发写入。与规划、git-commit、handoff、代码审计/PR 评审等技能配合使用。