tt-a1i · Teamirni · Aug 26, 2026 · Aug 30, 2026 · Sep 16, 2026 · Sep 16, 2026
diff --git a/README.md b/README.md
@@ -12,7 +12,7 @@
 
 **Turn a codebase or system description into a polished, interactive system map — directly in chat.**
 
-Archify is a Node.js rendering and validation system for Cursor, Claude Code, Codex CLI, OpenCode, and GitHub Copilot. Agents produce typed JSON IR; Archify deterministically compiles it into HTML/SVG.
+Archify is a rendering and validation system for Cursor, Claude Code, Codex CLI, OpenCode, GitHub Copilot, and WorkBuddy. Agents produce typed JSON IR; Archify deterministically compiles it into HTML/SVG.
 
 - **Open it and present** — five diagram types, four presets, dark/light themes, built-in brand marks, and finite motion
 - **Review architecture changes before merge** — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts

diff --git a/README_EN.md b/README_EN.md
@@ -12,7 +12,7 @@
 
 **Turn a codebase or system description into a polished, interactive system map — directly in chat.**
 
-Archify is a Node.js rendering and validation system for Cursor, Claude Code, Codex CLI, OpenCode, and GitHub Copilot. Agents produce typed JSON IR; Archify deterministically compiles it into HTML/SVG.
+Archify is a rendering and validation system for Cursor, Claude Code, Codex CLI, OpenCode, GitHub Copilot, and WorkBuddy. Agents produce typed JSON IR; Archify deterministically compiles it into HTML/SVG.
 
 - **Open it and present** — five diagram types, four presets, dark/light themes, built-in brand marks, and finite motion
 - **Review architecture changes before merge** — compare two validated snapshots as Before / Delta / After, with exact added, removed, changed, moved, and rerouted facts

diff --git a/README_ZH.md b/README_ZH.md
@@ -8,7 +8,7 @@
 
 **在对话里，把代码仓库或系统描述变成漂亮、可靠、可交互的系统地图。**
 
-Archify 是一套基于 Node.js 的渲染与校验系统，并以 Agent Skill 的形式支持 Raven、Cursor、Claude Code、Codex CLI、OpenCode 和 GitHub Copilot。Agent 负责生成 Typed JSON IR，Archify 再校验并确定性编译为便携、独立的 HTML/SVG 成品。
+Archify 是一套基于 Node.js 的渲染与校验系统，并以 Agent Skill 的形式支持 Raven、Cursor、Claude Code、Codex CLI、OpenCode、GitHub Copilot 和 WorkBuddy。Agent 负责生成 Typed JSON IR，Archify 再校验并确定性编译为便携、独立的 HTML/SVG 成品。
 
 - **打开就是成品** —— 五种技术图、四套视觉预设、深浅主题、内置品牌徽标，以及显式启用的有限动态
 - **合并前先看清架构变化** —— 把两份已校验快照对比为 Before / Delta / After，准确区分新增、删除、语义变化、移动和重路由

