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
docs(website): clarify agent diagram positioning and project identity
tt-a1ibc57232dec43
diff --git a/website/src/components/ProductFacts.astro b/website/src/components/ProductFacts.astroindex 2f7a70e7..48c90929 100644--- a/website/src/components/ProductFacts.astro+++ b/website/src/components/ProductFacts.astro@@ -1,8 +1,10 @@---+import { canonicalUrl } from '../data/site-urls.mjs';+const facts = [{question: ['What is Archify?', 'Archify 是什么?'],- answer: ['Archify is an open-source Agent Skill for turning a system, process, or plan into a diagram. The agent authors typed JSON, then Archify renders and validates a self-contained interactive HTML artifact. The Skill and renderers are licensed under MIT.', 'Archify 是一个开源 Agent Skill,把系统、流程或计划变成图表。Agent 编写类型化 JSON,再由 Archify 渲染、校验并交付独立的交互 HTML 成品。Skill 和渲染器采用 MIT 许可证。'],+ answer: ['Archify is an open-source Agent Skill for AI-assisted diagramming in coding agents such as Claude Code and Codex. It turns descriptions of a system, process, or plan into architecture, workflow, sequence, and other structured diagrams. The agent authors typed JSON, then Archify renders and validates a self-contained interactive HTML artifact. The Skill and renderers are licensed under MIT.', 'Archify 是面向 Claude Code、Codex 等 Coding Agent 的开源画图工具,以 Agent Skill 的形式使用。它把系统、流程或计划的描述变成架构图、流程图、时序图等结构化图表。Agent 编写类型化 JSON,再由 Archify 渲染、校验并交付独立的交互 HTML 成品。Skill 和渲染器采用 MIT 许可证。'],},{question: ['What can I provide as input?', '可以提供哪些输入?'],@@ -14,13 +16,14 @@ const facts = [},{question: ['What do I receive, and what are the limits?', '会得到什么?有哪些边界?'],- answer: ['The primary deliverable is an HTML file with inline SVG and its typed JSON source. Open the HTML in a browser to inspect, search, trace routes, switch themes, and export. Validation checks the authored diagram; it does not prove runtime system behavior. Archify is not a hosted collaboration service or a general-purpose WYSIWYG editor.', '主要交付物是内含 SVG 的 HTML 文件和类型化 JSON 源。在浏览器里可以检查、搜索、追踪路径、切换主题和导出。校验检查的是编写出的图表,不证明系统的实际运行行为。Archify 不提供托管协作服务,也不是通用的所见即所得编辑器。'],+ answer: ['The primary deliverable is an HTML file with inline SVG and its typed JSON source. Open the HTML in a browser to inspect, search, trace routes, switch themes, and export. Validation checks the authored diagram; it does not prove runtime system behavior. Archify is for structured diagrams, not photo or illustration generation. It is not a hosted collaboration service or a general-purpose WYSIWYG editor.', '主要交付物是内含 SVG 的 HTML 文件和类型化 JSON 源。在浏览器里可以检查、搜索、追踪路径、切换主题和导出。校验检查的是编写出的图表,不证明系统的实际运行行为。Archify 用于结构化图表,不用于生成照片或插画;它不提供托管协作服务,也不是通用的所见即所得编辑器。'],},];---<section class="product-facts" id="about-archify" aria-labelledby="product-facts-title"><div class="container"><div class="facts-heading"><span class="section-eyebrow" data-en="Product facts" data-zh="产品事实">Product facts</span><h2 id="product-facts-title" data-en="A diagram you can inspect and keep." data-zh="一张能检查、能保留的图。">A diagram you can inspect and keep.</h2></div>+ <p class="facts-identity"><span data-en="This Archify is the open-source diagram skill at " data-zh="这里的 Archify 指 ">This Archify is the open-source diagram skill at </span><a href={canonicalUrl('index')}>archify.si</a><span data-en=", maintained in the " data-zh=" 上的开源画图技能,项目源码位于 ">, maintained in the </span><a href="https://github.com/tt-a1i/archify">tt-a1i/archify</a><span data-en=" repository." data-zh=" 仓库。"> repository.</span></p><div class="facts-grid">{facts.map(fact => <article><h3 data-en={fact.question[0]} data-zh={fact.question[1]}>{fact.question[0]}</h3><p data-en={fact.answer[0]} data-zh={fact.answer[1]}>{fact.answer[0]}</p></article>)}</div>diff --git a/website/src/data/site-metadata.mjs b/website/src/data/site-metadata.mjsindex 7674b42e..ddf463a4 100644--- a/website/src/data/site-metadata.mjs+++ b/website/src/data/site-metadata.mjs@@ -1,8 +1,8 @@import { canonicalUrl, canonicalOrigin } from './site-urls.mjs';const descriptions = {index: {- en: ['Archify — AI Agent Skill for Interactive Diagrams', 'Archify is an MIT-licensed AI agent skill for validated HTML diagrams from descriptions or code, with interactive exploration and browser export.'],- zh: ['Archify — 用自然语言生成交互式图表', 'Archify 是采用 MIT 许可证的 AI Agent 技能,可从自然语言或源码生成经过验证的独立 HTML 图表,支持交互探索与浏览器导出。'],+ en: ['Archify — Interactive Diagram Skill for AI Coding Agents', 'Create architecture, workflow, and sequence diagrams with Claude Code, Codex, or other coding agents. Archify is an MIT-licensed skill that delivers interactive HTML.'],+ zh: ['Archify — 面向 AI Agent 的交互式画图工具', '用 Claude Code、Codex 等 AI Agent 从自然语言或代码仓库创建架构图、流程图和时序图。Archify 是采用 MIT 许可证的开源画图 Skill,交付可探索、可导出的交互式 HTML。'],},guide: {en: ['Archify Scenario Guide — Choose the Right Diagram', 'Choose an Archify diagram recipe for your question. Browse evidence checklists, use cases, boundaries, and prompts linked to the recipe source.'],diff --git a/website/src/data/site-translations.mjs b/website/src/data/site-translations.mjsindex f7a8ec77..c0078aca 100644--- a/website/src/data/site-translations.mjs+++ b/website/src/data/site-translations.mjs@@ -19,8 +19,8 @@ export const indexCopy = {'life-k':'Lifecycle','nav-guide':'Guide','nav-gallery':'Proof Lab','nav-start':'Get started','nav-community':'Community','nav-install':'Install Skill','hero-badge':"Development Agent Skill · see what's new",'hero-works':'Works with',- 'hero-h1':'<span class="l">Describe it in plain words.</span><span class="l">Get a map <em>you can trust.</em></span>',- 'hero-sub':'A leave plan, a job hunt, a monthly budget, or a software system — if it has steps, parts, relationships, or states, your AI agent turns it into one explorable HTML map, validated before it ships.',+ 'hero-h1':'<span class="l">Draw diagrams.</span><span class="l">With your <em>AI agent.</em></span>',+ 'hero-sub':'Archify is an open-source diagram skill for coding agents. Describe a system or workflow, or ask your agent to read a repository: create architecture, workflow, and sequence diagrams as interactive HTML you can explore and share.','hero-cta':'Get started','hero-stars':'stars on GitHub','copy':'Copy','copied':'Copied','demo-watch':'Watch the 35s demo','demo-title':'Archify 35-second demo','demo-close':'Close demo','tour-title':'Live artifact tour',@@ -101,8 +101,8 @@ export const indexCopy = {'life-k':'生命周期','nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'开始使用','nav-community':'社区包','nav-install':'安装技能','hero-badge':'开发版 Agent 技能 · 查看更新','hero-works':'支持',- 'hero-h1':'<span class="l">用大白话讲清楚,</span><span class="l">得到<em>一张可信的图。</em></span>',- 'hero-sub':'年假怎么排、求职走到哪步、工资去哪了,或者一整套软件系统——只要它有步骤、组成、关系或状态,你的 AI Agent 都能把它变成一张可以点开探索、交付前已经校验过的 HTML 图。',+ 'hero-h1':'<span class="l">让你的 AI Agent</span><span class="l">画出<em>清晰的图。</em></span>',+ 'hero-sub':'Archify 是面向 Coding Agent 的开源画图工具(Agent Skill)。用自然语言描述系统或流程,或让 Agent 阅读代码仓库,生成架构图、流程图和时序图,交付可探索、可分享的交互式 HTML。','hero-cta':'开始使用','hero-stars':'GitHub Star','copy':'复制','copied':'已复制','demo-watch':'观看 35 秒演示','demo-title':'Archify 35 秒演示','demo-close':'关闭演示','tour-title':'实时成品导览',diff --git a/website/src/pages/index.astro b/website/src/pages/index.astroindex 0e493a37..b25c37e1 100644--- a/website/src/pages/index.astro+++ b/website/src/pages/index.astro@@ -28,8 +28,8 @@ const { lang = 'en' } = Astro.props;<span data-i18n="hero-badge">Development Agent Skill · see what's new</span><span class="eyebrow-arrow" aria-hidden="true">→</span></a>- <h1 data-i18n="hero-h1"><span class="l">Describe it in plain words.</span><span class="l">Get a map <em>you can trust.</em></span></h1>- <p class="hero-sub fade-up d2" data-i18n="hero-sub">A leave plan, a job hunt, a monthly budget, or a software system — if it has steps, parts, relationships, or states, your AI agent turns it into one explorable HTML map, validated before it ships.</p>+ <h1 data-i18n="hero-h1"><span class="l">Draw diagrams.</span><span class="l">With your <em>AI agent.</em></span></h1>+ <p class="hero-sub fade-up d2" data-i18n="hero-sub">Archify is an open-source diagram skill for coding agents. Describe a system or workflow, or ask your agent to read a repository: create architecture, workflow, and sequence diagrams as interactive HTML you can explore and share.</p><div class="hero-actions fade-up d3"><div class="cmd-chip"><span class="cmd-prompt" aria-hidden="true">$</span>@@ -110,7 +110,7 @@ const { lang = 'en' } = Astro.props;<!-- PROOF STRIP — receipts, not adjectives --><section class="receipts" aria-label="Archify at a glance"><div class="container receipts-row">- <div class="receipt fade-up"><b>5</b><span data-i18n="stat-types">Diagram types</span></div>+ <div class="receipt fade-up"><b>10</b><span data-i18n="stat-types">Diagram types</span></div><div class="receipt fade-up d1"><b>4</b><span data-i18n="stat-presets">Visual presets</span></div><div class="receipt fade-up d2"><b>9/9</b><span data-i18n="stat-checks">Validation checks per artifact</span></div><div class="receipt fade-up d3"><b>4×</b><span data-i18n="stat-export">Native export scale</span></div>diff --git a/website/test/seo-content.test.mjs b/website/test/seo-content.test.mjsindex 48420e26..ffe58b12 100644--- a/website/test/seo-content.test.mjs+++ b/website/test/seo-content.test.mjs@@ -95,3 +95,32 @@ for (const lang of ['en', 'zh']) {}});}++for (const lang of ['en', 'zh']) {+ test(`initial ${lang} homepage identifies agent diagramming before JavaScript`, () => {+ const page = read('index', lang);+ const hero = byClass(page, 'hero-copy')[0];+ const heading = clean(text(byTag(hero, 'h1')));+ const lead = clean(text(byClass(hero, 'hero-sub')[0]));+ assert.match(heading, /AI agent|AI Agent/);+ assert.match(heading, /diagrams|图/);+ for (const concept of lang === 'zh'+ ? ['开源', 'Agent Skill', '架构图', '流程图', '时序图', '代码仓库', '交互式 HTML']+ : ['open-source', 'skill', 'architecture', 'workflow', 'sequence', 'repository', 'interactive HTML']) {+ assert.ok(lead.includes(concept), `hero must explain ${concept}`);+ }+ const identity = byClass(page, 'facts-identity')[0];+ const identityText = clean(text(identity));+ assert.ok(identityText.includes(lang === 'zh' ? '开源画图技能' : 'open-source diagram skill'));+ assert.deepEqual(links(identity).map(link => [clean(text(link)), attr(link, 'href')]), [+ ['archify.si', 'https://archify.si/'],+ ['tt-a1i/archify', 'https://github.com/tt-a1i/archify'],+ ], 'visible product identity connects the official site and exact source repository');+ const facts = clean(text(find(page, 'about-archify')));+ for (const boundary of lang === 'zh'+ ? ['类型化 JSON', '不证明系统的实际运行行为', '不用于生成照片或插画']+ : ['typed JSON', 'does not prove runtime system behavior', 'not photo or illustration generation']) {+ assert.ok(facts.includes(boundary), `product facts must explain ${boundary}`);+ }+ });+}