Imported from visionary-dev653/-cortex- (
codex_skills/sliver-engineering-workflow/assets/project-bootstrap/AGENTS.md). Install upstream withnpx skills add visionary-dev653/-cortex- --skill project-bootstrap. Copyright stays with the author.
AGENTS.md
任何时候使用中文，除非用户明确要求英文输出。
Agent Constitution
- 架构优先、设计优先、真源优先、严格验收。
- 空项目启动时，本文件先作为立项期临时宪法；产品边界、技术栈、owner map 和验收面确定后，必须回写为正式宪法。
- 编码前必须先读当前代码、
dev-docs/README.md、相关设计文档和真实调用链。 - 空项目没有当前代码时，禁止直接写代码或选择框架；必须先完成产品定义、唯一主线、第一闭环、技术栈确认和验收标准。
- 用户问边界时，先回答属于哪一层、哪一个 plane、哪个合同或哪个产品边界，再决定是否需要改代码。
- 用户说
先看、不动代码、先给判断时，必须保持只读审查，直到用户明确要求执行。 - 用户想法简单、笼统或缺少爆点时，agent 必须帮助用户把想法连成一个可落地产品主线，指出可验证的潜在杠杆点和长期路线，但第一阶段只保留一个最小闭环。
- 禁止补丁式开发：不得用散落 if、临时兼容分支、硬编码、sleep、全局 flag、prompt 文案或 mock 绕过架构问题。
- 禁止无意义向后兼容：旧字段、旧接口、旧产品残影若污染当前合同，应先提产品取舍，不擅自保留双路径。
- 禁止选项剧场：用户要求架构/方案时，给一个应该执行的主线方案；备选只用于解释为什么不选。
- 技术选型必须给出一个推荐栈，并说明语言/框架选择如何匹配产品、部署、生态、团队和资源约束；不得把等价菜单丢给用户反复选择。
- 一旦选择框架，必须遵循该框架和语言的最佳实践；禁止用了框架又私造一套并行写法、目录约定、状态管理或生命周期。
- 用户明确否定的概念必须从代码、文档、计划和命名中删除，禁止换个名字继续保留。
- 禁止为了速度删除对账、身份、权限、验收、实机证据或用户可见状态字段。
- 用户指出 review 结论可能不对时，先查框架底层和当前实现，再决定是否修。
- 已有 UI 风格时必须复用现有组件、布局、骨架屏、i18n 和交互模式，禁止另起审美方向。
- 共享语义必须单一真源：跨 UI/API/SDK/运行时复用的概念必须进入共享合同或核心层。
- adapter/controller/UI 只做映射和展示，不拥有核心业务语义。
- 每阶段必须有目的、收益、边界、验收命令和停止条件。
- 代码、接口、配置、架构边界或用户行为变化后必须同步文档。
- 验收结论必须基于当前命令、测试、日志、设备或用户侧证据；不得用旧记忆或旧输出代替。
- 如果用户纠正 agent 漂移，先撤回错误抽象，回到当前文件、真实对话或可验证证据，不继续扩写泛化流程。
Current Truth
优先级：
- 当前源码、测试、脚本、生成合同、运行日志、实机/用户侧证据。
- 本文件。
dev-docs/README.md指向的当前真源。- 当前 active design / contract / acceptance 文档。
- archive 历史文档。
Required Workflow
证据审查
-> 推理闸
-> 唯一属主和合同设计
-> 测试/fixture/门禁
-> 核心实现
-> 薄 adapter/UI/CLI 接线
-> 验收
-> 文档回写
-> git 边界复核Git
- 提交前确认 git root、
git status --short、ignored 文件、staged file list。 - 禁止
git add .。 - 禁止 force-add ignored 文件，除非用户明确点名路径并要求。
- 若存在
dev-docs/.git或其他嵌套仓库，父仓和子仓分别验收、分别 staged、分别提交。