- 新手先读
getting-started/，按 Vibe Coding 经验、学习地图、网络环境、CLI 配置和开发环境推进。 - 想理解 Vibe Coding 的底层概念，读
concepts/。 - 想补思维模型、软件工程常识和方法论，读
philosophy/。 - 想查工程模板、质量门禁、技术栈和常见坑，读
references/。 - 想记录新技术、优秀 repo 或工程趋势，读
research/。 - 想按标准流程推进任务、提交和推送，读
workflow/。
| 目录 | 定位 | 首选入口 |
|---|---|---|
| getting-started | 从零开始的入门教程 | Vibe Coding 经验 / 学习地图 |
| concepts | 核心概念、问题求解与工程思想 | 问题求解 / 拼好码 |
| philosophy | 哲学方法论、思维模型与底层认知模型 | 思维模型 / 方法论工具箱 |
| references | 工程实践、技术栈、模板和检查清单 | 项目架构模板 / 质量门禁 |
| research | 新技术、优秀 repo 与工程范式研究 | Harness 工程解析 / tmux 蜂群协作 |
| workflow | 开发流程、质量门禁和交付闭环 | 开发流程 |
完整细粒度目录（点击展开/收起）
- README - 从零开始索引。
- Vibe Coding 经验 - 通用语言能力、人机分工、机器门禁和入门铁律。
- 学习地图 - 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择。
- 网络环境配置 - OpenAI、GitHub、文档和依赖源访问。
- CLI 配置 - Codex CLI 默认路线与 OpenCode 备选路线。
- 开发环境搭建 - 让 Agent 主动配置开发依赖、编辑器建议和测试命令。
- AGENTS - 入门教程目录操作规则。
- README - 核心概念索引。
- 问题求解 - 用目标、现状、差距、标准、约束、对象和路径定义问题。
- 拼好码 - 复用成熟能力，用胶水代码连接、编排、适配业务流程。
- 系统构建方法 - 自顶向下、自底向上与分而治之的组合使用。
- 开发范式演进 - 软件工程组织方式的演进。
- 语言层要素 - 看懂代码所需的语言层要素。
- 递归自优化系统 - 递归自优化生成系统的形式化模型。
- AGENTS - 核心概念目录操作规则。
- README - 哲学方法论索引。
- 思维模型 - 可复用思维模型索引。
- 组合描述模型 - 用对象、状态、快照、序列、过程、变换、同一/差异与关系描述复杂系统。
- 编程之道 - 编程哲学与工程判断。
- 软件工程的朴素真理 - 代码、复杂度、需求、维护、质量、架构和团队的工程常识。
- 方法论工具箱 - 现象学还原、正反合、可证伪主义、形式化方法等提效工具。
- AGENTS - 哲学方法论目录操作规则。
- README - 参考资料索引。
- 项目架构模板 - 常见项目结构、架构设计原则、最低门禁和检查清单。
- 通用 Python 项目骨架 - Python 应用、服务、脚本工具和库项目的通用骨架。
- 企业级架构模板 - 中大型工程组织、平台工程和多产品线参考模型。
- 现代企业数字化平台架构 - 面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线架构原则、约束、反模式与例外执行总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与 RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、基线运营韧性与重要业务服务影响容忍总账、基线第三方与关键供应商风险总账、基线数据驻留与跨境处理总账、基线共享责任与继承控制总账、基线独立控制保证抽样总账、基线连续控制监测总账、基线运行时准入决策总账、基线运行时准入回执、基线长期验签回执、基线证据不可变归档回执、干净环境基线重建回执、私有制品托管交接清单、审计导出排除清单、本地私有制品边界、基线迁移执行回执、基线迁移工作单、基线消费锁定文件、基线准入执行策略、基线撤销与隔离记录、基线发布事务回执、基线门禁执行报告、基线证据追踪图、基线会审裁决记录、基线 EOL 退役证书、基线状态对账报告、基线生命周期状态机、基线就绪评分卡、基线例外总账、基线回滚验证记录、基线通知确认总账、基线验证环境锁定、基线制品清单、基线发布证据、基线兼容性总账、基线采纳总账、基线支持矩阵、基线发布列车、基线符合性声明、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档。
- 常识 - AI 编程和工程交付前的最低判断线。
- Dataset First 数据服务 - 数据服务模板。
- 代码组织 - 模块化、命名、注释、格式化、文档和工具。
- 开发经验 - 编码规范、架构原则和常见基础设施经验。
- AI 编程质量门禁与常见坑 - 系统提示词、强前置条件、常见坑和硬门禁。
- 底层程序逻辑设计与工程优化项 - 运行模型、并发模型、数据模型、性能模型和工程交付检查清单。
- 技术栈 - 技术栈选型、组合案例与初学者学习路径。
- AGENTS - 参考资料目录操作规则。
- README - 研究笔记索引。
- Harness 工程解析 - Harness Engineering 的工程控制、评估器与反馈闭环解析。
- tmux 蜂群协作 - 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式。
- AGENTS - 研究笔记目录操作规则。
- 只想快速开始：从 getting-started 进入。
- 已经有项目问题：先读 问题求解，再读 质量门禁与常见坑。
- 需要给 AI Agent 上下文：先给它 AGENTS，再给它当前任务对应目录的 README 和具体正文文档。
- 需要规范执行顺序：读 开发流程。
- 新增内容时，先判断它属于教程、概念、哲学、参考还是研究，再放入对应目录的独立文档。