@icebreakers/monorepo-templates 1.0.3 → 1.0.5

package/assets/package.json

@@ -37,33 +37,23 @@
     "commit": "commit",
     "commitlint": "commitlint --edit",
     "-------": "---------------",
-    "setup": "repo setup",
-    "new": "repo new",
-    "check": "repo check",
-    "doctor": "repo doctor",
-    "sync": "repo sync",
-    "clean:repo": "repo clean",
-    "mirror": "repo mirror",
+    "repo:init": "repo init",
+    "repo:new": "repo new",
+    "repo:check": "repo check",
+    "repo:doctor": "repo doctor",
     "------simple": "--------------",
     "pr:alpha": "repo release pre enter alpha",
     "pr:beta": "repo release pre enter beta",
     "pr:rc": "repo release pre enter rc",
     "pr:next": "repo release pre enter next",
     "pr:exit": "repo release pre exit",
-    "--------": "----------------",
-    "script:init": "repo init",
-    "script:sync": "repo sync",
-    "script:clean": "repo clean",
-    "script:mirror": "repo mirror"
+    "--------": "----------------"
   },
   "devDependencies": {
     "@changesets/cli": "^2.31.0",
     "@commitlint/cli": "^20.5.3",
     "@icebreakers/changelog-github": "^1.0.2",
-    "@icebreakers/commitlint-config": "^2.0.0",
-    "@icebreakers/eslint-config": "^4.0.10",
     "@icebreakers/monorepo": "workspace:*",
-    "@icebreakers/stylelint-config": "^3.0.6",
     "@types/node": "^25.6.0",
     "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "~4.1.5",
@@ -81,7 +71,7 @@
     "stylelint": "^17.11.0",
     "tailwindcss": "^4.2.4",
     "tsd": "^0.33.0",
-    "tsdown": "0.21.10",
+    "tsdown": "0.22.0",
     "tslib": "^2.8.1",
     "tsx": "^4.21.0",
     "turbo": "^2.9.9",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Template assets for icebreaker monorepo scaffolding",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",

package/templates/cli/package.json

@@ -29,7 +29,7 @@
     "consola": "^3.4.2"
   },
   "devDependencies": {
-    "tsdown": "0.21.10"
+    "tsdown": "0.22.0"
   },
   "publishConfig": {
     "bin": {

package/templates/client/package.json

@@ -30,7 +30,7 @@
     "vue-router": "^5.0.6"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.36.0",
+    "@cloudflare/vite-plugin": "^1.36.2",
     "@hono/node-server": "^2.0.1",
     "@hono/trpc-server": "^0.4.2",
     "@tailwindcss/vite": "^4.2.4",
@@ -42,11 +42,11 @@
     "hono": "^4.12.18",
     "tailwindcss": "^4.2.4",
     "typescript": "~6.0.3",
-    "vite": "^8.0.10",
+    "vite": "^8.0.11",
     "vite-plugin-vue-devtools": "^8.1.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.2.8",
-    "wrangler": "^4.88.0",
+    "wrangler": "^4.89.1",
     "zod": "^4.4.3"
   }
 }

package/templates/client/vite.config.ts

@@ -1,3 +1,4 @@
+import type { PluginOption, UserConfig } from 'vite'
 import path from 'node:path'
 import { cloudflare } from '@cloudflare/vite-plugin'
 import Tailwindcss from '@tailwindcss/vite'
@@ -8,27 +9,32 @@ import VueDevTools from 'vite-plugin-vue-devtools'
 import VueRouter from 'vue-router/vite'
 
 // https://vite.dev/config/
-export default defineConfig(({ command }) => ({
-  build: {
-    target: 'baseline-widely-available',
-  },
-  resolve: {
-    alias: {
-      '@': path.resolve(import.meta.dirname, 'src'),
-      '~': import.meta.dirname,
-    },
-  },
-  plugins: [
-    VueRouter(
-      {
-        dts: path.resolve(import.meta.dirname, 'src/route-map.d.ts'),
-        watch: command === 'serve',
-      },
-    ),
+export default defineConfig(({ command }): UserConfig => {
+  const plugins: PluginOption[] = [
+    VueRouter({
+      dts: path.resolve(import.meta.dirname, 'src/route-map.d.ts'),
+      watch: command === 'serve',
+    }) as PluginOption,
     Vue(),
     VueJsx(),
     Tailwindcss(),
-    cloudflare(),
-    command === 'serve' ? VueDevTools() : null,
-  ],
-}))
+    cloudflare() as unknown as PluginOption,
+  ]
+
+  if (command === 'serve') {
+    plugins.push(VueDevTools() as unknown as PluginOption)
+  }
+
+  return {
+    build: {
+      target: 'baseline-widely-available',
+    },
+    resolve: {
+      alias: {
+        '@': path.resolve(import.meta.dirname, 'src'),
+        '~': import.meta.dirname,
+      },
+    },
+    plugins,
+  }
+})

