@agent-native/core 0.85.7 → 0.86.1

package/corpus/core/docs/content/locales/pt-BR/sharing.mdx

@@ -5,7 +5,7 @@ description: "Compartilhamento no estilo Google Docs, integrado à estrutura. Ca
 
 # Compartilhamento e privacidade
 
-Cada recurso que um usuário cria em um aplicativo nativo do agente — um documento, um painel, um design, uma apresentação, uma edição de vídeo, uma gravação de tela, uma transcrição de reunião, um formulário, um link de reserva — é **privado para o criador por padrão**. Outras pessoas só o veem quando o criador o compartilha explicitamente ou altera sua visibilidade para `org` ou `public`.
+Cada recurso que um usuário cria em um aplicativo nativo do agente — um documento, um painel, um design, uma apresentação, uma gravação de tela, uma transcrição de reunião, um formulário, um link de reserva — é **privado para o criador por padrão**. Outras pessoas só o veem quando o criador o compartilha explicitamente ou altera sua visibilidade para `org` ou `public`.
 
 Parece e funciona como o Google Docs. O mesmo botão de compartilhamento, a mesma caixa de diálogo, o mesmo modelo de visibilidade de três níveis, as mesmas concessões por usuário/por organização, em todos os modelos, sem reinvenção por aplicativo.
 
@@ -92,7 +92,6 @@ Todo modelo que armazena trabalhos de autoria do usuário usa esse modelo. Concr
 - **Conteúdo** — documentos
 - **Apresentações** — apresentações
 - **Design** — designs e recursos
-- **Vídeo** — composições
 - **Clipes** — gravações de tela (estilo Loom)
 - **Formulários** — definições de formulário
 - **Calendário** — links para eventos e reservas

package/corpus/core/docs/content/locales/pt-BR/skills-guide.mdx

@@ -118,9 +118,7 @@ O domínio skills segue o mesmo formato do framework skills. Eles codificam padr
 
 ## skills com suporte de aplicativo {#app-backed-skills}
 
-As skills com suporte de app atuais incluem `visual-plan` e `visual-recap` do
-Plan, `visual-edit` do Design, `assets` do Assets e `content` para editar
-docs/blog/MDX a partir do repositório.
+As skills com suporte de app atuais incluem `visual-plan`, `visual-recap` e `visualize-repo` do Plan, `visual-edit` do Design, `assets` do Assets e `content` para edição docs/blog/MDX apoiada pelo repositório.
 
 O skills apoiado por aplicativo empacota um aplicativo nativo do agente como um artefato do mercado de habilidades. O pacote pode incluir instruções do agente, metadados exportados do conector skills, MCP, instruções de inicialização hospedadas/locais e superfícies UI, como aplicativos MCP.
 
@@ -332,6 +330,7 @@ trabalho off-line ou uso sensível à privacidade.
 ```bash
 # Caminho feliz: instruções exportadas mais conector MCP hospedado.
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/corpus/core/docs/content/locales/pt-BR/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native Plans transforma o plano do seu agente de codificaç
 
 # Planos Visuais
 
-> **A maioria das pessoas instala o Plan como uma habilidade, não como um aplicativo de scaffold.** Um comando CLI
-> adiciona o `/visual-plan` e `/visual-recap` skills mais o plano hospedado
-> para seu agente de codificação — consulte [Plan plugin & marketplace](/docs/plan-plugin)
-> para as rotas de plugin e mercado. Modelo de bifurcação do plano (abordado em
-> [For developers](#for-developers)) é o caminho secundário, para auto-hospedagem ou
-> com base no próprio Plano.
+> **A maioria das pessoas instala o Plan como uma skill, não como um app scaffolded.** Um comando CLI adiciona as skills `/visual-plan`, `/visual-recap` e `/visualize-repo`, além do conector Plan hospedado, ao seu agente de código — consulte [Plan plugin & marketplace](/docs/plan-plugin) para as rotas de plugin e marketplace. Fazer fork do template Plan (coberto em [For developers](#for-developers)) é o caminho secundário para auto-hospedagem ou para construir sobre o próprio Plan.
 
 Agent-Native Plans é o modo de plano visual para agentes de codificação. Acontece uma coisa comum
 Codex, código Claude, Markdown ou plano de implementação colado em um plano de implementação estruturado
@@ -117,7 +112,7 @@ atingiu uma parede OAuth:
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-O comando instala ambos os comandos: `/visual-plan` e `/visual-recap`.
+O comando instala três comandos: `/visual-plan`, `/visual-recap` e `/visualize-repo`.
 
 Se você estiver usando um host baseado em bate-papo que aceita conectores MCP diretamente dos URLs
 (em vez de um cliente configurado com CLI), conecte o conector de Planos hospedado em
@@ -360,6 +355,25 @@ e comentando e retorna o URL hospedado. O modo de arquivos locais não
 tornar automaticamente o LLM do seu agente de codificação local; escolha um local ou aprovado
 modele se esse limite de privacidade também é importante.
 
+## Documentação visual do repositório {#visualize-repo}
+
+Use `/visualize-repo` quando quiser uma camada durável de documentação visual para uma base de código, em vez de um plano ou recap pontual. Ele cria ou abre um workspace local de Plan MDX, atualiza `agent-native.json` com uma seção `apps.visualize-repo` em modo local-files e serve os docs pela mesma ponte localhost:
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+Se `agent-native.json` não existir, o comando cria um arquivo inicial e recomenda um pequeno conjunto de partida a partir da estrutura do repositório, como `actions/`, `app/components/`, `app/pages/`, `server/db/schema.ts`, `src/`, `packages/`, `templates/`, `docs/` ou `content/`. Você pode mirar âncoras de código específicas:
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+A pasta inicial fica em `.agent-native/visual-docs/repo-overview` por padrão. Os comentários permanecem locais em `comments.json`, para que revisores marquem seções para um agente de código e o agente atualize código e MDX na mesma mudança. Execute `visualize-repo check` para lint local e `visualize-repo verify` quando quiser que o schema do renderizador Plan valide o MDX.
+
 ## Sincronização de arquivos locais na área de trabalho {#desktop-local-sync}
 
 O Agent Native Desktop também oferece aos planos hospedados uma ponte nativa de pastas locais. Isto
@@ -412,6 +426,8 @@ toque nos arquivos locais.
 - "Use `/visual-recap` na diferença entre `main` e esta ramificação."
 - "Use `/visual-recap` no modo de arquivos locais para que nenhum conteúdo de recapitulação seja gravado no banco de dados do plano."
 
+- "Execute `/visualize-repo` e comece pelas nossas ações de API públicas e pelo schema."
+
 ## Recuperando-se de erros de autenticação {#auth-errors}
 
 Se uma ferramenta de Planos retornar `needs auth`, `Unauthorized` ou `Sessão

