sections:
  getting-started:
    path: docs/getting-started
    purpose: 从零开始学习路径、学习地图、环境配置与 AI CLI 配置
    entry: docs/getting-started/README.md
    agent_guide: docs/getting-started/AGENTS.md
  concepts:
    path: docs/concepts
    purpose: 核心概念、问题求解与工程思想
    entry: docs/concepts/README.md
    agent_guide: docs/concepts/AGENTS.md
  philosophy:
    path: docs/philosophy
    purpose: 哲学方法论、思维模型、编程哲学与底层认知模型
    entry: docs/philosophy/README.md
    agent_guide: docs/philosophy/AGENTS.md
  research:
    path: docs/research
    purpose: 新技术、技术栈、优秀 repo、工程范式和工具趋势的短篇研究
    entry: docs/research/README.md
    agent_guide: docs/research/AGENTS.md
  workflow:
    path: docs/workflow
    purpose: 开发流程、质量门禁、版本控制和文档同步的执行顺序
    entry: docs/workflow/README.md
    agent_guide: docs/workflow/AGENTS.md
  references:
    path: docs/references
    purpose: 清单、模板、强约束与常见坑
    entry: docs/references/README.md
    agent_guide: docs/references/AGENTS.md

reading_paths:
  beginner:
    title: 新手路径
    documents:
      - docs/getting-started/README.md
      - docs/getting-started/README.md#vibe-coding-experience
      - docs/concepts/README.md#concept-problem-solving
      - docs/concepts/README.md#concept-glue-coding
      - docs/references/README.md#reference-engineering-practice
  developer:
    title: 开发者路径
    documents:
      - docs/concepts/README.md#concept-glue-coding
      - docs/concepts/README.md#concept-system-building
      - docs/references/README.md#reference-technology-stack
      - docs/references/README.md#reference-engineering-practice
  thinking:
    title: 思维模型路径
    documents:
      - docs/philosophy/README.md#philosophy-thinking-models
      - docs/philosophy/README.md#philosophy-compositional-description-model
      - docs/philosophy/README.md#philosophy-programming-dao
      - docs/concepts/README.md#concept-recursive-self-optimizing-system
  agent:
    title: AI Agent 读取路径
    documents:
      - AGENTS.md
      - docs/AGENTS.md
      - docs/workflow/README.md#workflow-development-process
      - docs/getting-started/README.md
      - docs/getting-started/README.md#vibe-coding-experience
      - docs/references/README.md#reference-engineering-practice
      - assets/ai-citation/README.md

selection_rules:
  concepts: 需要理解核心概念、术语、问题求解、系统构建或复用优先原则时读取。
  philosophy: 需要思维模型、底层认知框架、编程哲学或复杂系统描述方法时读取。
  references: 需要工程模板、质量门禁、技术栈、常见坑和可执行检查清单时读取。
  research: 需要新技术、新 repo、工程趋势和采用前判断时读取。
  workflow: 需要标准开发顺序、质量门禁、版本控制和文档同步流程时读取。
  getting-started: 需要从零开始配置网络、Codex CLI、开发环境并完成最小闭环时读取。

documents:
  getting-started:
    - path: docs/getting-started/README.md
      title: 从零开始完整入门
      role: 新手线性路线、网络环境、Codex CLI、开发环境与 Vibe Coding 经验
    - path: docs/getting-started/README.md#vibe-coding-experience
      title: Vibe Coding 经验
      role: 通用语言能力、人机分工、机器门禁和入门铁律
    - path: docs/getting-started/README.md#learning-map
      title: 学习地图
      role: 新手、开发者、团队、Prompt、Skill、质量门禁和 GEO/SEO 的路线选择
    - path: docs/getting-started/README.md#network-environment
      title: 网络环境配置
      role: OpenAI、GitHub、文档和依赖源访问
    - path: docs/getting-started/README.md#cli-setup
      title: CLI 配置
      role: Codex CLI 默认路线与 OpenCode 备选路线
    - path: docs/getting-started/README.md#development-environment
      title: 开发环境搭建
      role: Agent 主动配置开发依赖、编辑器建议和测试命令
  concepts:
    - path: docs/concepts/README.md#concept-problem-solving
      title: 问题求解
      role: 目标、现状、差距、标准、约束、对象与路径
    - path: docs/concepts/README.md#concept-glue-coding
      title: 拼好码
      role: 复用成熟能力、胶水原则、能力编排与业务交付
    - path: docs/concepts/README.md#concept-system-building
      title: 系统构建方法
      role: 自顶向下、自底向上与分而治之
    - path: docs/concepts/README.md#concept-development-paradigms
      title: 开发范式演进
      role: 软件工程组织方式演进
    - path: docs/concepts/README.md#concept-language-layers
      title: 语言层要素
      role: 代码理解所需语言层级
    - path: docs/concepts/README.md#concept-recursive-self-optimizing-system
      title: 递归自优化系统
      role: 递归自优化生成系统的形式化模型
  philosophy:
    - path: docs/philosophy/README.md#philosophy-thinking-models
      title: 思维模型
      role: 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具
    - path: docs/philosophy/README.md#philosophy-compositional-description-model
      title: 组合描述模型
      role: 对象、状态、快照、序列、过程、变换、同一/差异与关系
    - path: docs/philosophy/README.md#philosophy-programming-dao
      title: 编程之道
      role: 编程哲学、结构、状态、复杂度与工程判断
    - path: docs/philosophy/README.md#philosophy-software-engineering-truths
      title: 软件工程的朴素真理
      role: 代码、复杂度、需求、维护、质量、架构和团队的工程常识
    - path: docs/philosophy/README.md#philosophy-methodology-toolbox
      title: 方法论工具箱
      role: 现象学还原、正反合、可证伪主义、形式化方法等提效工具
  references:
    - path: docs/references/README.md#reference-engineering-practice
      title: 工程实践
      role: 项目架构、代码组织、开发经验、质量门禁与常见坑
    - path: docs/references/README.md#reference-technology-stack
      title: 技术栈
      role: 技术栈选型、组合案例与学习路径
  research:
    - path: docs/research/README.md#research-harness-engineering
      title: Harness 工程解析
      role: 工程控制、评估器、反馈闭环与 AI 生成系统可靠性
    - path: docs/research/README.md#research-tmux-ai-swarm
      title: tmux 蜂群协作
      role: 用 tmux 让多个 AI 终端可感知、可调度、可救援的实验性协作范式
  workflow:
    - path: docs/workflow/README.md#workflow-development-process
      title: 开发流程
      role: 默认任务推进顺序、质量门禁和交付闭环

top_level:
  skills:
    path: skills
    purpose: 可复用 AI Skills
  prompts:
    path: prompts
    purpose: 提示词入口与提示词资产
  tools:
    path: tools
    purpose: 辅助工具、外部仓库与工具配置
  assets:
    path: assets
    purpose: 图片、模板、数据文件等静态资产