diff --git a/archify/test/cursor-onboarding.test.mjs b/archify/test/cursor-onboarding.test.mjs
@@ -19,8 +19,8 @@ test('Cursor onboarding stays explicit, bilingual, and backed by the same Skill'
   const landing = fs.readFileSync(path.join(repoRoot, 'docs', 'index.html'), 'utf8');
 
   assert.equal(english, englishMirror, 'English README mirrors must stay synchronized');
-  assert.match(english, /Cursor, Claude Code, Codex CLI, OpenCode, and GitHub Copilot/);
-  assert.match(chinese, /Cursor、Claude Code、Codex CLI、OpenCode 和 GitHub Copilot/);
+  assert.match(english, /Cursor, Claude Code, Codex CLI, OpenCode, GitHub Copilot, and WorkBuddy/);
+  assert.match(chinese, /Cursor、Claude Code、Codex CLI、OpenCode、GitHub Copilot 和 WorkBuddy/);
   for (const surface of [english, chinese, landing]) assert.ok(surface.includes(cursorCommand));
   for (const surface of [english, chinese, start, landing]) {
     assert.doesNotMatch(surface, /skills use[^\n<]*--agent cursor/);
@@ -39,6 +39,86 @@ test('Cursor onboarding stays explicit, bilingual, and backed by the same Skill'
   assert.doesNotMatch(start, /vendor-specific (?:renderer|schema|skill)/i);
 });
 
+// The generated switcher's current membership. GitHub Copilot joined in #288, so this
+// baseline tracks the five tabs the Start surface actually ships today. WorkBuddy is
+// deliberately absent: it is a manual-copy instruction, not a generated switcher tab.
+const switcherAgents = ['cursor', 'codex', 'claude-code', 'opencode', 'github-copilot'];
+
+test('WorkBuddy is documented on the Start surface but stays outside the agent switcher', () => {
+  const english = fs.readFileSync(path.join(repoRoot, 'README.md'), 'utf8');
+  const chinese = fs.readFileSync(path.join(repoRoot, 'README_ZH.md'), 'utf8');
+  const landing = fs.readFileSync(path.join(repoRoot, 'docs', 'index.html'), 'utf8');
+  const template = fs.readFileSync(path.join(repoRoot, 'scripts', 'start-template.html'), 'utf8');
+  const start = fs.readFileSync(path.join(repoRoot, 'docs', 'start.html'), 'utf8');
+
+  // The canonical template and the checked-in generated page must agree: both carry
+  // the bilingual WorkBuddy manual-install instruction and its exact destination.
+  for (const [surface, label] of [
+    [template, 'scripts/start-template.html'],
+    [start, 'docs/start.html'],
+  ]) {
+    assert.match(
+      surface,
+      /data-en="WorkBuddy is supported by copying the skill into your WorkBuddy skills directory/,
+      `${label}: English WorkBuddy instruction must stay on the Start surface`,
+    );
+    assert.match(
+      surface,
+      /data-zh="WorkBuddy 采用手动复制到技能目录的方式安装/,
+      `${label}: Chinese WorkBuddy instruction must stay on the Start surface`,
+    );
+
+    // Exact documented destination: once in the English copy, once in the Chinese
+    // copy, and once as the visible text a reader can select.
+    const destinations = surface.match(/~\/\.workbuddy\/skills\/archify/g) ?? [];
+    assert.equal(
+      destinations.length,
+      3,
+      `${label}: ~/.workbuddy/skills/archify must appear in the English copy, the Chinese copy, and the visible text`,
+    );
+
+    // Switcher boundary: WorkBuddy is documented, never a generated tab.
+    assert.doesNotMatch(
+      surface,
+      /data-agent="workbuddy"/,
+      `${label}: WorkBuddy must not become an agent-switcher tab`,
+    );
+    const tabs = [...surface.matchAll(/data-agent="([a-z-]+)">/g)].map((match) => match[1]);
+    assert.deepEqual(
+      tabs,
+      switcherAgents,
+      `${label}: the switcher must stay exactly the supported agents, with WorkBuddy excluded`,
+    );
+
+    const knownAgents = /var KNOWN_AGENTS = new Set\(\[([^\]]*)\]\)/.exec(surface);
+    assert.ok(knownAgents, `${label}: KNOWN_AGENTS must stay readable`);
+    const parsed = knownAgents[1]
+      .split(',')
+      .map((entry) => entry.trim().replace(/^'|'$/g, ''))
+      .filter(Boolean);
+    assert.deepEqual(
+      parsed,
+      switcherAgents,
+      `${label}: KNOWN_AGENTS must stay exactly the supported agents, with WorkBuddy excluded`,
+    );
+  }
+
+  // Listing a platform must not imply a generated switcher command exists for it.
+  for (const [surface, label] of [
+    [english, 'README.md'],
+    [chinese, 'README_ZH.md'],
+    [template, 'scripts/start-template.html'],
+    [start, 'docs/start.html'],
+    [landing, 'docs/index.html'],
+  ]) {
+    assert.doesNotMatch(
+      surface,
+      /--agent workbuddy/,
+      `${label}: no generated agent-switcher command may be claimed for WorkBuddy`,
+    );
+  }
+});
+
 test('the zero-dependency archive works from the canonical Cursor-visible agent path', () => {
   const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'archify-cursor-package-'));
   const agentSkills = path.join(tmp, '.agents', 'skills');

