用途：这是 harness 循环（Boot → Backpressure Check → Do Work and Observe → Retro and Magic Wand → Improve）中 Do Work and Observe 的“观察”部分，负责在做工作期间静默采集摩擦，写入 docs/harness/_buffers/<agent>.session-buffer.md，使下一次会话成本更低。
主要能力：两种触发方式均为静默、仅追加。A. 工作中观察到摩擦时记录，例如工具调用超过 30 秒、搜索意外零结果、同一操作重试多于一次、因错误假设回退、测试或构建失败需要猜测、缺乏 smoke 路径/截图/日志/追踪/健康证据而只能推断运行时行为、只能肉眼审查本可由确定性检查证明的架构或约束等。B. 自然停顿处的自我提示（魔法棒反射）：问自己“如果现在有魔法棒，我会改什么”，有具体答案才记录；任务完成后可改问证明缺口：本任务成功是否可用命令或确定性检查证明，还是靠肉眼判断。
使用方式：每次调用追加一个符合通用 Entry schema 的 YAML 块，包含 id、kind、description 等必填字段，可选 target、severity、workaround、suggested_encoding 及 system.compound 块。缓冲文件按调用方 CLI slug 命名，如 claude-code.session-buffer.md。缓冲不存在则创建；_buffers/ 不存在则静默退出并报告 UNAVAILABLE。
限制：存在 docs/harness/.disabled 时完全静默退出；不输出任何面向用户的信息；不提示用户；不应用修复；不读取或整理缓冲；不实现传感器。软件目标为自提示每 5 分钟不超过 1 次、每会话平均不超过 5 条（软目标）。