@icebreakers/monorepo-templates 1.1.0 → 1.2.0

package/templates/vitepress/.vitepress/config.ts

@@ -3,208 +3,189 @@ import { defineConfig } from 'vitepress'
 import llmstxt from 'vitepress-plugin-llms'
 import { withMermaid } from 'vitepress-plugin-mermaid'
 
-const repoctlSidebar = [
-  {
-    text: 'repoctl',
-    items: [
-      { text: '概览', link: '/repoctl/' },
-      { text: '快速开始', link: '/repoctl/getting-started' },
-      { text: '接入已有仓库', link: '/repoctl/adopt-existing' },
-      { text: '按场景选命令', link: '/repoctl/scenarios' },
-      { text: '执行模型', link: '/repoctl/execution-model' },
-      { text: '命令速查', link: '/repoctl/commands' },
-      { text: '校验链路', link: '/repoctl/checks' },
-      { text: 'doctor 诊断', link: '/repoctl/doctor' },
-      { text: '配置文件', link: '/repoctl/config' },
-      { text: '模板与创建', link: '/repoctl/templates' },
-      { text: '模板资产治理', link: '/repoctl/template-assets' },
-      { text: '工作流与 CI', link: '/repoctl/workflows' },
-      { text: '报告与自动化输出', link: '/repoctl/reports' },
-      { text: '排障与报告', link: '/repoctl/troubleshooting' },
-      { text: '命令别名', link: '/repoctl/aliases' },
-    ],
-  },
-]
+interface SidebarLabels {
+  repoctl: string
+  repoctlItems: string[]
+  knowledge: string
+  knowledgeItems: string[]
+  packages: string
+  packageItems: string[]
+  ai: string
+  aiItems: string[]
+  tools: string
+  toolItems: string[]
+}
 