diff --git a/archify/test/landing.test.mjs b/archify/test/landing.test.mjs
@@ -29,7 +29,7 @@ const proofs = [
 test('landing metadata describes the full technical-diagram product and trusted hero promise', () => {
   assert.match(landing, /<title>Archify — Technical Diagrams from Plain English<\/title>/);
   assert.match(landing, /<meta property="og:title" content="Archify — Technical Diagrams from Plain English">/);
-  assert.match(landing, /An agent skill for Cursor, Claude Code, Codex CLI, OpenCode, and GitHub Copilot/);
+  assert.match(landing, /An agent skill for Cursor, Claude Code, Codex CLI, OpenCode, GitHub Copilot, and WorkBuddy/);
   assert.equal((landing.match(/npx -y skills add tt-a1i\/archify --skill archify --agent cursor --global --copy --yes/g) || []).length, 2);
   assert.match(landing, /From plain English<br>to architecture <em>you can trust\.<\/em>/);
 });

diff --git a/docs/index.html b/docs/index.html
@@ -4,7 +4,7 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Archify — Technical Diagrams from Plain English</title>
-  <meta name="description" content="An agent skill for Cursor, Claude Code, Codex CLI, OpenCode, and GitHub Copilot that turns plain-English descriptions into polished, explorable, self-contained technical diagrams with semantic focus, motion, and crisp export.">
+  <meta name="description" content="An agent skill for Cursor, Claude Code, Codex CLI, OpenCode, GitHub Copilot, and WorkBuddy that turns plain-English descriptions into polished, explorable, self-contained technical diagrams with semantic focus, motion, and crisp export.">
   <meta name="theme-color" content="#eff2f1">
   <link rel="icon" type="image/svg+xml" href="data:image/svg+xml;utf8,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 28 28'><polygon points='14,2 26,8 26,20 14,26 2,20 2,8' fill='%23083344' stroke='%2322d3ee' stroke-width='1.5'/><circle cx='14' cy='15' r='2.5' fill='%2322d3ee'/></svg>">
 

diff --git a/docs/start.html b/docs/start.html
diff --git a/scripts/start-template.html b/scripts/start-template.html
@@ -249,6 +249,7 @@ <h2 data-en="Keep the tool local." data-zh="让工具留在本地。">Keep the t
           <pre id="project-command">npx -y skills add tt-a1i/archify --skill archify --agent codex --copy --yes</pre>
         </div>
         <p class="secondary-note" data-en="Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify." data-zh="Raven 采用 ZIP 手动安装，不使用 Agent 切换器生成命令。将 archify.zip 解压到 ~/.raven/workspace/skills，解压后会得到 ~/.raven/workspace/skills/archify。">Raven is supported through a manual ZIP installation, not a generated agent-switcher command. Extract archify.zip into ~/.raven/workspace/skills, which yields ~/.raven/workspace/skills/archify.</p>
+        <p class="secondary-note" data-en="WorkBuddy is supported by copying the skill into your WorkBuddy skills directory, not a generated agent-switcher command. Copy the repository's archify/ folder (SKILL.md and assets) into ~/.workbuddy/skills/archify." data-zh="WorkBuddy 采用手动复制到技能目录的方式安装，不使用 Agent 切换器生成命令。将仓库中的 archify/ 目录（含 SKILL.md 与 assets）复制到 ~/.workbuddy/skills/archify。">WorkBuddy is supported by copying the skill into your WorkBuddy skills directory, not a generated agent-switcher command. Copy the repository's archify/ folder (SKILL.md and assets) into ~/.workbuddy/skills/archify.</p>
         <p class="secondary-note" data-en="The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded." data-zh="Start 链接只携带 Agent、语言、图表类型、输入模式和粗粒度来源标签。转化步骤只保存在当前浏览器会话中，Archify 不会发送这些数据，也不会记录仓库路径、标题、节点、关系或源 JSON。">The Start link carries only your agent, language, diagram type, input mode, and a coarse source label. Journey events stay in this browser session and are never sent by Archify. No repository path, title, node, relationship, or source JSON is recorded.</p>
       </article>