package/templates/client/worker-configuration.d.ts

@@ -1,6 +1,6 @@
 /* eslint-disable */
 // Generated by Wrangler by running `wrangler types` (hash: fa12f52f057b37f671438ff56acffa6e)
-// Runtime types generated with workerd@1.20260504.1 2025-10-16 nodejs_compat
+// Runtime types generated with workerd@1.20260507.1 2025-10-16 nodejs_compat
 declare namespace Cloudflare {
 	interface GlobalProps {
 		mainModule: typeof import("./worker/fetch-entry");
@@ -913,7 +913,7 @@ interface CustomEventCustomEventInit {
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob)
  */
 declare class Blob {
-    constructor(type?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[], options?: BlobOptions);
+    constructor(bits?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[], options?: BlobOptions);
     /**
      * The **`size`** read-only property of the Blob interface returns the size of the Blob or File in bytes.
      *
@@ -12073,13 +12073,13 @@ declare namespace Cloudflare {
     type GlobalProp<K extends string, Default> = K extends keyof GlobalProps ? GlobalProps[K] : Default;
     // The type of the program's main module exports, if known. Requires `GlobalProps` to declare the
     // `mainModule` property.
-    type MainModule = GlobalProp<'mainModule', {}>;
+    type MainModule = GlobalProp<"mainModule", {}>;
     // The type of ctx.exports, which contains loopback bindings for all top-level exports.
     type Exports = {
-        [K in keyof MainModule]: LoopbackForExport<MainModule[K]> & 
+        [K in keyof MainModule]: LoopbackForExport<MainModule[K]>
         // If the export is listed in `durableNamespaces`, then it is also a
         // DurableObjectNamespace.
-        (K extends GlobalProp<'durableNamespaces', never> ? MainModule[K] extends new (...args: any[]) => infer DoInstance ? DoInstance extends Rpc.DurableObjectBranded ? DurableObjectNamespace<DoInstance> : DurableObjectNamespace<undefined> : DurableObjectNamespace<undefined> : {});
+         & (K extends GlobalProp<"durableNamespaces", never> ? MainModule[K] extends new (...args: any[]) => infer DoInstance ? DoInstance extends Rpc.DurableObjectBranded ? DurableObjectNamespace<DoInstance> : DurableObjectNamespace<undefined> : DurableObjectNamespace<undefined> : {});
     };
 }
 declare namespace CloudflareWorkersModule {
@@ -12150,24 +12150,15 @@ declare namespace CloudflareWorkersModule {
         attempt: number;
         config: WorkflowStepConfig;
     };
-    export interface RollbackContext<T> {
-        error: Error;
-        output: NonNullable<T> | undefined;
-        stepName: string;
-    }
-    export interface StepPromise<T> extends Promise<T> {
-        rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-        rollback(config: WorkflowStepConfig, fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    }
     export abstract class WorkflowStep {
-        do<T extends Rpc.Serializable<T>>(name: string, callback: (ctx: WorkflowStepContext) => Promise<T>): StepPromise<T>;
-        do<T extends Rpc.Serializable<T>>(name: string, config: WorkflowStepConfig, callback: (ctx: WorkflowStepContext) => Promise<T>): StepPromise<T>;
+        do<T extends Rpc.Serializable<T>>(name: string, callback: (ctx: WorkflowStepContext) => Promise<T>): Promise<T>;
+        do<T extends Rpc.Serializable<T>>(name: string, config: WorkflowStepConfig, callback: (ctx: WorkflowStepContext) => Promise<T>): Promise<T>;
         sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
         sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
         waitForEvent<T extends Rpc.Serializable<T>>(name: string, options: {
             type: string;
             timeout?: WorkflowTimeoutDuration | number;
-        }): StepPromise<WorkflowStepEvent<T>>;
+        }): Promise<WorkflowStepEvent<T>>;
     }
     export type WorkflowInstanceStatus = 'queued' | 'running' | 'paused' | 'errored' | 'terminated' | 'complete' | 'waiting' | 'waitingForPause' | 'unknown';
     export abstract class WorkflowEntrypoint<Env = unknown, T extends Rpc.Serializable<T> | unknown = unknown> implements Rpc.WorkflowEntrypointBranded {

package/templates/server/package.json

@@ -57,8 +57,8 @@
     "@hono/node-server": "^2.0.1",
     "consola": "^3.4.2",
     "hono": "^4.12.18",
-    "tsdown": "0.21.10",
-    "wrangler": "^4.88.0",
+    "tsdown": "0.22.0",
+    "wrangler": "^4.89.1",
     "zod": "^4.4.3"
   }
 }

package/templates/server/worker-configuration.d.ts

@@ -1,6 +1,6 @@
 /* eslint-disable */
 // Generated by Wrangler by running `wrangler types` (hash: fd577b1f4edd34e8f40cee5b4eab2eb5)
-// Runtime types generated with workerd@1.20260504.1 2025-10-16 nodejs_compat
+// Runtime types generated with workerd@1.20260507.1 2025-10-16 nodejs_compat
 declare namespace Cloudflare {
 	interface GlobalProps {
 		mainModule: typeof import("./src/fetch-entry");
@@ -913,7 +913,7 @@ interface CustomEventCustomEventInit {
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob)
  */
 declare class Blob {
-    constructor(type?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[], options?: BlobOptions);
+    constructor(bits?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[], options?: BlobOptions);
     /**
      * The **`size`** read-only property of the Blob interface returns the size of the Blob or File in bytes.
      *
@@ -12073,13 +12073,13 @@ declare namespace Cloudflare {
     type GlobalProp<K extends string, Default> = K extends keyof GlobalProps ? GlobalProps[K] : Default;
     // The type of the program's main module exports, if known. Requires `GlobalProps` to declare the
     // `mainModule` property.
-    type MainModule = GlobalProp<'mainModule', {}>;
+    type MainModule = GlobalProp<"mainModule", {}>;
     // The type of ctx.exports, which contains loopback bindings for all top-level exports.
     type Exports = {
-        [K in keyof MainModule]: LoopbackForExport<MainModule[K]> & 
+        [K in keyof MainModule]: LoopbackForExport<MainModule[K]>
         // If the export is listed in `durableNamespaces`, then it is also a
         // DurableObjectNamespace.
-        (K extends GlobalProp<'durableNamespaces', never> ? MainModule[K] extends new (...args: any[]) => infer DoInstance ? DoInstance extends Rpc.DurableObjectBranded ? DurableObjectNamespace<DoInstance> : DurableObjectNamespace<undefined> : DurableObjectNamespace<undefined> : {});
+         & (K extends GlobalProp<"durableNamespaces", never> ? MainModule[K] extends new (...args: any[]) => infer DoInstance ? DoInstance extends Rpc.DurableObjectBranded ? DurableObjectNamespace<DoInstance> : DurableObjectNamespace<undefined> : DurableObjectNamespace<undefined> : {});
     };
 }
 declare namespace CloudflareWorkersModule {
@@ -12150,24 +12150,15 @@ declare namespace CloudflareWorkersModule {
         attempt: number;
         config: WorkflowStepConfig;
     };
-    export interface RollbackContext<T> {
-        error: Error;
-        output: NonNullable<T> | undefined;
-        stepName: string;
-    }
-    export interface StepPromise<T> extends Promise<T> {
-        rollback(fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-        rollback(config: WorkflowStepConfig, fn: (ctx: RollbackContext<T>) => Promise<void>): StepPromise<T>;
-    }
     export abstract class WorkflowStep {
-        do<T extends Rpc.Serializable<T>>(name: string, callback: (ctx: WorkflowStepContext) => Promise<T>): StepPromise<T>;
-        do<T extends Rpc.Serializable<T>>(name: string, config: WorkflowStepConfig, callback: (ctx: WorkflowStepContext) => Promise<T>): StepPromise<T>;
+        do<T extends Rpc.Serializable<T>>(name: string, callback: (ctx: WorkflowStepContext) => Promise<T>): Promise<T>;
+        do<T extends Rpc.Serializable<T>>(name: string, config: WorkflowStepConfig, callback: (ctx: WorkflowStepContext) => Promise<T>): Promise<T>;
         sleep: (name: string, duration: WorkflowSleepDuration) => Promise<void>;
         sleepUntil: (name: string, timestamp: Date | number) => Promise<void>;
         waitForEvent<T extends Rpc.Serializable<T>>(name: string, options: {
             type: string;
             timeout?: WorkflowTimeoutDuration | number;
-        }): StepPromise<WorkflowStepEvent<T>>;
+        }): Promise<WorkflowStepEvent<T>>;
     }
     export type WorkflowInstanceStatus = 'queued' | 'running' | 'paused' | 'errored' | 'terminated' | 'complete' | 'waiting' | 'waitingForPause' | 'unknown';
     export abstract class WorkflowEntrypoint<Env = unknown, T extends Rpc.Serializable<T> | unknown = unknown> implements Rpc.WorkflowEntrypointBranded {

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

@@ -1,5 +1,6 @@
 import Tailwindcss from '@tailwindcss/vite'
 import { defineConfig } from 'vitepress'
+import llmstxt from 'vitepress-plugin-llms'
 import { withMermaid } from 'vitepress-plugin-mermaid'
 
 const repoctlSidebar = [
@@ -10,31 +11,68 @@ const repoctlSidebar = [
       { 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' },
     ],
   },
+]
+
+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 aiSidebar = [
+  {
+    text: 'AI',
+    items: [
+      { text: 'AI 文档首页', link: '/ai/' },
+      { text: 'llms.txt', link: '/ai/llms-txt' },
     ],
   },
+]
+
+const toolsSidebar = [
   {
     text: '工具专题',
     items: [
+      { text: '工具专题首页', link: '/tools/' },
       { text: 'pnpm', link: '/tools/pnpm' },
       { text: 'turborepo', link: '/tools/turborepo' },
       { text: 'changeset', link: '/tools/changeset' },
@@ -98,14 +136,21 @@ export default withMermaid(defineConfig({
           { text: 'repoctl', link: '/repoctl/' },
           { text: '快速开始', link: '/repoctl/getting-started' },
           { text: '命令', link: '/repoctl/commands' },
-          { text: '知识库', link: '/monorepo/' },
-          { text: '工具专题', link: '/tools/turborepo' },
+          { text: '知识库', link: '/knowledge/' },
+          { text: 'AI 文档', link: '/ai/' },
+          { text: '工具专题', link: '/tools/' },
         ],
         outline: {
           label: '目录',
           level: [2, 3],
         },
         sidebar: {
+          '/repoctl/': repoctlSidebar,
+          '/knowledge/': knowledgeSidebar,
+          '/monorepo/': knowledgeSidebar,
+          '/why/': knowledgeSidebar,
+          '/ai/': aiSidebar,
+          '/tools/': toolsSidebar,
           '/': repoctlSidebar,
         },
         editLink: {
@@ -132,6 +177,7 @@ export default withMermaid(defineConfig({
           { 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/' },
         ],
         outline: {
           label: 'On This Page',
@@ -158,6 +204,7 @@ export default withMermaid(defineConfig({
     plugins: [
       // @ts-ignore
       Tailwindcss(),
+      llmstxt(),
     ],
   },
   mermaid: {},

package/templates/vitepress/ai/index.md

@@ -0,0 +1,33 @@
+---
+description: repoctl 文档站的 AI 文档入口，说明如何为 AI 编程工具提供 llms.txt 和页面 Markdown。
+---
+
+# AI 文档
+
+AI 文档入口用于给 Cursor、Claude Code、Codex 和其他 AI 编程工具提供更容易读取的上下文。它和工具专题分开维护，避免 llms.txt 被埋在普通工具列表里。
+
+## 1. 推荐入口
+
+| 入口                           | 用途                                             |
+| ------------------------------ | ------------------------------------------------ |
+| `/llms.txt`                    | 轻量文档索引，适合先交给 AI 工具判断要读哪些页面 |
+| `/llms-full.txt`               | 合并后的完整文档，适合需要一次性提供上下文的场景 |
+| [llms.txt 说明](./llms-txt.md) | 维护约定、访问方式和页面 frontmatter 要求        |
+
+## 2. 在 AI 工具里怎么用
+
+优先把 `https://repo.icebreaker.top/llms.txt` 作为入口提供给 AI 工具。只有当工具不能继续抓取链接，或者你需要离线提供完整上下文时，再使用 `https://repo.icebreaker.top/llms-full.txt`。
+
+```txt
+先给 llms.txt
+  -> AI 选择相关页面
+  -> 必要时补充 llms-full.txt
+```
+
+## 3. 维护原则
+
+| 维护动作                          | 原因                                     |
+| --------------------------------- | ---------------------------------------- |
+| 新增重要页面时写 `description`    | 让 llms 索引更容易被模型理解             |
+| 页面标题保持具体                  | 避免 AI 只看到泛化标题，无法判断页面用途 |
+| repoctl、知识库、工具专题分开组织 | 让 AI 工具能按任务类型检索上下文         |

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

@@ -0,0 +1,42 @@
+---
+description: 使用 llms.txt 为大语言模型提供更易读取的 repoctl 文档入口。
+---
+
+# AI 文档入口：llms.txt
+
+`llms.txt` 是面向大语言模型的文档入口文件。它把站点中的关键页面整理成更适合模型读取的 Markdown 索引，便于 AI 工具在回答 repoctl、pnpm workspace、Turborepo 和模板用法相关问题时快速定位上下文。
+
+本站通过 `vitepress-plugin-llms` 在构建阶段自动生成这些文件：
+
+| 文件             | 用途                             |
+| ---------------- | -------------------------------- |
+| `/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. 维护约定
+
+新增重要文档页面时，在 frontmatter 中补充 `description`。构建插件会把描述写入 `llms.txt` 的链接说明中，让模型更容易判断每个页面的用途。
+
+```md
+---
+description: 说明这个页面解决的问题和适用场景。
+---
+```
+
+## 3. 页面组织建议
+
+AI 入口应该保持显眼，但不要替代正常文档结构：
+
+| 页面类型                              | 推荐位置                             |
+| ------------------------------------- | ------------------------------------ |
+| repoctl 命令、校验、诊断、报告        | `/repoctl/`                          |
+| monorepo 和 npm 包基础知识            | `/knowledge/`、`/monorepo/`、`/why/` |
+| pnpm、Turborepo、changeset 等工具专题 | `/tools/`                            |
+| llms.txt 和 AI 工具读取约定           | `/ai/`                               |

package/templates/vitepress/en/index.md

@@ -15,6 +15,9 @@ hero:
     - theme: alt
       text: Commands
       link: /en/repoctl/commands
+    - theme: alt
+      text: AI Docs
+      link: /ai/
 
 features:
   - title: Adopt existing workspaces
@@ -23,13 +26,15 @@ features:
     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
-pnpm exec repo setup
+pnpm exec repo init
 pnpm exec repo doctor
 pnpm exec repo new
 pnpm exec repo check
@@ -38,10 +43,10 @@ pnpm exec repo check
 Generated repositories expose the same workflow as shorter root scripts:
 
 ```bash
-pnpm setup
-pnpm doctor
-pnpm new
-pnpm check
+pnpm run repo:init
+pnpm run repo:doctor
+pnpm run repo:new
+pnpm run repo:check
 ```
 
 ## Keep Reading
@@ -54,4 +59,5 @@ pnpm check
 - [Configuration](./repoctl/config.md)
 - [Templates](./repoctl/templates.md)
 - [Workflows and CI](./repoctl/workflows.md)
+- [AI Docs: llms.txt](../ai/llms-txt.md)
 - [Knowledge Base: Why Monorepo](./knowledge/monorepo.md)

package/templates/vitepress/en/knowledge/monorepo.md

@@ -24,7 +24,7 @@ pnpm handles workspace dependencies. Turborepo coordinates tasks and caching. To
 
 repoctl adds the missing workflow layer:
 
-- `repo setup` aligns root scripts and standard files.
+- `repo init` aligns root scripts and standard files.
 - `repo doctor` checks whether the workspace is ready.
 - `repo new` creates packages and apps from known templates.
 - `repo check` previews and runs local verification.

package/templates/vitepress/en/repoctl/adopt-existing.md

@@ -9,7 +9,7 @@ A repository is a good fit when:
 - It already uses pnpm, or is ready to move to pnpm.
 - It has a root `package.json`.
 - It can use workspace folders such as `apps/*`, `packages/*`, or `examples/*`.
-- The team wants stable daily entries such as `setup`, `doctor`, `new`, and `check`.
+- The team wants stable daily entries such as `repo:init`, `repo:doctor`, `repo:new`, and `repo:check`.
 
 If the repository is not yet a pnpm workspace, start with a minimal `pnpm-workspace.yaml`:
 
@@ -23,10 +23,10 @@ packages:
 
 ```bash
 pnpm add -D repoctl
-pnpm exec repo setup --yes
+pnpm exec repo init --yes
 ```
 
-`setup --yes` uses safe defaults. It adds recommended scripts and workspace patterns, but it does not blindly overwrite existing README, package.json, pnpm-workspace.yaml, or tooling files.
+`repo init --yes` uses safe defaults. It adds recommended scripts and workspace patterns, but it does not blindly overwrite existing README, package.json, pnpm-workspace.yaml, or tooling files.
 
 ## Step 2: Save The First Diagnostic Report
 
@@ -45,8 +45,8 @@ Watch these checks:
 | `workspace-manifest`         | `pnpm-workspace.yaml` is missing                                  |
 | `node-version`               | Root package has no `engines.node`, or the version does not match |
 | `tool-package`               | `repoctl` is not installed                                        |
-| `root-scripts`               | `setup/new/check/doctor` scripts are missing                      |
-| `config-file`                | `repoctl.config.ts` and `monorepo.config.ts` coexist              |
+| `root-scripts`               | `repo:init/repo:new/repo:check/repo:doctor` scripts are missing   |
+| `config-file`                | A stale `monorepo.config.ts` file is still present                |
 | `commit-hooks`               | Husky and lint-staged are only partially configured               |
 | `workspace-package-coverage` | Some package.json files are not covered by workspace patterns     |
 
@@ -71,12 +71,12 @@ Review the plan before wiring hooks or CI.
 
 ## Step 5: Use Root Scripts
 
-After `setup`, team docs can use:
+After `repo init`, team docs can use:
 
 ```bash
-pnpm doctor
-pnpm new
-pnpm check
+pnpm run repo:doctor
+pnpm run repo:new -- sdk
+pnpm run repo:check
 ```
 
 CI and automation should still prefer explicit commands:
@@ -96,7 +96,7 @@ Keep only:
 repoctl.config.ts
 ```
 
-`monorepo.config.ts` is for compatibility with older projects.
+`monorepo.config.ts` is no longer loaded at runtime; rename it to `repoctl.config.ts`.
 
 ### Local Tooling Loader
 
@@ -106,12 +106,14 @@ If `doctor` reports local source tooling loaders, migrate with:
 pnpm exec repo upgrade --yes
 ```
 
+The same migration also converts simple wrappers from `@icebreakers/commitlint-config`, `@icebreakers/eslint-config`, and `@icebreakers/stylelint-config` to `repoctl/tooling`. Complex ESLint configs keep their rules, ignores, overrides, and extra flat config semantics.
+
 ### Workspace Pattern Gaps
 
 Run:
 
 ```bash
-pnpm exec repo setup --yes
+pnpm exec repo init --yes
 ```
 
 or manually extend `pnpm-workspace.yaml`.

package/templates/vitepress/en/repoctl/aliases.md

@@ -16,7 +16,7 @@ mo
 
 The docs recommend `repo`.
 
-Compatibility entry points remain available:
+These bins all enter the same command implementation:
 
 ```bash
 repoctl doctor
@@ -29,8 +29,7 @@ mo doctor
 
 | Recommended      | Alias       | Purpose                       |
 | ---------------- | ----------- | ----------------------------- |
-| `repo setup`     | `repo init` | Initialize workspace defaults |
-| `repo upgrade`   | `repo sync` | Sync standard template assets |
+| `repo init`      | `repo init` | Initialize workspace defaults |
 | `repo templates` | `repo tpl`  | Inspect or check templates    |
 
 ## Group Aliases
@@ -66,6 +65,6 @@ mo doctor
 ## Recommendation
 
 - Use full commands in onboarding docs.
-- Use root scripts in project README files.
+- Use `repo:*` root scripts in project README files, for example `pnpm run repo:doctor`.
 - Use short aliases in maintainer scripts only when the surrounding docs explain them.
 - Prefer full commands in CI logs.