-const knowledgeSidebar = [
-  {
-    text: '知识库',
-    items: [
-      { text: '知识库首页', link: '/knowledge/' },
-      { text: '为什么往 monorepo 方向演进', link: '/monorepo/' },
-      { text: '如何管理 monorepo', link: '/monorepo/manage' },
-      { text: '发包与变更日志', link: '/monorepo/publish' },
-      { text: 'monorepo 命令参考', link: '/monorepo/commands' },
-      { text: 'monorepo 模板体系', link: '/monorepo/templates' },
-      { text: 'monorepo 排障', link: '/monorepo/troubleshooting' },
-    ],
-  },
-  {
-    text: '现代 npm 包',
-    items: [
-      { text: '如何复用 js 代码', link: '/why/how-to-reuse-js-code' },
-      { text: 'JS 文件的各种后缀', link: '/why/js-cjs-mjs' },
-      { text: 'CJS 和 ESM 关键字/全局变量对比', link: '/why/js-keywords' },
-      { text: '什么是 npm 包', link: '/why/what-is-npm-package' },
-      { text: '如何发布 npm 包', link: '/why/publish-basic-npm-package' },
-      { text: '改进并发布现代 npm 包', link: '/why/index' },
-      { text: '现代包指南', link: '/why/modern/' },
-      { text: 'ESM 与 CJS', link: '/why/modern/esm-vs-cjs' },
-      { text: '类型声明', link: '/why/modern/dts' },
-      { text: '包入口', link: '/why/modern/package-entry-points' },
-      { text: '构建工具', link: '/why/modern/bundlers' },
-      { text: 'TypeScript', link: '/why/modern/typescript' },
-    ],
-  },
+const repoctlPaths = [
+  '',
+  'getting-started',
+  'adopt-existing',
+  'scenarios',
+  'execution-model',
+  'commands',
+  'checks',
+  'doctor',
+  'config',
+  'templates',
+  'template-assets',
+  'workflows',
+  'reports',
+  'troubleshooting',
+  'aliases',
 ]
-
-const aiSidebar = [
-  {
-    text: 'AI',
-    items: [
-      { text: 'AI 文档首页', link: '/ai/' },
-      { text: 'llms.txt', link: '/ai/llms-txt' },
-    ],
-  },
+const knowledgePaths = ['', 'manage', 'publish', 'commands', 'templates', 'troubleshooting']
+const packagePaths = [
+  'how-to-reuse-js-code',
+  'js-cjs-mjs',
+  'js-keywords',
+  'what-is-npm-package',
+  'publish-basic-npm-package',
+  'index',
+  'modern/',
+  'modern/esm-vs-cjs',
+  'modern/dts',
+  'modern/package-entry-points',
+  'modern/bundlers',
+  'modern/typescript',
 ]
+const aiPaths = ['', 'llms-txt']
+const toolPaths = ['', 'pnpm', 'turborepo', 'changeset', 'husky', 'lint-staged', 'renovate', 'llms-txt']
 
-const toolsSidebar = [
-  {
-    text: '工具专题',
-    items: [
-      { text: '工具专题首页', link: '/tools/' },
-      { text: 'pnpm', link: '/tools/pnpm' },
-      { text: 'turborepo', link: '/tools/turborepo' },
-      { text: 'changeset', link: '/tools/changeset' },
-      { text: 'husky', link: '/tools/husky' },
-      { text: 'lint-staged', link: '/tools/lint-staged' },
-      { text: 'renovate', link: '/tools/renovate' },
-    ],
-  },
-]
+const englishLabels: SidebarLabels = {
+  repoctl: 'repoctl',
+  repoctlItems: ['Overview', 'Getting Started', 'Adopt Existing Repos', 'Choose By Scenario', 'Execution Model', 'Command Reference', 'Verification', 'Doctor', 'Configuration', 'Templates', 'Template Assets', 'Workflows and CI', 'Reports', 'Troubleshooting', 'Command Aliases'],
+  knowledge: 'Knowledge Base',
+  knowledgeItems: ['Why Monorepo', 'Managing A Monorepo', 'Publishing and Changelogs', 'Monorepo Commands', 'Template Systems', 'Troubleshooting'],
+  packages: 'Modern Packages',
+  packageItems: ['Reusing JavaScript', 'Module Extensions', 'Runtime Globals', 'What Is An npm Package?', 'Publishing A Package', 'Package Evolution', 'Modern Package Guide', 'ESM vs CommonJS', 'Type Declarations', 'Package Entry Points', 'Bundlers', 'TypeScript'],
+  ai: 'AI',
+  aiItems: ['AI Documentation', 'llms.txt'],
+  tools: 'Tool Guides',
+  toolItems: ['Overview', 'pnpm', 'Turborepo', 'pnpm Versioning', 'Husky', 'lint-staged', 'Renovate', 'llms.txt'],
+}
 
-const enSidebar = [
-  {
-    text: 'repoctl',
-    items: [
-      { text: 'Overview', link: '/en/repoctl/' },
-      { text: 'Getting Started', link: '/en/repoctl/getting-started' },
-      { text: 'Adopt Existing Repos', link: '/en/repoctl/adopt-existing' },
-      { text: 'Choose By Scenario', link: '/en/repoctl/scenarios' },
-      { text: 'Command Reference', link: '/en/repoctl/commands' },
-      { text: 'Configuration', link: '/en/repoctl/config' },
-      { text: 'Templates', link: '/en/repoctl/templates' },
-      { text: 'Workflows and CI', link: '/en/repoctl/workflows' },
-      { text: 'Troubleshooting', link: '/en/repoctl/troubleshooting' },
-      { text: 'Command Aliases', link: '/en/repoctl/aliases' },
-    ],
-  },
-  {
-    text: 'Knowledge Base',
-    items: [
-      { text: 'Why Monorepo', link: '/en/knowledge/monorepo' },
-    ],
-  },
-]
+const chineseLabels: SidebarLabels = {
+  repoctl: 'repoctl',
+  repoctlItems: ['概览', '快速开始', '接入已有仓库', '按场景选命令', '执行模型', '命令速查', '校验链路', 'Doctor 诊断', '配置文件', '模板与创建', '模板资产治理', '工作流与 CI', '报告与自动化输出', '排障', '命令别名'],
+  knowledge: '知识库',
+  knowledgeItems: ['为什么使用 Monorepo', '管理 Monorepo', '发包与变更日志', 'Monorepo 命令', '模板体系', '常见问题排障'],
+  packages: '现代 npm 包',
+  packageItems: ['复用 JavaScript', '模块文件后缀', '运行时关键字', '什么是 npm 包', '发布 npm 包', '包的演进', '现代包指南', 'ESM 与 CommonJS', '类型声明', '包入口', '构建工具', 'TypeScript'],
+  ai: 'AI',
+  aiItems: ['AI 文档', 'llms.txt'],
+  tools: '工具专题',
+  toolItems: ['概览', 'pnpm', 'Turborepo', 'pnpm Versioning', 'Husky', 'lint-staged', 'Renovate', 'llms.txt'],
+}
+
+function prefixed(prefix: string, section: string, paths: string[], labels: string[]) {
+  return paths.map((path, index) => ({
+    text: labels[index]!,
+    link: `${prefix}/${section}/${path}`.replace(/\/+/g, '/'),
+  }))
+}
+
+function createSidebars(prefix: '' | '/zh', labels: SidebarLabels) {
+  const repoctl = [{ text: labels.repoctl, items: prefixed(prefix, 'repoctl', repoctlPaths, labels.repoctlItems) }]
+  const knowledge = [
+    { text: labels.knowledge, items: prefixed(prefix, 'monorepo', knowledgePaths, labels.knowledgeItems) },
+    { text: labels.packages, items: prefixed(prefix, 'why', packagePaths, labels.packageItems) },
+  ]
+  const ai = [{ text: labels.ai, items: prefixed(prefix, 'ai', aiPaths, labels.aiItems) }]
+  const tools = [{ text: labels.tools, items: prefixed(prefix, 'tools', toolPaths, labels.toolItems) }]
+  return {
+    [`${prefix}/repoctl/`]: repoctl,
+    [`${prefix}/knowledge/`]: knowledge,
+    [`${prefix}/monorepo/`]: knowledge,
+    [`${prefix}/why/`]: knowledge,
+    [`${prefix}/ai/`]: ai,
+    [`${prefix}/tools/`]: tools,
+    [`${prefix || ''}/`]: repoctl,
+  }
+}
 
 export default withMermaid(defineConfig({
   outDir: '.vitepress/dist',
   title: 'repoctl',
-  description: 'repoctl documentation for practical pnpm and Turborepo monorepos.',
+  description: 'Task-first CLI for initializing, maintaining, validating, and releasing pnpm and Turborepo monorepos.',
   lastUpdated: true,
   cleanUrls: true,
-  head: [
-    ['link', { rel: 'icon', href: '/logo.jpg' }],
-  ],
+  head: [['link', { rel: 'icon', href: '/logo.jpg' }]],
   themeConfig: {
     logo: '/logo.jpg',
-    search: {
-      provider: 'local',
-    },
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/sonofmagic/monorepo-template' },
-    ],
+    search: { provider: 'local' },
+    socialLinks: [{ icon: 'github', link: 'https://github.com/sonofmagic/repoctl' }],
   },
   locales: {
     root: {
-      label: '简体中文',
-      lang: 'zh-CN',
+      label: 'English',
+      lang: 'en-US',
       title: 'repoctl',
-      description: '围绕 repoctl 的 pnpm + Turborepo monorepo 使用文档。',
+      description: 'Task-first CLI for practical pnpm and Turborepo monorepos.',
       themeConfig: {
         nav: [
           { text: 'repoctl', link: '/repoctl/' },
-          { text: '快速开始', link: '/repoctl/getting-started' },
-          { text: '命令', link: '/repoctl/commands' },
-          { text: '知识库', link: '/knowledge/' },
-          { text: 'AI 文档', link: '/ai/' },
-          { text: '工具专题', link: '/tools/' },
+          { text: 'Getting Started', link: '/repoctl/getting-started' },
+          { text: 'Commands', link: '/repoctl/commands' },
+          { text: 'Knowledge Base', link: '/knowledge/' },
+          { text: 'AI Docs', link: '/ai/' },
+          { text: 'Tool Guides', link: '/tools/' },
         ],
-        outline: {
-          label: '目录',
-          level: [2, 3],
-        },
-        sidebar: {
-          '/repoctl/': repoctlSidebar,
-          '/knowledge/': knowledgeSidebar,
-          '/monorepo/': knowledgeSidebar,
-          '/why/': knowledgeSidebar,
-          '/ai/': aiSidebar,
-          '/tools/': toolsSidebar,
-          '/': repoctlSidebar,
-        },
+        outline: { label: 'On This Page', level: [2, 3] },
+        sidebar: createSidebars('', englishLabels),
         editLink: {
-          pattern: 'https://github.com/sonofmagic/monorepo-template/edit/main/templates/vitepress/:path',
-          text: '为此页提供修改建议',
-        },
-        docFooter: {
-          prev: '上一页',
-          next: '下一页',
-        },
-        lastUpdated: {
-          text: '最后更新',
+          pattern: 'https://github.com/sonofmagic/repoctl/edit/main/templates/vitepress/:path',
+          text: 'Edit this page',
         },
+        docFooter: { prev: 'Previous page', next: 'Next page' },
+        lastUpdated: { text: 'Last updated' },
       },
     },
-    en: {
-      label: 'English',
-      lang: 'en-US',
+    zh: {
+      label: '简体中文',
+      lang: 'zh-CN',
+      link: '/zh/',
       title: 'repoctl',
-      description: 'Documentation for using repoctl in practical pnpm and Turborepo monorepos.',
+      description: '面向 pnpm 与 Turborepo monorepo 的任务型 CLI。',
       themeConfig: {
         nav: [
-          { text: 'repoctl', link: '/en/repoctl/' },
-          { text: 'Getting Started', link: '/en/repoctl/getting-started' },
-          { text: 'Commands', link: '/en/repoctl/commands' },
-          { text: 'Knowledge Base', link: '/en/knowledge/monorepo' },
-          { text: 'AI Docs', link: '/ai/' },
+          { text: 'repoctl', link: '/zh/repoctl/' },
+          { text: '快速开始', link: '/zh/repoctl/getting-started' },
+          { text: '命令', link: '/zh/repoctl/commands' },
+          { text: '知识库', link: '/zh/knowledge/' },
+          { text: 'AI 文档', link: '/zh/ai/' },
+          { text: '工具专题', link: '/zh/tools/' },
         ],
-        outline: {
-          label: 'On This Page',
-          level: [2, 3],
-        },
-        sidebar: {
-          '/en/': enSidebar,
-        },
+        outline: { label: '目录', level: [2, 3] },
+        sidebar: createSidebars('/zh', chineseLabels),
         editLink: {
-          pattern: 'https://github.com/sonofmagic/monorepo-template/edit/main/templates/vitepress/:path',
-          text: 'Edit this page',
-        },
-        docFooter: {
-          prev: 'Previous page',
-          next: 'Next page',
-        },
-        lastUpdated: {
-          text: 'Last updated',
+          pattern: 'https://github.com/sonofmagic/repoctl/edit/main/templates/vitepress/:path',
+          text: '为此页提供修改建议',
         },
+        docFooter: { prev: '上一页', next: '下一页' },
+        lastUpdated: { text: '最后更新' },
       },
     },
   },
   vite: {
     plugins: [
-      // @ts-ignore
+      // @ts-ignore vitepress-plugin-llms currently exposes Vite 6 plugin types.
       Tailwindcss(),
-      llmstxt(),
+      llmstxt({
+        title: 'repoctl',
+        description: 'Task-first CLI for pnpm and Turborepo monorepos. Simplified Chinese documentation is available under /zh/.',
+        domain: 'https://repo.icebreaker.top',
+        ignoreFiles: [
+          'zh/**',
+          'en/**',
+          'CHANGELOG.md',
+          'thinking.md',
+          'why/examples/**',
+          '.vitepress/**',
+          '**/node_modules/**',
+          '**/internal/**',
+          '**/fixtures/**',
+        ],
+      }),
     ],
   },
   mermaid: {},

package/templates/vitepress/ai/index.md

@@ -1,33 +1,22 @@
 ---
-description: repoctl 文档站的 AI 文档入口，说明如何为 AI 编程工具提供 llms.txt 和页面 Markdown。
+outline: deep
 ---
 
-# AI 文档
+# AI Documentation
 
-AI 文档入口用于给 Cursor、Claude Code、Codex 和其他 AI 编程工具提供更容易读取的上下文。它和工具专题分开维护，避免 llms.txt 被埋在普通工具列表里。
+repoctl publishes AI-readable documentation alongside the human site.
 
-## 1. 推荐入口
+## Recommended Entrypoints
 
-| 入口                           | 用途                                             |
-| ------------------------------ | ------------------------------------------------ |
-| `/llms.txt`                    | 轻量文档索引，适合先交给 AI 工具判断要读哪些页面 |
-| `/llms-full.txt`               | 合并后的完整文档，适合需要一次性提供上下文的场景 |
-| [llms.txt 说明](./llms-txt.md) | 维护约定、访问方式和页面 frontmatter 要求        |
+- `/llms.txt`: compact English index and product summary.
+- `/llms-full.txt`: combined page content when a larger context is appropriate.
+- `/zh/`: Simplified Chinese documentation.
+- [llms.txt Guide](./llms-txt.md): usage and maintenance rules.
 
-## 2. 在 AI 工具里怎么用
+## Using It In AI Tools
 
-优先把 `https://repo.icebreaker.top/llms.txt` 作为入口提供给 AI 工具。只有当工具不能继续抓取链接，或者你需要离线提供完整上下文时，再使用 `https://repo.icebreaker.top/llms-full.txt`。
+Give the tool the public `llms.txt` URL first, then point it to the specific repoctl, knowledge, or tool page needed for the task. Prefer JSON CLI output when the tool needs stable structured fields.
 
-```txt
-先给 llms.txt
-  -> AI 选择相关页面
-  -> 必要时补充 llms-full.txt
-```
+## Maintenance
 
-## 3. 维护原则
-
-| 维护动作                          | 原因                                     |
-| --------------------------------- | ---------------------------------------- |
-| 新增重要页面时写 `description`    | 让 llms 索引更容易被模型理解             |
-| 页面标题保持具体                  | 避免 AI 只看到泛化标题，无法判断页面用途 |
-| repoctl、知识库、工具专题分开组织 | 让 AI 工具能按任务类型检索上下文         |
+The index is generated by the site build. Changelogs, example fixture READMEs, generated output, and internal files are excluded so the result represents current product documentation.

package/templates/vitepress/ai/llms-txt.md

@@ -1,42 +1,24 @@
 ---
-description: 使用 llms.txt 为大语言模型提供更易读取的 repoctl 文档入口。
+outline: deep
 ---
 
-# AI 文档入口：llms.txt
+# AI Entrypoint: llms.txt
 
-`llms.txt` 是面向大语言模型的文档入口文件。它把站点中的关键页面整理成更适合模型读取的 Markdown 索引，便于 AI 工具在回答 repoctl、pnpm workspace、Turborepo 和模板用法相关问题时快速定位上下文。
+The documentation build generates `/llms.txt` and `/llms-full.txt`. English is the default corpus; Chinese pages are clearly namespaced under `/zh/`.
 
-本站通过 `vitepress-plugin-llms` 在构建阶段自动生成这些文件：
+## Usage
 
-| 文件             | 用途                             |
-| ---------------- | -------------------------------- |
-| `/llms.txt`      | 文档索引，列出可供模型读取的页面 |
-| `/llms-full.txt` | 把站点文档合并成单个文本文件     |
-| 页面 `.md` 文件  | 保留每个页面内容的 Markdown 版本 |
-
-## 1. 使用方式
-
-访问 `https://repo.icebreaker.top/llms.txt` 可以获取当前文档的 LLM 索引。如果需要一次性提供完整上下文，可以使用 `https://repo.icebreaker.top/llms-full.txt`。
-
-当你在 Cursor、Claude Code、Codex 或其他 AI 编程工具里引用 repoctl 文档时，优先提供 `llms.txt`，再按需要补充具体页面链接。
-
-## 2. 维护约定
+```text
+https://repo.icebreaker.top/llms.txt
+https://repo.icebreaker.top/llms-full.txt
+```
 
-新增重要文档页面时，在 frontmatter 中补充 `description`。构建插件会把描述写入 `llms.txt` 的链接说明中，让模型更容易判断每个页面的用途。
+Use the compact index for discovery and the full file only when the consumer has enough context budget.
 
-```md
----
-description: 说明这个页面解决的问题和适用场景。
----
-```
+## Scope
 
-## 3. 页面组织建议
+The generated index includes current product guides, package roles, commands, reports, template assets, knowledge pages, and tool topics. Historical changelogs, example fixture READMEs, generated build output, and internal maintenance files are excluded.
 
-AI 入口应该保持显眼，但不要替代正常文档结构：
+## Language
 
-| 页面类型                               | 推荐位置                             |
-| -------------------------------------- | ------------------------------------ |
-| repoctl 命令、校验、诊断、报告         | `/repoctl/`                          |
-| monorepo 和 npm 包基础知识             | `/knowledge/`、`/monorepo/`、`/why/` |
-| pnpm、Turborepo、versioning 等工具专题 | `/tools/`                            |
-| llms.txt 和 AI 工具读取约定            | `/ai/`                               |
+English URLs use the site root. Simplified Chinese pages use `/zh/`; this mirrors the CLI default and `--lang zh-CN` opt-in behavior.

package/templates/vitepress/getting-started.md

@@ -1,40 +1,11 @@
-# 新手使用指南
+# Getting Started
 
-这篇旧入口已经收敛到 repoctl 主线。新读者建议直接阅读：
-
-- [repoctl 快速开始](./repoctl/getting-started.md)
-- [repoctl 命令速查](./repoctl/commands.md)
-- [repoctl 配置文件](./repoctl/config.md)
-
-## 先这样用
+The current setup guide is [repoctl Getting Started](./repoctl/getting-started.md).
 
 ```bash
 pnpm add -D repoctl
 pnpm exec repo init
 pnpm exec repo doctor
-pnpm exec repo new
-pnpm exec repo check
 ```
 
-模板生成仓库里可以使用更短的根脚本：
-
-```bash
-pnpm run repo:init
-pnpm doctor
-pnpm new
-pnpm check
-```
-
-## 知识点保留
-
-理解工具前，先理解这几个边界：
-
-| 命令           | 解决的问题                                            |
-| -------------- | ----------------------------------------------------- |
-| `repo init`    | 补齐仓库默认脚本、workspace patterns 和基础工具链入口 |
-| `repo doctor`  | 判断仓库当前是否可用，并输出可保存的诊断报告          |
-| `repo new`     | 从内置模板创建包、应用、服务、文档站或 CLI            |
-| `repo check`   | 预览或执行提交前推荐校验                              |
-| `repo upgrade` | 同步模板最新标准资产                                  |
-
-如果你是在学习 monorepo 的基础概念，可以继续看 [为什么往 monorepo 方向演进](./monorepo/index.md)。
+Use [Adopt Existing Repositories](./repoctl/adopt-existing.md) when introducing repoctl to an established workspace.

package/templates/vitepress/index.md

@@ -3,34 +3,34 @@ layout: home
 
 hero:
   name: repoctl
-  text: 让 pnpm monorepo 的日常操作更短、更稳
-  tagline: 用一套 CLI 管理初始化、诊断、创建模板、提交前校验和模板资产同步。
+  text: Short, stable workflows for pnpm monorepos
+  tagline: Initialize, diagnose, scaffold, verify, and upgrade practical Turborepo workspaces from one CLI.
   image:
     src: /logo.jpg
     alt: repoctl logo
   actions:
     - theme: brand
-      text: 快速开始
+      text: Get Started
       link: /repoctl/getting-started
     - theme: alt
-      text: 命令速查
+      text: Commands
       link: /repoctl/commands
     - theme: alt
-      text: AI 文档入口
+      text: AI Docs
       link: /ai/
 
 features:
-  - title: 从已有仓库开始
-    details: 安装 repoctl 后运行 setup 和 doctor，先把 workspace、根脚本、配置冲突和提交链路检查清楚。
-  - title: 用模板创建包和应用
-    details: repo new 支持交互式创建、指定模板、dry-run、JSON 输出和创建计划落盘。
-  - title: 把质量门禁变成日常命令
-    details: repo check 统一预览和执行 lint、typecheck、build、test、tsd 等推荐校验。
-  - title: 给 AI 工具的文档入口
-    details: 构建时自动生成 llms.txt、llms-full.txt 和页面 Markdown，让 AI 编程工具更容易读取 repoctl 文档。
+  - title: Adopt existing workspaces
+    details: Run setup and doctor to align workspace patterns, root scripts, config files, and commit hooks.
+  - title: Create packages and apps
+    details: Scaffold libraries, apps, services, docs, and CLIs with interactive prompts or explicit template keys.
+  - title: Make checks repeatable
+    details: Preview and run local verification plans that match your lint, typecheck, build, test, and tsd workflow.
+  - title: AI-readable documentation
+    details: Generate llms.txt, llms-full.txt, and Markdown page output so AI coding tools can read the repoctl docs directly.
 ---
 
-## 最短路径
+## Fast Path
 
 ```bash
 pnpm add -D repoctl
@@ -40,7 +40,7 @@ pnpm exec repo new
 pnpm exec repo check
 ```
 
-在由模板生成的仓库里，同一套工作流会暴露成更短的根脚本：
+Generated repositories expose the same workflow as shorter root scripts:
 
 ```bash
 pnpm run repo:init
@@ -49,18 +49,15 @@ pnpm run repo:new
 pnpm run repo:check
 ```
 
-## 你可以继续阅读
-
-- [repoctl 概览](./repoctl/index.md)
-- [快速开始](./repoctl/getting-started.md)
-- [接入已有仓库](./repoctl/adopt-existing.md)
-- [按场景选命令](./repoctl/scenarios.md)
-- [执行模型](./repoctl/execution-model.md)
-- [命令速查](./repoctl/commands.md)
-- [校验链路](./repoctl/checks.md)
-- [doctor 诊断](./repoctl/doctor.md)
-- [配置文件](./repoctl/config.md)
-- [模板与创建](./repoctl/templates.md)
-- [模板资产治理](./repoctl/template-assets.md)
-- [工作流与 CI](./repoctl/workflows.md)
-- [报告与自动化输出](./repoctl/reports.md)
+## Keep Reading
+
+- [repoctl Overview](./repoctl/index.md)
+- [Getting Started](./repoctl/getting-started.md)
+- [Adopt Existing Repositories](./repoctl/adopt-existing.md)
+- [Choose By Scenario](./repoctl/scenarios.md)
+- [Command Reference](./repoctl/commands.md)
+- [Configuration](./repoctl/config.md)
+- [Templates](./repoctl/templates.md)
+- [Workflows and CI](./repoctl/workflows.md)
+- [AI Docs: llms.txt](./ai/llms-txt.md)
+- [Knowledge Base](./knowledge/index.md)