package/corpus/core/docs/content/locales/pt-BR/tracking.mdx

@@ -235,7 +235,7 @@ Os padrões de privacidade são intencionalmente conservadores, mas ainda úteis
 - As URLs são higienizadas com o mesmo auxiliar `scrubUrl()` usado pela análise do navegador.
 - A captura de replay é somente para web e opcional; ela não grava telas de desktop nativas.
 
-Durante a gravação, o replay de sessão também captura a saída do console do navegador (`log`, `info`, `warn`, `error`, `debug`, além dos eventos `error`/`unhandledrejection` da janela) e metadados de solicitações de rede (`fetch` e XHR) como eventos personalizados do rrweb marcados, para que agentes e o visualizador de replay possam depurar problemas relatados por usuários. A captura é ativada por padrão quando o replay está habilitado; ajuste ou desabilite-a com as opções `sessionReplay.console` e `sessionReplay.network`, cada uma aceitando um booleano ou um objeto de opções. Corpos e cabeçalhos de solicitação/resposta nunca são capturados, as URLs são higienizadas, as mensagens são truncadas, o próprio tráfego de ingestão/rastreamento do gravador é excluído, e os orçamentos por sessão (1000 eventos de console / 2000 eventos de rede) adicionam um aviso de truncamento quando excedidos.
+Durante a gravação, o replay de sessão também captura a saída do console do navegador (`log`, `info`, `warn`, `error`, `debug`, além dos eventos `error`/`unhandledrejection` da janela) e metadados de solicitações de rede (`fetch` e XHR) como eventos personalizados do rrweb marcados, para que agentes e o visualizador de replay possam depurar problemas relatados por usuários. A captura é ativada por padrão quando o replay está habilitado; ajuste ou desabilite-a com as opções `sessionReplay.console` e `sessionReplay.network`, cada uma aceitando um booleano ou um objeto de opções (`{ maxEvents?: number }`, sendo que `network` também aceita `captureErrorBodies` e `maxErrorBodyLength`). Corpos e cabeçalhos de solicitação nunca são capturados; corpos de resposta são capturados apenas como um trecho limitado e higienizado para respostas 5xx (erro de servidor) (`captureErrorBodies`, padrão `true`, limitado a `maxErrorBodyLength` caracteres, padrão 2048) — respostas que não sejam 5xx e falhas de rede (status 0) nunca carregam um corpo. As URLs são higienizadas, as mensagens são truncadas, o próprio tráfego de ingestão/rastreamento do gravador é excluído, e os orçamentos por sessão (1000 eventos de console / 2000 eventos de rede) adicionam um aviso de truncamento quando excedidos.
 
 O modelo Analytics armazena os metadados de replay em SQL (`session_recordings`) e armazena os blocos por meio de referências privadas de blob (`session_replay_chunks`). Navegadores e agentes nunca recebem URLs de provedores. A reprodução passa por rotas de servidor com escopo definido, e as ferramentas padrão do agente retornam resumos ou eventos de replay limitados, não acesso bruto à tabela de blocos.
 

package/corpus/core/docs/content/locales/pt-BR/workspace-connections.mdx

@@ -264,7 +264,7 @@ Os IDs iniciais do provedor são:
 | `google_drive` | pesquisar, importar, documentos            | cérebro, conteúdo, slides                     |
 | `hubspot`      | pesquisar, importar, CRM                   | analítica, cérebro, e-mail                    |
 | `granola`      | pesquisa, importação, reuniões, documentos | cérebro, calendário, envio                    |
-| `clips`        | pesquisa, importação, reuniões             | cérebro, clipes, vídeos                       |
+| `clips`        | pesquisa, importação, reuniões             | cérebro, clipes                               |
 | `generic`      | pesquisar, importar, documentos            | webhooks personalizado e descarte de arquivos |
 
 As chaves de credenciais são apenas nomes, como `SLACK_BOT_TOKEN` ou `GITHUB_TOKEN`. Os metadados do provedor nunca devem incluir valores de credenciais reais.

package/corpus/core/docs/content/locales/zh-CN/cloneable-saas.mdx

@@ -22,7 +22,6 @@ description: "分叉一个可用的 SaaS 产品并使其成为您的产品 - 包
 | [**Brain**](/docs/template-brain)         | 干净的公司聊天由引用的机构记忆、批准的来源、审查门和引文支持。                                      |
 | [**Assets**](/docs/template-assets)       | 用于品牌库、上传、参考和品牌图像/视频生成的数字资产管理器。                                         |
 | [**Slides**](/docs/template-slides)       | 代理原生 Google 幻灯片。基于React的套牌由代理直接生成和编辑。                                       |
-| [**Video**](/docs/template-videos)        | Remotion 上的程序化动态图形和产品演示视频。                                                         |
 | [**Analytics**](/docs/template-analytics) | 代理本机振幅/混合面板。连接数据源、提示图表、固定到仪表板。                                         |
 | [**Clips**](/docs/template-clips)         | 异步屏幕+摄像头录制，包含转录、章节和 AI 摘要。                                                     |
 | [**Design**](/docs/template-design)       | Agent 原生 HTML 原型工作室，用于交互式 Alpine/Tailwind 设计。                                       |

package/corpus/core/docs/content/locales/zh-CN/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "规划插件和市场"
-description: "安装 Agent-Native 计划 skills（/visual-plan、/visual-recap）以及托管计划 MCP 连接器作为 Claude 代码或 Codex 插件，或使用通用 CLI。更新如何进行以及您是否需要提交任何内容。"
+description: "安装 Agent-Native Plan skills（/visual-plan、/visual-recap、/visualize-repo）以及托管 Plan MCP 连接器，可作为 Claude Code 或 Codex 插件安装，也可使用通用 CLI。了解更新如何工作以及是否需要提交任何内容。"
 ---
 
 # 规划插件和市场
 
