Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

docs(website): clarify agent diagram positioning and project identity

tt-a1ibc57232dec43
diff --git a/website/src/components/ProductFacts.astro b/website/src/components/ProductFacts.astro
index 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.mjs
index 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.mjs
index 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.astro
index 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.mjs
index 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}`);
+ }
+ });
+}