V-COS：保持AI编码代理一致性的治理层
V-COS是一个为AI原生项目设计的治理层，旨在解决AI编码代理在多次会话中出现的上下文衰减、隐式层级冲突、认知内容与技术参考混合、缺乏自我评估和会话协议缺失等问题。它通过三层架构——文档治理、技能架构和代理治理——提供明确的文档层级、协议和评估机制，帮助开发者保持项目一致性。该项目基于实际生产经验提取，已在超过25个开发周期中验证。
V-COS是一个针对AI编码代理（如Claude Code、Cursor等）的治理层，旨在解决项目在多个会话中逐渐衰退的问题。随着会话增加，代理会面临上下文衰减、隐式层级冲突、认知内容与技术参考混杂、缺乏自我评估以及会话协议缺失等五大问题。V-COS通过三层架构来解决这些问题：第一层是文档治理，定义明确的文档层级、加载协议、热内存文件和自我评估清单；第二层是技能架构，为IDE和代理团队提供可复用的技能集；第三层是代理治理，涵盖代理设计、专业化和编排。其中前两层与具体模型无关，第三层提供了针对Claude Code的参考实现。
V-COS并非代理执行框架，也不是项目方法论或内存解决方案，而是让这些工具协同工作的治理层。它强调显式层级、热内存作为当前状态的权威、自我评估作为基础设施，并且始终以服务人类为目标。该框架源自作者Vagner Firmino在真实SaaS产品V-Strategy中的开发实践，经过25个以上的开发周期验证。
要快速上手，只需创建四个文件：AGENTS.md作为入口定义层级和协议，CLAUDE.md记录项目上下文和已知陷阱，CYCLE-CURRENT.md作为热内存跟踪当前状态，REFERENCE.md作为按需加载的技术参考。复制模板并根据项目调整后，即可在一小时内开始使用。V-COS遵循八项治理原则，包括显式层级、热内存活跃而非日记、自我评估是基础设施而非建议等。该项目以MIT许可证开源，欢迎贡献和改进。