redirects:
  # Legacy directory moves.
  - from: docs/guides/getting-started/
    to: docs/getting-started/
  - from: docs/principles/fundamentals/
    to: docs/README.md
  - from: docs/principles/philosophy/
    to: docs/philosophy/
  - from: docs/concepts/philosophy/
    to: docs/philosophy/
  - from: docs/research/
    to: research/
  - from: Workflow/
    to: docs/workflow/

  # Merged concept documents.
  - from: docs/concepts/思维模型.md
    to: docs/philosophy/thinking-models.md
  - from: docs/concepts/编程之道.md
    to: docs/philosophy/programming-dao.md
  - from: docs/concepts/A Formalization of Recursive Self-Optimizing Generative Systems.md
    to: docs/concepts/recursive-self-optimizing-system.md
  - from: docs/concepts/软件开发范式演进.md
    to: docs/concepts/development-paradigms.md
  - from: docs/concepts/递归自优化生成系统形式化.md
    to: docs/concepts/recursive-self-optimizing-system.md
  - from: docs/concepts/问题分析与系统构建方法.md
    to: docs/concepts/system-building.md
  - from: docs/concepts/问题求解能力.md
    to: docs/concepts/problem-solving.md
  - from: docs/concepts/Harness Engineering 的本质拆解.md
    to: research/harness/harness-engineering.md
  - from: docs/research/Harness Engineering 的本质拆解.md
    to: research/harness/harness-engineering.md
  - from: docs/research/harness-engineering.md
    to: research/harness/harness-engineering.md
  - from: docs/philosophy/现象学还原.md
    to: docs/philosophy/methodology-toolbox.md
  - from: docs/philosophy/辩证法.md
    to: docs/philosophy/methodology-toolbox.md
  - from: docs/philosophy/控制论与科学方法论.md
    to: docs/philosophy/methodology-toolbox.md
  - from: docs/philosophy/理解世界、描述变化、整理知识的一套较小框架.md
    to: docs/philosophy/compositional-description-model.md

  # Removed playbook directories and documents.
  - from: docs/guides/playbook/
    to: docs/README.md
  - from: docs/playbooks/
    to: docs/README.md
  - from: docs/playbooks/GEO与SEO优化方法.md
    to: assets/ai-citation/geo-seo-checklist.md
  - from: docs/playbooks/GEMINI-HEADLESS.md
    to: docs/README.md
  - from: docs/playbooks/ProxyCast配置文档.md
    to: docs/README.md
  - from: docs/playbooks/tradecat-sheets-api-usage.md
    to: docs/README.md

  # Merged getting-started documents.
  - from: docs/getting-started/Codex-CLI配置.md
    to: docs/getting-started/cli-setup.md
  - from: docs/getting-started/学习地图.md
    to: docs/getting-started/learning-map.md
  - from: docs/getting-started/Vibe Coding 经验.md
    to: docs/getting-started/vibe-coding-experience.md
  - from: docs/getting-started/网络环境配置.md
    to: docs/getting-started/network-environment.md
  - from: docs/getting-started/CLI配置.md
    to: docs/getting-started/cli-setup.md
  - from: docs/getting-started/开发环境搭建.md
    to: docs/getting-started/development-environment.md

  # Split reference documents.
  - from: docs/references/通用项目架构模板.md
    to: docs/references/project-architecture-template.md
  - from: docs/references/数据集导向数据服务模板.md
    to: docs/references/dataset-first-data-service.md
  - from: docs/references/系统提示词构建原则.md
    to: docs/references/quality-gates-and-pitfalls.md
  - from: docs/references/强前置条件约束.md
    to: docs/references/quality-gates-and-pitfalls.md
  - from: docs/references/常见坑汇总.md
    to: docs/references/quality-gates-and-pitfalls.md
  - from: docs/references/项目架构模板.md
    to: docs/references/project-architecture-template.md
  - from: docs/references/AI编程质量门禁与常见坑.md
    to: docs/references/quality-gates-and-pitfalls.md
  - from: docs/references/代码组织.md
    to: docs/references/code-organization.md
  - from: docs/references/开发经验.md
    to: docs/references/development-experience.md
  - from: docs/references/底层程序逻辑设计与工程优化项.md
    to: docs/references/low-level-program-logic.md

  # Moved top-level resource directories.
  - from: assets/documents/
    to: docs/
  - from: assets/skills/
    to: skills/
  - from: assets/prompt/
    to: prompts/
  - from: assets/repos/
    to: tools/external/
  - from: assets/config/
    to: tools/config/

  # Stable legacy per-topic entry points.
  - from: docs/concepts/问题求解.md
    to: docs/concepts/problem-solving.md
  - from: docs/concepts/拼好码.md
    to: docs/concepts/glue-coding.md
  - from: docs/concepts/系统构建方法.md
    to: docs/concepts/system-building.md
  - from: docs/concepts/开发范式演进.md
    to: docs/concepts/development-paradigms.md
  - from: docs/concepts/语言层要素.md
    to: docs/concepts/language-layers.md
  - from: docs/concepts/递归自优化系统.md
    to: docs/concepts/recursive-self-optimizing-system.md
  - from: docs/philosophy/思维模型.md
    to: docs/philosophy/thinking-models.md
  - from: docs/philosophy/道法术器.md
    to: README.md#dao-fa-shu-qi
  - from: docs/philosophy/组合描述模型.md
    to: docs/philosophy/compositional-description-model.md
  - from: docs/philosophy/编程之道.md
    to: docs/philosophy/programming-dao.md
  - from: docs/references/工程实践.md
    to: docs/references/project-architecture-template.md
  - from: docs/references/技术栈.md
    to: docs/references/technology-stack.md
  - from: docs/research/Harness工程解析.md
    to: research/harness/harness-engineering.md