-Agent-Native **Plan** 应用程序作为一个可安装的捆绑包提供。一次安装即可添加计划斜线命令 skills **并**连接托管计划 MCP 连接器，以便代理可以生成计划，并且 skills 可以将它们直接发布到计划应用程序中。
+Agent-Native **Plan** 应用以一个可安装的 bundle 提供。一次安装会添加 Plan 斜杠命令 skills，**并**连接托管的 Plan MCP 连接器，让 agent 可以生成 plans，并让 skills 直接发布到 Plan 应用中。
 
 ## 你得到什么 {#what-you-get}
 
 一次安装即可为您提供：
 
-- **两个 skills** — `/visual-plan`（规范入口点）和 `/visual-recap`。
+- **三个 skills** — `/visual-plan`（规范入口点）、`/visual-recap` 和 `/visualize-repo`。
 - **计划 MCP 连接器** — 针对 `https://plan.agent-native.com` 上的托管应用程序进行注册（MCP 端点 `https://plan.agent-native.com/_agent-native/mcp`，服务器名称 `plan`）。
 
-<Diagram id="doc-block-xt4mmz" title={"三条路线，一揽子"} summary={"通用 CLI、Claude Code 插件和 Codex 插件都安装相同的两个技能以及托管计划连接器。"}>
+<Diagram id="doc-block-xt4mmz" title={"三条路线，一揽子"} summary={"通用 CLI、Claude Code 插件和 Codex 插件都会安装同一组 Plan skills 以及托管的 Plan 连接器。"}>
 
 ```html
 <div class="diagram-routes">
@@ -35,7 +35,8 @@ Agent-Native **Plan** 应用程序作为一个可安装的捆绑包提供。一
   <div class="diagram-panel center">
     <span class="diagram-pill accent">/visual-plan</span
     ><span class="diagram-pill accent">/visual-recap</span
-    ><small class="diagram-muted">two skills</small>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -76,7 +77,7 @@ Agent-Native **Plan** 应用程序作为一个可安装的捆绑包提供。一
 
 </Diagram>
 
-默认情况下，skills 都会发布到托管的计划应用 - 他们通过
+默认情况下，`/visual-plan` 和 `/visual-recap` 会发布到托管的 Plan 应用 — 它们通过
 MCP 连接器并向您提供链接或内联计划以供审核。他们从不倾倒
 内嵌 Markdown/ASCII 计划作为可交付成果放入聊天中。如果计划工具
 返回`needs auth`、`Unauthorized`或`Session terminated`，重新验证
@@ -192,13 +193,13 @@ Agent Native 桌面有一个单独的托管计划本地文件同步路径：
 
 ### 通用技能路线（任意MCP主机） {#universal}
 
-适用于任何主机 - Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自定义 MCP 应用程序、Claude Cowork 以及任何其他与 MCP 兼容的内容。 Agent-Native CLI 安装 skills，注册托管计划 MCP 连接器，**并在同一步骤中为选定的本地客户端运行身份验证**，因此您的第一个工具调用不会遇到 OAuth 墙：
+适用于任何 host — Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自定义 MCP apps、Claude Cowork 以及任何其他 MCP-compatible host。Agent-Native CLI 会安装 Plan skills，注册托管的 Plan MCP 连接器，**并在同一步中为选定的本地客户端运行身份验证**，因此你的第一次工具调用不会遇到 OAuth 墙：
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-这将安装 `visual-plan` 以及配套的 `visual-recap` 技能，然后注册 `plan` 连接器，然后运行身份验证（OAuth 提示托管/帐户支持的共享）。有用的标志：
+这会安装 `visual-plan` 以及配套的 `visual-recap` 和 `visualize-repo` skills，然后注册 `plan` 连接器并运行身份验证（用于托管/账户支持共享的 OAuth 提示）。有用的标志：
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — 为其编写 MCP 配置的本地代理（默认 `all`）。
 - `--no-connect` — 注册连接器而不进行身份验证；稍后运行 `npx @agent-native/core@latest connect https://plan.agent-native.com --client all`，或者选择更窄的 `--client`。
@@ -234,7 +235,7 @@ npx @agent-native/core@latest recap doctor
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` 添加了计划 skills 和 **仅 URL** MCP 配置（包中没有秘密）； `/mcp`→**验证**完成OAuth握手。当您需要本地文件或自托管模式时，请使用通用 CLI 路由。
+`/plugin install` 会添加 Plan skills 和 **仅 URL** 的 MCP 配置（包中没有 secrets）；`/mcp` → **Authenticate** 完成 OAuth 握手。当你需要本地文件或自托管模式时，请改用通用 CLI 路径。
 
 > 市场目录名为 `agent-native-apps`，计划插件为 `agent-native-visual-plans`，因此安装目标始终为 `agent-native-visual-plans@agent-native-apps`。
 

package/corpus/core/docs/content/locales/zh-CN/sharing.mdx

@@ -5,7 +5,7 @@ description: "Google Docs 风格的共享，内置于框架中。每个用户创
 
 # 共享和隐私
 
-用户在代理原生应用程序中创建的每个资源（文档、仪表板、设计、演示文稿、视频编辑、屏幕录制、会议记录、表单、预订链接）**默认情况下对创建者来说是私有的**。仅当创建者明确共享它或将其可见性更改为 `org` 或 `public` 时，其他人才能看到它。
+用户在代理原生应用程序中创建的每个资源（文档、仪表板、设计、演示文稿、屏幕录制、会议记录、表单、预订链接）**默认情况下对创建者来说是私有的**。仅当创建者明确共享它或将其可见性更改为 `org` 或 `public` 时，其他人才能看到它。
 
 它的外观和工作方式与 Google 文档类似。相同的共享按钮、相同的对话框、相同的三层可见性模型、相同的每用户/每组织授权 - 跨每个模板，无需针对每个应用进行重新设计。
 
@@ -92,7 +92,6 @@ description: "Google Docs 风格的共享，内置于框架中。每个用户创
 - **内容** — 文档
 - **幻灯片** — 幻灯片
 - **设计** — 设计和资产
-- **视频** — 作品
 - **剪辑** — 屏幕录制（Loom 风格）
 - **表单** — 表单定义
 - **日历** — 活动和预订链接

package/corpus/core/docs/content/locales/zh-CN/skills-guide.mdx

@@ -118,9 +118,7 @@ Skills 位于 `.agents/skills/<name>/SKILL.md`，包含针对代理的详细指
 
 ## 应用程序支持的 skills {#app-backed-skills}
 
-当前应用支持的 skills 包括 Plan 的 `visual-plan` 和 `visual-recap`、Design
-的 `visual-edit`、Assets 的 `assets`，以及用于仓库内 docs/blog/MDX 编辑的
-`content`。
+当前应用支持的 skills 包括 Plan 的 `visual-plan`、`visual-recap` 和 `visualize-repo`，Design 的 `visual-edit`，Assets 的 `assets`，以及用于仓库支持的 docs/blog/MDX 编辑的 `content`。
 
 应用程序支持的 skills 将代理本机应用程序打包为技能市场工件。该捆绑包可以包含代理指令、导出的 skills、MCP 连接器元数据、托管/本地启动指令和 UI 表面（例如 MCP 应用程序）。
 
@@ -332,6 +330,7 @@ Hosted 是默认安装路径。本地启动是明确的定制，
 ```bash
 # 愉快的路径：导出的指令加上托管的 MCP 连接器。
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/corpus/core/docs/content/locales/zh-CN/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native 计划将您的编码代理的计划转变为结构
 
 # 视觉计划
 
