# 知识库总索引

## 字多不看

- 新手先读 `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) |
| [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/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 成本治理、版本治理、版本控制面、基线制品清单、基线发布证据、基线兼容性总账、基线采纳总账、基线支持矩阵、基线发布列车、基线符合性声明、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档。
- [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)