Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
release: prepare v2.11.0
tt-a1ied0efcc763d3
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex cfaf444d..a4b7dc57 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -4,6 +4,8 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo## [Unreleased]+## [2.11.0] — 2026-07-16+### Added- **Zero-install schema validation.** All five JSON Schemas are compiled at development time into committed standalone ESM validators. Installed skills now enforce the full schema contract without `npm install`, `node_modules`, or a network connection; CI verifies the packaged ZIP rejects invalid input in this dependency-free state.- **First-run CLI commands.** `archify doctor` checks the installed runtime surface, and `archify demo [output-directory]` generates a ready-to-open example plus the next render command.@@ -11,6 +13,9 @@ All notable changes are documented here. Format loosely follows [Keep a Changelo### Changed- **60-second quick start.** README and GitHub Pages now lead with `npx skills add tt-a1i/archify -g`, a temporary `skills use` path, and three copy-ready prompts before the manual ZIP instructions.+### Fixed+- **Packaged CLI and validation hardening ([#21](https://github.com/tt-a1i/archify/pull/21)).** Installed ZIPs now keep `archify examples` on the packaged path, enforce standalone schema validation without development dependencies, and cover the clean-consumer CLI flow in CI. Thanks to [@ShiroKSH](https://github.com/ShiroKSH).+## [2.10.0] — 2026-07-05### Addeddiff --git a/README.md b/README.mdindex ada380a1..4e1f2748 100644--- a/README.md+++ b/README.md@@ -27,7 +27,7 @@ Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain--+**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)diff --git a/README_EN.md b/README_EN.mdindex ada380a1..4e1f2748 100644--- a/README_EN.md+++ b/README_EN.md@@ -27,7 +27,7 @@ Archify is an agent skill for Claude, Codex CLI, and opencode. It turns a plain--+**Project page:** [tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)diff --git a/README_ZH.md b/README_ZH.mdindex 551d0f91..a327db54 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -23,7 +23,7 @@ Archify 是一个可用于 Claude、Codex CLI 和 opencode 的 agent skill:你-+**[在线落地页 → tt-a1i.github.io/archify](https://tt-a1i.github.io/archify/)**diff --git a/archify.zip b/archify.zipindex 6f3802ed..e0ccf975 100644Binary files a/archify.zip and b/archify.zip differdiff --git a/archify/SKILL.md b/archify/SKILL.mdindex 515fbe47..f927aa8b 100644--- a/archify/SKILL.md+++ b/archify/SKILL.md@@ -3,7 +3,7 @@ name: archifydescription: Create professional architecture, workflow, sequence, data-flow, and lifecycle/state diagrams as standalone HTML files with SVG graphics, a built-in dark/light theme toggle, and one-click export to PNG / JPEG / WebP / SVG. Accepts plain-language descriptions or pasted Mermaid code (flowchart, sequenceDiagram, stateDiagram) and lays the diagram out from scratch in archify style. Use when the user asks for system architecture diagrams, infrastructure diagrams, cloud architecture visualizations, security diagrams, network topology, technical workflows, approval flows, runbooks, CI/CD flows, process diagrams, API call sequences, request lifecycles, data pipelines, ETL/ELT maps, PII boundaries, data lineage, state machines, lifecycle diagrams, status transitions, or asks to convert/beautify a Mermaid diagram.license: MITmetadata:- version: "2.10"+ version: "2.11"author: tt-a1ibased_on: Cocoon-AI/architecture-diagram-generator (MIT, v1.0)---diff --git a/archify/assets/template.html b/archify/assets/template.htmlindex c1728c95..df9a810b 100644--- a/archify/assets/template.html+++ b/archify/assets/template.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>[PROJECT NAME] Architecture Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/archify/package-lock.json b/archify/package-lock.jsonindex 085d174b..a2bf5deb 100644--- a/archify/package-lock.json+++ b/archify/package-lock.json@@ -1,12 +1,12 @@{"name": "archify",- "version": "2.10.0",+ "version": "2.11.0","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "archify",- "version": "2.10.0",+ "version": "2.11.0","license": "MIT","bin": {"archify": "bin/archify.mjs"diff --git a/archify/package.json b/archify/package.jsonindex 0acee1b0..de318812 100644--- a/archify/package.json+++ b/archify/package.json@@ -1,6 +1,6 @@{"name": "archify",- "version": "2.10.0",+ "version": "2.11.0","private": true,"type": "module","description": "JSON-IR diagram renderers (architecture / workflow / sequence / dataflow / lifecycle).",diff --git a/archify/test/golden.mjs b/archify/test/golden.mjsindex 19d03f99..8a3f8303 100644--- a/archify/test/golden.mjs+++ b/archify/test/golden.mjs@@ -145,6 +145,19 @@ check('SKILL.md metadata version matches package.json major.minor',!!skillVersion && pkg.version.startsWith(skillVersion),`SKILL.md says ${skillVersion}, package.json says ${pkg.version}`);+for (const readmeName of ['README.md', 'README_EN.md', 'README_ZH.md']) {+ const readme = fs.readFileSync(path.join(repoRoot, readmeName), 'utf8');+ check(`${readmeName} badge matches package.json version`,+ readme.includes(`/badge/version-${pkg.version}-`),+ `${readmeName} does not advertise ${pkg.version}`);+}++const landingPage = fs.readFileSync(path.join(repoRoot, 'docs/index.html'), 'utf8');+const landingVersions = [...landingPage.matchAll(/\bv\d+\.\d+\.\d+\b/g)].map((m) => m[0]);+check('GitHub Pages version labels match package.json',+ landingVersions.length > 0 && landingVersions.every((v) => v === `v${pkg.version}`),+ `landing page says ${[...new Set(landingVersions)].join(', ') || '(no version)'}`);+// ---------------------------------------------------------------------------fs.rmSync(tmp, { recursive: true, force: true });if (failures) {diff --git a/docs/index.html b/docs/index.htmlindex a13bfb77..fdaa90b4 100644--- a/docs/index.html+++ b/docs/index.html@@ -216,7 +216,7 @@<div class="container"><div class="hero-badge fade-up"><div class="pulse-dot"></div>- <span data-i18n="hero-badge">Agent Skill · v2.10.0</span>+ <span data-i18n="hero-badge">Agent Skill · v2.11.0</span></div><h1 class="fade-up d1" data-i18n="hero-h1">From plain English<br>to architecture <em>in seconds.</em></h1><p class="hero-sub fade-up d2" data-i18n="hero-sub">Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.</p>@@ -567,7 +567,7 @@ npx skills use tt-a1i/archify@archify --agent codex<svg width="22" height="22" viewBox="0 0 28 28" fill="none"><polygon points="14,2 26,8 26,20 14,26 2,20 2,8" fill="rgba(8,51,68,0.7)" stroke="#22d3ee" stroke-width="1.5"/><circle cx="14" cy="15" r="2.5" fill="#22d3ee"/></svg><span style="font-size:.8125rem;font-weight:700;color:var(--muted)">Archify</span></a>- <p class="footer-meta" data-i18n="footer-meta">v2.10.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator</p>+ <p class="footer-meta" data-i18n="footer-meta">v2.11.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator</p></div><div class="footer-links"><a href="https://github.com/tt-a1i/archify" target="_blank" rel="noopener">GitHub</a>@@ -584,7 +584,7 @@ npx skills use tt-a1i/archify@archify --agent codexconst LANGS = {en: {'nav-docs':'Docs','nav-install':'Install Skill',- 'hero-badge':'Agent Skill · v2.10.0',+ 'hero-badge':'Agent Skill · v2.11.0','hero-h1':'From plain English<br>to architecture <em>in seconds.</em>','hero-sub':'Describe your system in chat. Archify generates a polished, self-contained HTML diagram — with dark/light themes, clipboard copy, and ultra-crisp 4× export built in.','hero-cta':'Get started','hero-gh':'View on GitHub',@@ -635,12 +635,12 @@ npx skills use tt-a1i/archify@archify --agent codex'step3-h':'Ask your agent to draw it','step3-p':'Tell your agent to use Archify. It generates a self-contained HTML file you can open in any browser and refine in chat.','code-label':'example prompt','kbd-label':'Keyboard shortcuts','kbd-theme':'Toggle theme','kbd-export':'Open export menu','kbd-nav':'Navigate menu','kbd-close':'Close menu',- 'footer-meta':'v2.10.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator',+ 'footer-meta':'v2.11.0 · MIT License<br>Based on Cocoon-AI/architecture-diagram-generator','footer-changelog':'Changelog','footer-license':'License'},zh: {'nav-docs':'文档','nav-install':'安装技能',- 'hero-badge':'Agent 技能 · v2.10.0',+ 'hero-badge':'Agent 技能 · v2.11.0','hero-h1':'用自然语言,<br>秒级生成<em>架构图。</em>','hero-sub':'在对话中描述你的系统,Archify 生成精美、独立的 HTML 架构图——内置深色/浅色主题、一键复制剪贴板、超清 4× 图片导出。','hero-cta':'快速开始','hero-gh':'在 GitHub 查看',@@ -691,7 +691,7 @@ npx skills use tt-a1i/archify@archify --agent codex'step3-h':'让 agent 绘制','step3-p':'告诉 agent 使用 Archify,它会生成可在任意浏览器打开的单文件 HTML,并可继续在对话中迭代。','code-label':'示例提示词','kbd-label':'键盘快捷键','kbd-theme':'切换主题','kbd-export':'打开导出菜单','kbd-nav':'菜单导航','kbd-close':'关闭菜单',- 'footer-meta':'v2.10.0 · MIT 许可证<br>基于 Cocoon-AI/architecture-diagram-generator',+ 'footer-meta':'v2.11.0 · MIT 许可证<br>基于 Cocoon-AI/architecture-diagram-generator','footer-changelog':'更新日志','footer-license':'许可证'}};diff --git a/examples/dataflow-product-analytics.html b/examples/dataflow-product-analytics.htmlindex 0a819236..e4497134 100644--- a/examples/dataflow-product-analytics.html+++ b/examples/dataflow-product-analytics.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>Product Analytics Data Flow Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/lifecycle-agent-run.html b/examples/lifecycle-agent-run.htmlindex a14650ee..7e29368c 100644--- a/examples/lifecycle-agent-run.html+++ b/examples/lifecycle-agent-run.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>Agent Run Lifecycle Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/sequence-cache-miss-request.html b/examples/sequence-cache-miss-request.htmlindex d63145c7..02a6d42a 100644--- a/examples/sequence-cache-miss-request.html+++ b/examples/sequence-cache-miss-request.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>Cache Miss Request Sequence Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/web-app-rendered.html b/examples/web-app-rendered.htmlindex a13e4cd0..55c9bb8c 100644--- a/examples/web-app-rendered.html+++ b/examples/web-app-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>Sample Web App Diagram</title><script>// Resolve the theme before first paint so light-preference users don'tdiff --git a/examples/workflow-agent-tool-call-rendered.html b/examples/workflow-agent-tool-call-rendered.htmlindex 95673fad..ffa94cd4 100644--- a/examples/workflow-agent-tool-call-rendered.html+++ b/examples/workflow-agent-tool-call-rendered.html@@ -3,7 +3,7 @@<head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0">- <meta name="generator" content="archify 2.10.0">+ <meta name="generator" content="archify 2.11.0"><title>Agent Tool Call Workflow Diagram</title><script>// Resolve the theme before first paint so light-preference users don't