一个项目里，代码改动通常有清晰的 Git 历史：谁改了什么、在哪个提交、后来怎么合并。架构决策却常常散落在聊天记录、评审评论和某位同事的记忆里。
几个月后再看一个模块，代码还在，为什么当初这么设计却不一定找得到。AI 参与开发之后，这个问题更明显：它改了代码，却未必知道团队过去为什么划定了这条边界。
把决策记录放回项目
Jin 把项目的架构历史保存在 .jin/wal.jsonl。用户批准的架构变更、相关 Intent 和实现记录都可以留在项目中，与代码一起通过 Git 审阅和协作。
这里的重点不是多存一份文档，而是让“准备做什么”“批准了什么”和“最后实现了什么”能互相对应。需要了解项目演进时，团队可以查看这些记录，而不必完全依赖口头交接。
Jin 的 WAL 按追加记录保存；分支间可以合并记录集合。遇到语义冲突时，应用会把冲突保留并整理为待处理的合并意图，而不是静默改写历史。正常 Git 工作流仍然是协作基础，团队也可以用熟悉的方式审阅项目文件。
让 AI 看见项目不只是文件
Jin 会扫描项目，形成模块与文件层级的架构图。面对新需求时，它会提出受影响节点和建议变化；人在批准后，AI 才开始实施。实现完成后，项目会重新扫描，检查代码是否符合记录下来的架构变化。
这样，架构历史不只是给人看的背景资料，也能在下一次变更时帮助建立上下文。不过它不会替团队决定什么是好架构，也不能保证实现没有缺陷。提案仍需审阅，代码仍需测试。
适合想把项目交接清楚的团队
如果架构决策经常因为人员变动而丢失，或者 AI 改动难以追溯到明确的设计意图，把决策和代码放在同一套协作历史里，可能是个实用的起点。
Jin 是一个面向架构的桌面 Coding Agent，支持 OpenAI 兼容接口和 Ollama。了解项目并下载应用：github.com/ZYF93/Jin
