vibe-coding-cn/docs/README.md

# 知识库总索引

## 字多不看

- 新手先读 `getting-started/`，按 Vibe Coding 经验、学习地图、网络环境、CLI 配置和开发环境推进。
- 想理解 Vibe Coding 的底层概念，读 `concepts/`。
- 想补思维模型、软件工程常识和方法论，读 `philosophy/`。
- 想查工程模板、质量门禁、技术栈和常见坑，读 `references/`。
- 想记录新技术、优秀 repo 或工程趋势，读 `research/`。
- 想按标准流程推进任务、提交和推送，读 `workflow/`。

## 快速导航

| 目录 | 定位 | 首选入口 |
|:---|:---|:---|
| [getting-started](./getting-started/) | 从零开始的入门教程 | [Vibe Coding 经验](./getting-started/vibe-coding-experience.md) / [学习地图](./getting-started/learning-map.md) |
| [concepts](./concepts/) | 核心概念、问题求解、关键词系统与工程思想 | [问题求解](./concepts/problem-solving.md) / [拼好码](./concepts/glue-coding.md) / [关键词系统](./concepts/keyword-system.md) |
| [philosophy](./philosophy/) | 哲学方法论、思维模型与底层认知模型 | [思维模型](./philosophy/thinking-models.md) / [方法论工具箱](./philosophy/methodology-toolbox.md) |
| [references](./references/) | 工程实践、技术栈、模板和检查清单 | [项目架构模板](./references/project-architecture-template.md) / [质量门禁](./references/quality-gates-and-pitfalls.md) |
| [research](./research/) | 新技术、优秀 repo 与工程范式研究 | [Harness 工程解析](./research/harness-engineering.md) / [tmux 蜂群协作](./research/tmux-ai-swarm.md) |
| [workflow](./workflow/) | 开发流程、质量门禁和交付闭环 | [开发流程](./workflow/development-process.md) |

<details>
<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>

### 全部文档索引

### getting-started

- [README](./getting-started/README.md) - 从零开始索引。
- [Vibe Coding 经验](./getting-started/vibe-coding-experience.md) - 通用语言能力、人机分工、机器门禁和入门铁律。
- [学习地图](./getting-started/learning-map.md) - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。
- [网络环境配置](./getting-started/network-environment.md) - OpenAI、GitHub、文档和依赖源访问。
- [CLI 配置](./getting-started/cli-setup.md) - Codex CLI 默认路线与 OpenCode 备选路线。
- [开发环境搭建](./getting-started/development-environment.md) - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。
- [AGENTS](./getting-started/AGENTS.md) - 入门教程目录操作规则。

### concepts

- [README](./concepts/README.md) - 核心概念索引。
- [问题求解](./concepts/problem-solving.md) - 用目标、现状、差距、标准、约束、对象和路径定义问题。
- [拼好码](./concepts/glue-coding.md) - 复用成熟能力，用胶水代码连接、编排、适配业务流程。
- [系统构建方法](./concepts/system-building.md) - 自顶向下、自底向上与分而治之的组合使用。
- [开发范式演进](./concepts/development-paradigms.md) - 软件工程组织方式的演进。
- [语言层要素](./concepts/language-layers.md) - 看懂代码所需的语言层要素。
- [关键词系统](./concepts/keyword-system.md) - Vibe Coding 与工程协作中的高频关键词。
- [递归自优化系统](./concepts/recursive-self-optimizing-system.md) - 递归自优化生成系统的形式化模型。
- [AGENTS](./concepts/AGENTS.md) - 核心概念目录操作规则。

### philosophy

- [README](./philosophy/README.md) - 哲学方法论索引。
- [思维模型](./philosophy/thinking-models.md) - 可复用思维模型索引。
- [组合描述模型](./philosophy/compositional-description-model.md) - 用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
- [编程之道](./philosophy/programming-dao.md) - 编程哲学与工程判断。
- [软件工程的朴素真理](./philosophy/software-engineering-truths.md) - 代码、复杂度、需求、维护、质量、架构和团队的工程常识。
- [方法论工具箱](./philosophy/methodology-toolbox.md) - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。
- [AGENTS](./philosophy/AGENTS.md) - 哲学方法论目录操作规则。

### references

