vibe-coding-cn/docs/philosophy/AGENTS.md

Philosophy 目录 Agent 指南

目录职责

docs/philosophy/ 存放哲学方法论、思维模型、编程哲学与底层认知模型。

这里的文档回答：

• 如何建立可迁移的思维模型。
• 如何从哲学和系统视角理解工程问题。
• 如何用更底层的概念描述变化、关系和复杂度。

文件地图

philosophy/
├── README.md  # 线性总文档：思维模型、组合描述模型、编程之道、软件工程的朴素真理、方法论工具箱
└── AGENTS.md  # 本目录操作规则

修改规则

• 继承 docs/AGENTS.md 的 README 结构契约：H1 后直接进入 ## 字多不看，再按 快速导航 -> 完整细粒度目录 -> 使用方式 -> 正文 排列。
• 新增模型时，优先补到 README.md 的对应章节。
• 不再新增同级主题 .md 文件；如确需拆分，必须同步更新全仓链接和 metadata/redirects.yml。
• 哲学内容必须落到工程判断或认知工具，不写成纯概念堆叠。
• 重命名章节锚点时，必须同步更新全仓链接和 metadata/redirects.yml。
• 不在 README 正文中写 和其他目录的边界 或 维护规则；维护者规则只写本文件。

质量要求

• 每个模型说明适用场景和使用方法。
• 抽象概念应配工程例子或判断清单。
• 保持术语稳定，避免同一模型出现多个标题口径。
• 修改后必须运行 make sync-doc-toc 和 make test。