作者关心的不是 agent 能不能改代码，而是它说「做完了」之后留下的现场：第二天早上有人打开仓库，能不能看懂改了什么、检查了什么、还有什么没处理。他认为一次有用的会话应该让项目停在别人或别的 agent 无需重建对话就能接手的状态，这意味着把指令放在代码旁边、写清如何启动与自检、记录那些会让新人意外的决定。而当文档与代码冲突时，agent 还得有能力识别并解决这个冲突。