- [README](./references/README.md) - 参考资料索引。
- [项目架构模板](./references/project-architecture-template.md) - 常见项目结构、架构设计原则、最低门禁和检查清单。
- [通用 Python 项目骨架](./references/python-project-skeleton.md) - Python 应用、服务、脚本工具和库项目的通用骨架。
- [企业级架构模板](./references/enterprise-architecture-template.md) - 中大型工程组织、平台工程和多产品线参考模型。
- [现代企业数字化平台架构](./references/modern-enterprise-architecture-template.md) - 面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线架构原则、约束、反模式与例外执行总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与 RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、基线运营韧性与重要业务服务影响容忍总账、基线第三方与关键供应商风险总账、基线数据驻留与跨境处理总账、基线共享责任与继承控制总账、基线独立控制保证抽样总账、基线连续控制监测总账、基线运行时准入决策总账、基线运行时准入回执、基线长期验签回执、基线证据不可变归档回执、干净环境基线重建回执、私有制品托管交接清单、审计导出排除清单、本地私有制品边界、基线迁移执行回执、基线迁移工作单、基线消费锁定文件、基线准入执行策略、基线撤销与隔离记录、基线发布事务回执、基线门禁执行报告、基线证据追踪图、基线会审裁决记录、基线 EOL 退役证书、基线状态对账报告、基线生命周期状态机、基线就绪评分卡、基线例外总账、基线回滚验证记录、基线通知确认总账、基线验证环境锁定、基线制品清单、基线发布证据、基线兼容性总账、基线采纳总账、基线支持矩阵、基线发布列车、基线符合性声明、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档。
- [常识](./references/common-sense.md) - AI 编程和工程交付前的最低判断线。
- [Dataset First 数据服务](./references/dataset-first-data-service.md) - 数据服务模板。
- [代码组织](./references/code-organization.md) - 模块化、命名、注释、格式化、文档和工具。
- [开发经验](./references/development-experience.md) - 编码规范、架构原则和常见基础设施经验。
- [AI 编程质量门禁与常见坑](./references/quality-gates-and-pitfalls.md) - 系统提示词、强前置条件、常见坑和硬门禁。
- [底层程序逻辑设计与工程优化项](./references/low-level-program-logic.md) - 运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
- [技术栈](./references/technology-stack.md) - 技术栈选型、组合案例与初学者学习路径。
- [AGENTS](./references/AGENTS.md) - 参考资料目录操作规则。

### research

- [README](./research/README.md) - 研究笔记索引。
- [Harness 工程解析](./research/harness-engineering.md) - Harness Engineering 的工程控制、评估器与反馈闭环解析。
- [tmux 蜂群协作](./research/tmux-ai-swarm.md) - 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式。
- [AGENTS](./research/AGENTS.md) - 研究笔记目录操作规则。

### workflow

- [README](./workflow/README.md) - 开发流程索引。
- [开发流程](./workflow/development-process.md) - 默认任务推进顺序、质量门禁和交付闭环。
- [AGENTS](./workflow/AGENTS.md) - 开发流程目录操作规则。

</details>

## 使用方式

- 只想快速开始：从 [getting-started](./getting-started/README.md) 进入。
- 已经有项目问题：先读 [问题求解](./concepts/problem-solving.md)，再读 [质量门禁与常见坑](./references/quality-gates-and-pitfalls.md)。
- 需要给 AI Agent 上下文：先给它 [AGENTS](./AGENTS.md)，再给它当前任务对应目录的 README 和具体正文文档。
- 需要规范执行顺序：读 [开发流程](./workflow/development-process.md)。
- 新增内容时，先判断它属于教程、概念、哲学、参考还是研究，再放入对应目录的独立文档。

## 正文

### 推荐阅读路径

#### 新手路径

1. [Vibe Coding 经验](./getting-started/vibe-coding-experience.md)
2. [学习地图](./getting-started/learning-map.md)
3. [问题求解](./concepts/problem-solving.md)
4. [拼好码](./concepts/glue-coding.md)
5. [质量门禁与常见坑](./references/quality-gates-and-pitfalls.md)

#### 开发者路径

1. [拼好码](./concepts/glue-coding.md)
2. [系统构建方法](./concepts/system-building.md)
3. [技术栈](./references/technology-stack.md)
4. [项目架构模板](./references/project-architecture-template.md)

#### 思维模型路径

1. [思维模型](./philosophy/thinking-models.md)
2. [组合描述模型](./philosophy/compositional-description-model.md)
3. [编程之道](./philosophy/programming-dao.md)
4. [软件工程的朴素真理](./philosophy/software-engineering-truths.md)
5. [递归自优化系统](./concepts/recursive-self-optimizing-system.md)

#### AI Agent 读取路径

1. [根目录 AGENTS](../AGENTS.md)
2. [docs 目录 AGENTS](./AGENTS.md)
3. [开发流程](./workflow/development-process.md)
4. [Vibe Coding 经验](./getting-started/vibe-coding-experience.md)
5. [项目架构模板](./references/project-architecture-template.md)
6. [质量门禁与常见坑](./references/quality-gates-and-pitfalls.md)
7. [AI 引用语料](../assets/ai-citation/README.md)