-> **大多数人安装 Plan 作为一项技能，而不是支架式应用程序。** 一个 CLI 命令
-> 添加 `/visual-plan` 和 `/visual-recap` skills 以及托管计划
-> 连接到您的编码代理 - 请参阅 [Plan plugin & marketplace](/docs/plan-plugin)
-> 用于插件和市场路线。分叉计划模板（参见
-> [For developers](#for-developers)) 是辅助路径，用于自托管或
-> 建立在计划本身之上。
+> **大多数人会把 Plan 作为 skill 安装，而不是 scaffolded app。** 一个 CLI 命令会把 `/visual-plan`、`/visual-recap`、`/visualize-repo` skills 和托管的 Plan 连接器添加到你的 coding agent — plugin 和 marketplace 路径见 [Plan plugin & marketplace](/docs/plan-plugin)。Fork Plan 模板（见 [For developers](#for-developers)）是用于自托管或基于 Plan 本身构建的次要路径。
 
 Agent-Native 计划是编码代理的可视化计划模式。它变成了普通
 Codex、Claude 代码、Markdown 或将实施计划粘贴到结构化中
@@ -111,7 +106,7 @@ Codex、Claude 代码、Markdown 或将实施计划粘贴到结构化中
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-该命令安装两个命令：`/visual-plan` 和 `/visual-recap`。
+该命令安装三个命令：`/visual-plan`、`/visual-recap` 和 `/visualize-repo`。
 
 如果您使用的是直接接受 MCP 连接器 URL 的基于聊天的主机
 （而不是 CLI 配置的客户端），连接托管计划连接器
@@ -354,6 +349,25 @@ MDX文件夹路径；这将上传计划，为其分配托管 ID，启用共享
 自动使您的编码代理的 LLM 本地化；选择本地或批准的
 模型是否隐私边界也很重要。
 
+## 仓库可视化文档 {#visualize-repo}
+
+当你想为代码库建立一层持久的可视化文档，而不是一次性的计划或 recap 时，使用 `/visualize-repo`。它会创建或打开本地 Plan MDX workspace，在 `agent-native.json` 中更新 `apps.visualize-repo` 的 local-files 配置，并通过同一个 localhost bridge 提供文档：
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+如果不存在 `agent-native.json`，该命令会引导生成一个，并根据仓库结构推荐一个小的起始集合，例如 `actions/`、`app/components/`、`app/pages/`、`server/db/schema.ts`、`src/`、`packages/`、`templates/`、`docs/` 或 `content/`。你也可以指定具体的 source anchors：
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+起始文件夹默认位于 `.agent-native/visual-docs/repo-overview`。评论会保留在本地 `comments.json` 中，因此审阅者可以为 coding agent 标记章节，agent 也可以在同一次变更中同时更新代码和 MDX。运行 `visualize-repo check` 做本地 lint；当你希望 Plan renderer schema 验证 MDX 时，运行 `visualize-repo verify`。
+
 ## 桌面本地文件同步 {#desktop-local-sync}
 
 Agent Native Desktop 还为托管计划提供了本机本地文件夹桥。这个
@@ -406,6 +420,8 @@ Agent Native Desktop 还为托管计划提供了本机本地文件夹桥。这
 - “在 `main` 和此分支之间的差异上使用 `/visual-recap`。”
 - “在本地文件模式下使用 `/visual-recap`，因此不会将摘要内容写入计划数据库。”
 
+- “运行 `/visualize-repo`，从我们的公共 API 操作和 schema 开始。”
+
 ## 从身份验证错误中恢复 {#auth-errors}
 
 如果计划工具返回 `needs auth`、`Unauthorized` 或“会话”

package/corpus/core/docs/content/locales/zh-CN/tracking.mdx

@@ -235,7 +235,7 @@ VITE_AGENT_NATIVE_SESSION_REPLAY_SAMPLE_RATE=0.1
 - URL 会使用与浏览器分析相同的 `scrubUrl()` 辅助函数进行清理。
 - 重放采集仅限 Web 端且为选择性加入（opt-in）；不会录制原生桌面屏幕。
 
-录制期间，会话重放还会捕获浏览器控制台输出（`log`、`info`、`warn`、`error`、`debug`，以及 window 的 `error` / `unhandledrejection`）和网络请求元数据（`fetch` 和 XHR），并将其作为带标签的 rrweb 自定义事件记录下来，以便代理和重放查看器调试用户报告的问题。启用重放后，此项捕获默认开启；可通过 `sessionReplay.console` 和 `sessionReplay.network` 选项进行调整或禁用，两者均可接受布尔值或选项对象。请求/响应的正文和请求头永远不会被捕获，URL 会被清理，消息会被截断，录制器自身的上报/跟踪流量会被排除，并且每个会话的配额（1000 条控制台事件 / 2000 条网络事件）在超出时会附加截断提示。
+录制期间，会话重放还会捕获浏览器控制台输出（`log`、`info`、`warn`、`error`、`debug`，以及 window 的 `error` / `unhandledrejection`）和网络请求元数据（`fetch` 和 XHR），并将其作为带标签的 rrweb 自定义事件记录下来，以便代理和重放查看器调试用户报告的问题。启用重放后，此项捕获默认开启；可通过 `sessionReplay.console` 和 `sessionReplay.network` 选项进行调整或禁用，两者均可接受布尔值或选项对象（`{ maxEvents?: number }`，其中 `network` 还可接受 `captureErrorBodies` 和 `maxErrorBodyLength`）。请求正文和请求头永远不会被捕获；响应正文仅在 5xx（服务器错误）响应下才会被捕获，且只捕获一段有边界、经过脱敏处理的片段（`captureErrorBodies`，默认值为 `true`，长度上限为 `maxErrorBodyLength` 个字符，默认 2048）——非 5xx 响应以及网络失败（状态码 0）的响应永远不会携带正文。URL 会被清理，消息会被截断，录制器自身的上报/跟踪流量会被排除，并且每个会话的配额（1000 条控制台事件 / 2000 条网络事件）在超出时会附加截断提示。
 
 Analytics 模板将重放元数据存储在 SQL（`session_recordings`）中，并通过私有 blob 引用（`session_replay_chunks`）存储数据块。浏览器和代理永远不会收到提供商的 URL。回放通过受限的服务器路由进行，默认的代理工具返回的是摘要或有限范围的重放事件，而非原始数据块表的直接访问权限。
 

package/corpus/core/docs/content/locales/zh-CN/workspace-connections.mdx

@@ -264,7 +264,7 @@ if (workspaceConnectionProviderSupports("slack", "messages")) {
 | `google_drive` | 搜索、导入、文档       | 大脑、内容、幻灯片         |
 | `hubspot`      | 搜索、导入、crm        | 分析、大脑、邮件           |
 | `granola`      | 搜索、导入、会议、文档 | 大脑、日历、调度           |
-| `clips`        | 搜索、导入、会议       | 大脑、剪辑、视频           |
+| `clips`        | 搜索、导入、会议       | 大脑、剪辑                 |
 | `generic`      | 搜索、导入、文档       | 自定义 webhooks 和文件投放 |
 
 凭证密钥仅为名称，例如 `SLACK_BOT_TOKEN` 或 `GITHUB_TOKEN`。提供者元数据绝不能包含实际的凭证值。

package/corpus/core/docs/content/locales/zh-TW/cloneable-saas.mdx

@@ -22,7 +22,6 @@ description: "分叉一個可用的 SaaS 產品並使其成為您的產品 - 包
 | [**Brain**](/docs/template-brain)         | 幹淨的公司聊天由引用的機構記憶、核准的來源、審查門和引文支援。                                  |
 | [**Assets**](/docs/template-assets)       | 用於品牌庫、上傳、參考和品牌圖片/影片產生的數位資產管理器。                                     |
 | [**Slides**](/docs/template-slides)       | Agent-Native Google 幻燈片。基於 React 的簡報由代理直接生成和編輯。                             |
-| [**Video**](/docs/template-videos)        | Remotion 上的程式化動態圖形和產品示範影片。                                                     |
 | [**Analytics**](/docs/template-analytics) | Agent-Native 振幅/混合面板。連線資料來源、提示圖表、固定到儀表板。                              |
 | [**Clips**](/docs/template-clips)         | 非同步螢幕+攝影機錄製，包含轉錄、章節和 AI 摘要。                                               |
 | [**Design**](/docs/template-design)       | Agent 原生 HTML 原型工作室，用於互動式 Alpine/Tailwind 設計。                                   |

package/corpus/core/docs/content/locales/zh-TW/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "規劃外掛和市場"
-description: "安裝 Agent-Native 計畫 skills（/visual-plan、/visual-recap）以及託管計畫 MCP 連線器作為 Claude 程式碼或 Codex 外掛，或使用通用 CLI。更新如何進行以及您是否需要提交任何內容。"
+description: "安裝 Agent-Native Plan skills（/visual-plan、/visual-recap、/visualize-repo）以及託管 Plan MCP 連線器，可作為 Claude Code 或 Codex 外掛安裝，也可使用通用 CLI。了解更新如何運作以及是否需要提交任何內容。"
 ---
 
 # 規劃外掛和市場
 
-Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一次安裝即可新增計畫斜線指令 skills **並**連線託管計畫 MCP 連線器，以便代理可以生成計畫，並且 skills 可以將它們直接發布到計畫應用程式中。
+Agent-Native **Plan** 應用程式以一個可安裝的 bundle 提供。一次安裝會新增 Plan 斜線指令 skills，**並**連線託管的 Plan MCP 連線器，讓 agent 可以產生 plans，並讓 skills 直接發布到 Plan 應用程式中。
 
 ## 你得到什麼 {#what-you-get}
 
 一次安裝即可為您提供：
 
-- **兩個 skills** — `/visual-plan`（規範入口點）和 `/visual-recap`。
+- **三個 skills** — `/visual-plan`（規範入口點）、`/visual-recap` 和 `/visualize-repo`。
 - **計畫 MCP 連線器** — 針對 `https://plan.agent-native.com` 上的託管應用程式進行註冊（MCP 端點 `https://plan.agent-native.com/_agent-native/mcp`，伺服器名稱 `plan`）。
 
-<Diagram id="doc-block-6n3so7" title={"三條路由，一攬子"} summary={"通用 CLI、Claude Code 外掛和 Codex 外掛都安裝相同的兩個技能以及託管計畫連線器。"}>
+<Diagram id="doc-block-6n3so7" title={"三條路由，一攬子"} summary={"通用 CLI、Claude Code 外掛和 Codex 外掛都會安裝同一組 Plan skills 以及託管的 Plan 連線器。"}>
 
 ```html
 <div class="diagram-routes">
@@ -35,7 +35,8 @@ Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一
   <div class="diagram-panel center">
     <span class="diagram-pill accent">/visual-plan</span
     ><span class="diagram-pill accent">/visual-recap</span
-    ><small class="diagram-muted">two skills</small>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -76,7 +77,7 @@ Agent-Native **Plan** 應用程式作為一個可安裝的捆綁包提供。一
 
 </Diagram>
 
-預設情況下，skills 都會發布到託管的計畫應用 - 他們透過
+預設情況下，`/visual-plan` 和 `/visual-recap` 會發布到託管的 Plan 應用程式 — 它們透過
 MCP 連線器並向您提供連結或行內計畫以供審核。他們從不傾倒
 內嵌 Markdown/ASCII 計畫作為可交付成果放入聊天中。如果計畫工具
 返回`needs auth`、`Unauthorized`或`Session terminated`，重新驗證
@@ -192,13 +193,13 @@ Agent Native 桌面有一個單獨的託管計畫本機檔案同步路徑：
 
 ### 通用技能路由（任意 MCP 主機） {#universal}
 
-適用於任何主機 - Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP 應用程式、Claude Cowork 以及任何其他與 MCP 相容的內容。 Agent-Native CLI 安裝 skills，註冊託管計畫 MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此您的第一個工具呼叫不會遇到 OAuth 牆：
+適用於任何 host — Claude Code、Codex、Cursor、Cline、Goose、ChatGPT 自訂 MCP apps、Claude Cowork 以及任何其他 MCP-compatible host。Agent-Native CLI 會安裝 Plan skills，註冊託管的 Plan MCP 連線器，**並在同一步驟中為選定的本機用戶端執行驗證**，因此你的第一次工具呼叫不會遇到 OAuth 牆：
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-這將安裝 `visual-plan` 以及配套的 `visual-recap` 技能，然後註冊 `plan` 連線器，然後執行驗證（OAuth 提示託管/帳戶支援的共用）。有用的標誌：
+這會安裝 `visual-plan` 以及配套的 `visual-recap` 和 `visualize-repo` skills，然後註冊 `plan` 連線器並執行驗證（用於託管/帳戶支援共用的 OAuth 提示）。有用的 flags：
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — 為其編寫 MCP 設定的本機代理（預設 `all`）。
 - `--no-connect` — 註冊連線器而不進行驗證；稍後執行 `npx @agent-native/core@latest connect https://plan.agent-native.com --client all`，或者選取更窄的 `--client`。
@@ -234,7 +235,7 @@ npx @agent-native/core@latest recap doctor
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` 新增了計畫 skills 和 **僅 URL** MCP 設定（包中沒有秘密）； `/mcp`→**驗證**完成 OAuth 握手。當您需要本機檔案或自託管模式時，請使用通用 CLI 路由。
+`/plugin install` 會新增 Plan skills 和 **僅 URL** 的 MCP 設定（套件中沒有 secrets）；`/mcp` → **Authenticate** 完成 OAuth 握手。當你需要本機檔案或自託管模式時，請改用通用 CLI 路徑。
 
 > 市場目錄名為 `agent-native-apps`，計畫外掛為 `agent-native-visual-plans`，因此安裝目標始終為 `agent-native-visual-plans@agent-native-apps`。
 

package/corpus/core/docs/content/locales/zh-TW/sharing.mdx

@@ -5,7 +5,7 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 
 # 共用和隱私
 
-使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、影片編輯、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
+使用者在 Agent-Native 應用程式中建立的每個資源（檔案、儀表板、設計、簡報、螢幕錄製、會議紀錄、表單、預訂連結）**預設情況下對建立者來說是私人的**。僅當建立者明確共用它或將其可見性更改為 `org` 或 `public` 時，其他人才能看到它。
 
 它的外觀和工作方式與 Google 檔案類似。相同的共用按鈕、相同的對話框、相同的三層可見性模型、相同的每使用者/每組織授權 - 跨每個範本，無需針對每個應用進行重新設計。
 
@@ -92,7 +92,6 @@ description: "Google Docs 風格的共用，內建於框架中。每個使用者
 - **內容** — 檔案
 - **幻燈片** — 幻燈片
 - **設計** — 設計和資產
-- **影片** — 作品
 - **剪輯** — 螢幕錄製（Loom 風格）
 - **表單** — 表單定義
 - **行事曆** — 活動和預訂連結

package/corpus/core/docs/content/locales/zh-TW/skills-guide.mdx

@@ -118,9 +118,7 @@ Skills 位於 `.agents/skills/<name>/SKILL.md`，包含針對代理的詳細指
 
 ## 應用程式支援的 skills {#app-backed-skills}
 
-目前應用支援的 skills 包括 Plan 的 `visual-plan` 和 `visual-recap`、Design
-的 `visual-edit`、Assets 的 `assets`，以及用於儲存庫內 docs/blog/MDX 編輯的
-`content`。
+目前應用支援的 skills 包括 Plan 的 `visual-plan`、`visual-recap` 和 `visualize-repo`，Design 的 `visual-edit`，Assets 的 `assets`，以及用於 repository 支援的 docs/blog/MDX 編輯的 `content`。
 
 應用程式支援的 skills 將 Agent-Native 應用程式打包為技能市場工件。該捆綁包可以包含代理指令、匯出的 skills、MCP 連線器中繼資料、託管/本機啟動指令和 UI 表面（例如 MCP 應用程式）。
 
@@ -332,6 +330,7 @@ Hosted 是預設安裝路徑。本機啟動是明確的定制，
 ```bash
 # 愉快的路徑：匯出的指令加上託管的 MCP 連線器。
 npx @agent-native/core@latest skills add visual-plan
+npx @agent-native/core@latest skills add visualize-repo
 npx @agent-native/core@latest skills add visual-edit
 npx @agent-native/core@latest skills add assets
 

package/corpus/core/docs/content/locales/zh-TW/template-plan.mdx

@@ -5,12 +5,7 @@ description: "Agent-Native 計畫將您的編碼代理的計畫轉變為結構
 
 # 視覺計畫
 
-> **大多數人安裝 Plan 作為一項技能，而不是支架式應用程式。** 一個 CLI 指令
-> 新增 `/visual-plan` 和 `/visual-recap` skills 以及託管計畫
-> 連線到您的編碼代理 - 請參閱 [Plan plugin & marketplace](/docs/plan-plugin)
-> 用於外掛和市場路由。分叉計畫範本（參見
-> [For developers](#for-developers)) 是輔助路徑，用於自託管或
-> 建立在計畫本身之上。
+> **大多數人會把 Plan 作為 skill 安裝，而不是 scaffolded app。** 一個 CLI 指令會把 `/visual-plan`、`/visual-recap`、`/visualize-repo` skills 和託管的 Plan 連線器新增到你的 coding agent — plugin 和 marketplace 路徑請參閱 [Plan plugin & marketplace](/docs/plan-plugin)。Fork Plan template（見 [For developers](#for-developers)）是用於自託管或基於 Plan 本身建置的次要路徑。
 
 Agent-Native 計畫是編碼代理的視覺化計畫模式。它變成了普通
 Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
@@ -111,7 +106,7 @@ Codex、Claude 程式碼、Markdown 或將實施計畫貼上到結構化中
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-該指令安裝兩個指令：`/visual-plan` 和 `/visual-recap`。
+該指令會安裝三個指令：`/visual-plan`、`/visual-recap` 和 `/visualize-repo`。
 
 如果您使用的是直接接受 MCP 連線器 URL 的基於聊天的主機
 （而不是 CLI 設定的用戶端），連線託管計畫連線器
@@ -354,6 +349,25 @@ MDX 資料夾路徑；這將上傳計畫，為其分配託管 ID，啟用共用
 自動使您的編碼代理的 LLM 本機化；選取本機或核准的
 模型是否隱私邊界也很重要。
 
+## Repository 視覺化文件 {#visualize-repo}
+
+當你想為 codebase 建立一層持久的視覺化文件，而不是一次性的 plan 或 recap 時，使用 `/visualize-repo`。它會建立或開啟本機 Plan MDX workspace，在 `agent-native.json` 中更新 `apps.visualize-repo` 的 local-files 設定，並透過同一個 localhost bridge 提供文件：
+
+```bash
+npx @agent-native/core@latest visualize-repo --open
+```
+
+如果不存在 `agent-native.json`，該指令會引導產生一個，並根據 repository 結構推薦一個小的起始集合，例如 `actions/`、`app/components/`、`app/pages/`、`server/db/schema.ts`、`src/`、`packages/`、`templates/`、`docs/` 或 `content/`。你也可以指定具體的 source anchors：
+
+```bash
+npx @agent-native/core@latest visualize-repo \
+  --target actions/webhooks.ts \
+  --target server/db/schema.ts \
+  --target app/components/PromptComposer.tsx
+```
+
+起始資料夾預設位於 `.agent-native/visual-docs/repo-overview`。Comments 會保留在本機 `comments.json` 中，因此 reviewers 可以為 coding agent 標記章節，agent 也可以在同一次變更中同時更新 code 和 MDX。執行 `visualize-repo check` 做本機 lint；當你希望 Plan renderer schema 驗證 MDX 時，執行 `visualize-repo verify`。
+
 ## 桌面本機檔案同步 {#desktop-local-sync}
 
 Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這個
@@ -406,6 +420,8 @@ Agent Native Desktop 還為託管計畫提供了本機本機資料夾橋。這
 - “在 `main` 和此分支之間的差異上使用 `/visual-recap`。”
 - “在本機檔案模式下使用 `/visual-recap`，因此不會將摘要內容寫入計畫資料庫。”
 
+- “執行 `/visualize-repo`，從我們的公開 API actions 和 schema 開始。”
+
 ## 從驗證錯誤中恢復 {#auth-errors}
 
 如果計畫工具返回 `needs auth`、`Unauthorized` 或“工作階段”

package/corpus/core/docs/content/locales/zh-TW/tracking.mdx

@@ -235,7 +235,7 @@ VITE_AGENT_NATIVE_SESSION_REPLAY_SAMPLE_RATE=0.1
 - URL 會使用瀏覽器分析所用的同一個 `scrubUrl()` 輔助函式進行清理。
 - 重播擷取僅限於網頁，且為選擇加入；它不會錄製原生桌面畫面。
 
-在錄製期間，工作階段重播還會擷取瀏覽器主控台輸出（`log`、`info`、`warn`、`error`、`debug`，以及視窗的 `error`/`unhandledrejection`）與網路請求元資料（`fetch` 與 XHR），並以帶標籤的 rrweb 自訂事件形式儲存，讓代理與重播檢視器能夠偵錯使用者回報的問題。啟用重播後，擷取功能預設為開啟；可透過 `sessionReplay.console` 與 `sessionReplay.network` 選項進行調整或停用，這兩個選項都接受布林值或選項物件。請求/回應主體與標頭永遠不會被擷取，URL 會被清理，訊息會被截斷，記錄器自身的擷取/追蹤流量會被排除，且每個工作階段的預算（1000 個主控台事件／2000 個網路事件）在超過時會加上截斷提示。
+在錄製期間，工作階段重播還會擷取瀏覽器主控台輸出（`log`、`info`、`warn`、`error`、`debug`，以及視窗的 `error`/`unhandledrejection`）與網路請求元資料（`fetch` 與 XHR），並以帶標籤的 rrweb 自訂事件形式儲存，讓代理與重播檢視器能夠偵錯使用者回報的問題。啟用重播後，擷取功能預設為開啟；可透過 `sessionReplay.console` 與 `sessionReplay.network` 選項進行調整或停用，這兩個選項都接受布林值或選項物件（`{ maxEvents?: number }`，其中 `network` 另外還可接受 `captureErrorBodies` 與 `maxErrorBodyLength`）。請求主體與標頭永遠不會被擷取；回應主體僅在 5xx（伺服器錯誤）回應時才會被擷取，且僅擷取一段有邊界、經過遮蔽處理的片段（`captureErrorBodies`，預設為 `true`，上限為 `maxErrorBodyLength` 個字元，預設 2048）——非 5xx 及網路失敗（狀態碼 0）的回應永遠不會帶有主體。URL 會被清理，訊息會被截斷，記錄器自身的擷取/追蹤流量會被排除，且每個工作階段的預算（1000 個主控台事件／2000 個網路事件）在超過時會加上截斷提示。
 
 Analytics 範本將重播中繼資料儲存在 SQL（`session_recordings`）中，並透過私有 blob 參照（`session_replay_chunks`）儲存區塊。瀏覽器與代理永遠不會收到提供者 URL。播放透過範圍受限的伺服器路由進行，且預設代理工具傳回摘要或範圍受限的重播事件，而非原始區塊資料表存取權。
 

package/corpus/core/docs/content/locales/zh-TW/workspace-connections.mdx

@@ -264,7 +264,7 @@ if (workspaceConnectionProviderSupports("slack", "messages")) {
 | `google_drive` | 搜尋、匯入、檔案         | 大腦、內容、幻燈片       |
 | `hubspot`      | 搜尋、匯入、crm          | 分析、大腦、郵件         |
 | `granola`      | 搜尋、匯入、會議、檔案   | 大腦、行事曆、調度       |
-| `clips`        | 搜尋、匯入、會議         | 大腦、剪輯、影片         |
+| `clips`        | 搜尋、匯入、會議         | 大腦、剪輯               |
 | `generic`      | 搜尋、匯入、檔案         | 自訂 webhooks 和檔案投放 |
 
 憑證金鑰僅為名稱，例如 `SLACK_BOT_TOKEN` 或 `GITHUB_TOKEN`。提供者中繼資料絕不能包含實際的憑證值。

package/corpus/core/docs/content/plan-plugin.mdx

@@ -1,20 +1,20 @@
 ---
 title: "Plan plugin & marketplace"
-description: "Install the Agent-Native Plan skills (/visual-plan, /visual-recap) plus the hosted Plan MCP connector as a Claude Code or Codex plugin, or with the universal CLI. How updates work and whether you need to submit anything."
+description: "Install the Agent-Native Plan skills (/visual-plan, /visual-recap, /visualize-repo) plus the hosted Plan MCP connector as a Claude Code or Codex plugin, or with the universal CLI. How updates work and whether you need to submit anything."
 ---
 
 # Plan plugin & marketplace
 
-The Agent-Native **Plan** app ships as one installable bundle. A single install adds both Plan slash-command skills **and** wires up the hosted Plan MCP connector, so the agent can generate plans and the skills can publish them straight into the Plan app.
+The Agent-Native **Plan** app ships as one installable bundle. A single install adds the Plan slash-command skills **and** wires up the hosted Plan MCP connector, so the agent can generate plans and the skills can publish them straight into the Plan app.
 
 ## What you get {#what-you-get}
 
 One install gives you:
 
-- **Two skills** — `/visual-plan` (the canonical entry point) and `/visual-recap`.
+- **Three skills** — `/visual-plan` (the canonical entry point), `/visual-recap`, and `/visualize-repo`.
 - **The Plan MCP connector** — registered against the hosted app at `https://plan.agent-native.com` (MCP endpoint `https://plan.agent-native.com/_agent-native/mcp`, server name `plan`).
 
-<Diagram id="doc-block-i1sn3n" title="Three routes, one bundle" summary="The universal CLI, Claude Code plugin, and Codex plugin all install the same two skills plus the hosted Plan connector.">
+<Diagram id="doc-block-i1sn3n" title="Three routes, one bundle" summary="The universal CLI, Claude Code plugin, and Codex plugin all install the same Plan skills plus the hosted Plan connector.">
 
 ```html
 <div class="diagram-routes">
@@ -37,7 +37,8 @@ One install gives you:
   <div class="diagram-panel center">
     <span class="diagram-pill accent">/visual-plan</span
     ><span class="diagram-pill accent">/visual-recap</span
-    ><small class="diagram-muted">two skills</small>
+    ><span class="diagram-pill accent">/visualize-repo</span
+    ><small class="diagram-muted">three skills</small>
   </div>
   <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
   <div class="diagram-box">
@@ -78,9 +79,9 @@ One install gives you:
 
 </Diagram>
 
-By default, both skills publish to the hosted Plan app — they create a plan via
-the MCP connector and hand you a link or inline plan to review. They never dump
-an inline Markdown/ASCII plan into chat as the deliverable. If a Plan tool
+By default, `/visual-plan` and `/visual-recap` publish to the hosted Plan app —
+they create a plan via the MCP connector and hand you a link or inline plan to
+review. They never dump an inline Markdown/ASCII plan into chat as the deliverable. If a Plan tool
 returns `needs auth`, `Unauthorized`, or `Session terminated`, re-authenticate
 the connector instead of falling back to inline output. Access tokens are
 long-lived (30-day default, sliding 365-day refresh), so this should be rare;
@@ -194,13 +195,13 @@ There are three ways in. The **universal CLI route** is the one we recommend by
 
 ### Universal skill route (any MCP host) {#universal}
 
-Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs both skills, registers the hosted Plan MCP connector, **and runs auth for the selected local client(s) in the same step**, so your first tool call does not hit an OAuth wall:
+Works for any host — Claude Code, Codex, Cursor, Cline, Goose, ChatGPT custom MCP apps, Claude Cowork, and anything else MCP-compatible. The Agent-Native CLI installs the Plan skills, registers the hosted Plan MCP connector, **and runs auth for the selected local client(s) in the same step**, so your first tool call does not hit an OAuth wall:
 
 ```bash
 npx @agent-native/core@latest skills add visual-plan
 ```
 
-This installs `visual-plan` plus the companion `visual-recap` skill, then registers the `plan` connector, then runs auth (OAuth prompt for hosted/account-backed sharing). Useful flags:
+This installs `visual-plan` plus the companion `visual-recap` and `visualize-repo` skills, then registers the `plan` connector, then runs auth (OAuth prompt for hosted/account-backed sharing). Useful flags:
 
 - `--client codex|claude-code|claude-code-cli|cowork|all` — which local agents to write the MCP config for (default `all`).
 - `--no-connect` — register the connector without authenticating; run `npx @agent-native/core@latest connect https://plan.agent-native.com --client all` later, or choose a narrower `--client`.
@@ -236,7 +237,7 @@ The public `BuilderIO/agent-native` repo is itself a Claude Code plugin marketpl
 /mcp        # authenticate the Plan connector (one OAuth approval)
 ```
 
-`/plugin install` adds both Plan skills and a **URL-only** MCP config (no secrets in the package); `/mcp` → **Authenticate** completes the OAuth handshake. Use the universal CLI route instead when you want local-files or self-hosted mode.
+`/plugin install` adds the Plan skills and a **URL-only** MCP config (no secrets in the package); `/mcp` → **Authenticate** completes the OAuth handshake. Use the universal CLI route instead when you want local-files or self-hosted mode.
 
 > The marketplace catalog is named `agent-native-apps` and the Plan plugin is `agent-native-visual-plans`, so the install target is always `agent-native-visual-plans@agent-native-apps`.