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
merge: integrate latest main website fixes into dev promotion
tt-a1i2722561e5ec9
diff --cc README.mdindex aea940dd,a87d57df..87c949dd--- a/README.md+++ b/README.md@@@ -75,26 -75,8 +75,26 @@@ Then continue: “Add authentication”**No repository is required:** start with a description, or ask your agent to read a repository for a source-backed architecture diagram.- [Choose your agent](https://archify.si/start.html?agent=cursor&type=architecture) · [Installation details and update checks](#quick-start)+ [Choose your agent](https://archify.si/start.html?agent=cursor&type=architecture) · [Installation details and update checks](#quick-start) · [Create and check diagrams with your agent](https://archify.si/agent-diagrams)+## Ask a question, get a one-page answer++Not every answer is one diagram. Ask your agent to answer as a page and Archify builds an **explainer**: the conclusion first, then one panel per question, with tables, steps, charts, code and validated diagrams.++[](https://archify.si/cases/explainer/tls-first-visit.html)++- **Conclusion first.** The answer and its reasons lead; every panel takes one question.+- **Diagrams that explain.** Steps sit beside the diagram they walk through and light its parts as you read. Click any node to open the full interactive view.+- **Easy to check.** Claims cite numbered sources; repository excerpts are pinned to a commit and open in a source card.+- **Easy to share.** One HTML file with four styles and light or dark themes. Export a PNG, WebP or JPG long image, or print to PDF. Ask about any panel to get a follow-up your agent can use to revise just that panel.++```text+Use Archify to answer as one page: our API's P99 went from 80 ms to 600 ms+while the mean barely moved. What is the likely cause, and how should we investigate?+```++Live examples: [First HTTPS visit](https://archify.si/cases/explainer/tls-first-visit.html) · [P99 latency (Chinese)](https://archify.si/cases/explainer/p99-tail-latency.html) · [How Archify finalize keeps the last good file, read from this repository (Chinese)](https://archify.si/cases/explainer/finalize-delivery.html) · [First rental checklist (Chinese)](https://archify.si/cases/explainer/first-rental.html)+<a id="sponsors"></a>## ❤️ Sponsorsdiff --cc README_EN.mdindex aea940dd,a87d57df..87c949dd--- a/README_EN.md+++ b/README_EN.md@@@ -75,26 -75,8 +75,26 @@@ Then continue: “Add authentication”**No repository is required:** start with a description, or ask your agent to read a repository for a source-backed architecture diagram.- [Choose your agent](https://archify.si/start.html?agent=cursor&type=architecture) · [Installation details and update checks](#quick-start)+ [Choose your agent](https://archify.si/start.html?agent=cursor&type=architecture) · [Installation details and update checks](#quick-start) · [Create and check diagrams with your agent](https://archify.si/agent-diagrams)+## Ask a question, get a one-page answer++Not every answer is one diagram. Ask your agent to answer as a page and Archify builds an **explainer**: the conclusion first, then one panel per question, with tables, steps, charts, code and validated diagrams.++[](https://archify.si/cases/explainer/tls-first-visit.html)++- **Conclusion first.** The answer and its reasons lead; every panel takes one question.+- **Diagrams that explain.** Steps sit beside the diagram they walk through and light its parts as you read. Click any node to open the full interactive view.+- **Easy to check.** Claims cite numbered sources; repository excerpts are pinned to a commit and open in a source card.+- **Easy to share.** One HTML file with four styles and light or dark themes. Export a PNG, WebP or JPG long image, or print to PDF. Ask about any panel to get a follow-up your agent can use to revise just that panel.++```text+Use Archify to answer as one page: our API's P99 went from 80 ms to 600 ms+while the mean barely moved. What is the likely cause, and how should we investigate?+```++Live examples: [First HTTPS visit](https://archify.si/cases/explainer/tls-first-visit.html) · [P99 latency (Chinese)](https://archify.si/cases/explainer/p99-tail-latency.html) · [How Archify finalize keeps the last good file, read from this repository (Chinese)](https://archify.si/cases/explainer/finalize-delivery.html) · [First rental checklist (Chinese)](https://archify.si/cases/explainer/first-rental.html)+<a id="sponsors"></a>## ❤️ Sponsorsdiff --cc README_ZH.mdindex 19cff807,82e4b34c..29d4e34c--- a/README_ZH.md+++ b/README_ZH.md@@@ -75,26 -75,8 +75,26 @@@ API 优先读取 Redis,缓存未命�**不需要绑定代码库:**从描述开始即可。也可以让 Agent 阅读仓库,生成有源码依据的架构图。- [按 Agent 选择安装方式](https://archify.si/zh/start?agent=cursor&type=architecture) · [安装细节与更新检查](#快速开始)+ [按 Agent 选择安装方式](https://archify.si/zh/start?agent=cursor&type=architecture) · [安装细节与更新检查](#快速开始) · [用 Agent 画图并检查结果](https://archify.si/zh/agent-diagrams)+## 问一个问题,得到一页讲清楚的答案++不是每个答案都是一张图。让 agent 用一页来回答,Archify 会生成一份 **explainer**:先给结论,再按问题分成几个面板,用表格、步骤、图表、代码和经过校验的图把理由讲清楚。++[](https://archify.si/cases/explainer/p99-tail-latency.html)++- **结论先行。** 先写答案和理由,每个面板只回答一个问题。+- **图和文字一起讲。** 步骤放在它讲解的图旁边,读到哪一步,图上就亮起哪一部分;点任意节点进入完整的交互图。+- **能核对。** 结论标注编号来源;仓库代码固定到具体提交,悬停即可看到原文。+- **好分享。** 一个 HTML 文件,四种样式,浅色深色都有;可导出 PNG、WebP、JPG 长图或打印成 PDF。对任何面板都能追问,生成的追问让 agent 只改这一块。++```text+用 Archify 一页回答:接口 P99 从 80 ms 涨到 600 ms,平均值几乎没变,+可能是什么原因,应该怎么排查?+```++在线示例:[P99 延迟排查](https://archify.si/cases/explainer/p99-tail-latency.html) · [读 Archify 仓库:finalize 怎么保住旧产物](https://archify.si/cases/explainer/finalize-delivery.html) · [第一次租房要确认什么](https://archify.si/cases/explainer/first-rental.html) · [第一次打开 HTTPS 网站(英文)](https://archify.si/cases/explainer/tls-first-visit.html)+<a id="sponsors"></a>## ❤️ 赞助伙伴diff --cc website/src/components/ProductFacts.astroindex ace6e110,48c90929..c558b704--- a/website/src/components/ProductFacts.astro+++ b/website/src/components/ProductFacts.astro@@@ -18,13 -16,14 +20,14 @@@ const facts =},{question: ['What do I receive, and what are the limits?', '会得到什么?有哪些边界?'],- answer: ['The primary deliverable is a self-contained HTML file with its source: typed JSON for diagrams or a Markdown draft for one-page answers. Open it in a browser to explore and export; available interactions depend on the artifact type. Validation checks the authored artifact, not the truth of every claim or runtime system behavior. Archify is not a hosted collaboration service or a general-purpose WYSIWYG editor.', '主要交付物是独立 HTML 文件及其源稿:图表使用类型化 JSON,一页式解答使用 Markdown 草稿。在浏览器里可以浏览和导出,具体交互取决于成品类型。校验检查编写出的成品,不证明每项内容的真实性或系统的实际运行行为。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 用于结构化图表,不用于生成照片或插画;它不提供托管协作服务,也不是通用的所见即所得编辑器。'],++ answer: ['The primary deliverable is a self-contained HTML file with its source: typed JSON for diagrams or a Markdown draft for one-page answers. Open it in a browser to explore and export; available interactions depend on the artifact type. Validation checks the authored artifact, not the truth of every claim or runtime system behavior. Archify does not generate photos or illustrations. It is not a hosted collaboration service or a general-purpose WYSIWYG editor.', '主要交付物是独立 HTML 文件及其源稿:图表使用类型化 JSON,一页式解答使用 Markdown 草稿。在浏览器里可以浏览和导出,具体交互取决于成品类型。校验检查编写出的成品,不证明每项内容的真实性或系统的实际运行行为。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>+ <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 map or a page you can inspect and keep." data-zh="能检查、能保留的图和答案。">A map or a page 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 --cc website/src/data/site-metadata.mjsindex ff1ad8f0,b98bf61e..69b7b68b--- a/website/src/data/site-metadata.mjs+++ b/website/src/data/site-metadata.mjs@@@ -1,8 -1,16 +1,16 @@@import { canonicalUrl, canonicalOrigin } from './site-urls.mjs';const descriptions = {+ 'cases/mco-runtime': {+ en: ['Archify MCO Runtime Case — Source-backed Architecture', 'Follow pinned MCO source to distinguish provider-output decoding, streamed answer writes and retained artifacts. Read the existing Archify diagram with explicit evidence limits.'],+ zh: ['Archify MCO 运行时案例 — 对照源码阅读架构', '沿固定版本的 MCO 源码区分输出解码、流式答案写入与产物保留,结合已有 Archify 架构图理解职责、持久化条件与证据边界。'],+ },+ 'agent-diagrams': {+ en: ['Archify Agent Diagramming Guide — Author, Review, Share', 'Create diagrams with Claude Code, Codex, Cursor and other coding agents. Learn bounded prompts, repository evidence, review checks and safe HTML sharing with Archify.'],+ zh: ['Archify Agent 画图指南 — 编写、检查与分享', '用 Claude Code、Codex、Cursor 等 Coding Agent 画图:从范围明确的提示词和仓库证据开始,检查事实、修改图表,再安全分享 Archify HTML 成品。'],+ },index: {- 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。'],+ en: ['Archify — AI Agent Skill for Interactive Diagrams and One-Page Answers', 'Archify is an MIT-licensed AI agent skill for validated HTML diagrams and conclusion-first one-page answers from descriptions or code, with interactive exploration, cited sources and browser export.'],+ zh: ['Archify — 用自然语言生成交互式图表和一页式解答', 'Archify 是采用 MIT 许可证的 AI Agent 技能,可从自然语言或源码生成经过验证的独立 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 --cc website/src/data/site-translations.mjsindex a15b4e16,8969d6f7..1ec1eefe--- a/website/src/data/site-translations.mjs+++ b/website/src/data/site-translations.mjs@@@ -29,9 -19,9 +29,10 @@@ 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">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','copySuccess':'Copied to clipboard.','copyFailure':'Copy failed. Select the text manually.',+ 'hero-h1':'<span class="l">Ask in plain words.</span><span class="l">Get answers <em>you can trust.</em></span>',+ 'hero-sub':'A leave plan, a P99 spike, a first HTTPS visit, or a whole codebase — your AI agent answers with an explorable map, or a one-page answer that puts the conclusion first and cites its sources. Either way it is one HTML file, validated before it ships.',+ 'hero-cta':'Get started','hero-stars':'stars on GitHub','copy':'Copy','copied':'Copied',++ 'copySuccess':'Copied to clipboard.','copyFailure':'Copy failed. Select the text manually.','demo-watch':'Watch the 35s demo','demo-title':'Archify 35-second demo','demo-close':'Close demo','tour-title':'Live artifact tour','proof-live':'Live','proof-open':'Open artifact',@@@ -149,9 -101,9 +150,10 @@@'life-k':'生命周期','nav-guide':'场景指南','nav-gallery':'验证作品集','nav-start':'开始使用','nav-community':'社区包','nav-install':'安装技能','hero-badge':'开发版 Agent 技能 · 查看更新','hero-works':'支持',- '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':'已复制','copySuccess':'已复制到剪贴板。','copyFailure':'复制失败,请手动选择文本。',+ 'hero-h1':'<span class="l">用大白话问清楚,</span><span class="l">得到<em>可信的图和答案。</em></span>',+ 'hero-sub':'年假怎么排、P99 为什么暴涨、第一次打开 HTTPS 网站发生了什么,或者一整个代码仓库——你的 AI Agent 会给你一张可以点开探索的图,或者一页结论在前、标注出处的解答。都是一个 HTML 文件,交付前已经校验过。',+ 'hero-cta':'开始使用','hero-stars':'GitHub Star','copy':'复制','copied':'已复制',++ 'copySuccess':'已复制到剪贴板。','copyFailure':'复制失败,请手动选择文本。','demo-watch':'观看 35 秒演示','demo-title':'Archify 35 秒演示','demo-close':'关闭演示','tour-title':'实时成品导览','proof-live':'实时','proof-open':'打开完整成品',diff --cc website/src/styles/gallery.cssindex 36adfa4e,91391aac..fa867e3b--- a/website/src/styles/gallery.css+++ b/website/src/styles/gallery.css@@@ -236,11 -236,7 +236,11 @@@.life-lang { padding:.15rem .45rem; border-radius:999px; border:1px solid var(--line-hi); color:var(--text-2); }.life-kind { color:var(--accent); }.life-q { font-family:var(--font-title); font-size:1.125rem; font-weight:500; letter-spacing:-.02em; line-height:1.3; color:var(--text); text-wrap:balance; }- .life-links { display:flex; gap:.5rem; margin-top:auto; }+ .life-links { display:flex; flex-wrap:wrap; gap:.5rem; margin-top:auto; }+ /* a whole one-page answer on a tall plate; hover scrolls the page through it */+ .life-plate.page-plate { aspect-ratio:4 / 5; container-type:size; background:var(--surface,#fff); }+ .page-plate img { height:auto; padding:0; object-fit:initial; background:none; transition:transform 1.2s var(--ease-out); }+ .page-plate:hover img, .page-plate:focus-visible img { transform:translateY(calc(-100% + 100cqh)); transition:transform 7s cubic-bezier(.45,0,.4,1) .15s; }@media (max-width:1100px) { .life-grid { grid-template-columns:repeat(2,minmax(0,1fr)); } }@media (max-width:560px) { .life-grid { grid-template-columns:1fr; } }- @media (prefers-reduced-motion:reduce) { .life-plate:hover { transform:none; } }+ @media (prefers-reduced-motion:reduce) { .life-plate:hover, .page-plate:hover img, .page-plate:focus-visible img { transform:none; } }diff --cc website/test/seo-content.test.mjsindex 48420e26,ffcaf047..67ba65b8--- a/website/test/seo-content.test.mjs+++ b/website/test/seo-content.test.mjs@@@ -95,3 -95,55 +95,54 @@@ for (const lang of ['en', 'zh'])}});}++ for (const lang of ['en', 'zh']) {- test(`initial ${lang} homepage identifies agent diagramming before JavaScript`, () => {++ test(`initial ${lang} homepage explains diagrams and one-page answers 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|图/);++ assert.match(heading, lang === 'zh' ? /图和答案/ : /answers/);+ for (const concept of lang === 'zh'- ? ['开源', 'Agent Skill', '架构图', '流程图', '时序图', '代码仓库', '交互式 HTML']- : ['open-source', 'skill', 'architecture', 'workflow', 'sequence', 'repository', 'interactive HTML']) {++ ? ['AI Agent', '图', '解答', '结论', '出处', 'HTML', '校验']++ : ['AI agent', 'map', 'one-page answer', 'conclusion', 'sources', 'HTML', 'validated']) {+ 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']) {++ ? ['类型化 JSON', 'Markdown', '系统的实际运行行为', '不用于生成照片或插画']++ : ['typed JSON', 'Markdown', 'not the truth of every claim or runtime system behavior', 'does not generate photos or illustrations']) {+ assert.ok(facts.includes(boundary), `product facts must explain ${boundary}`);+ }+ });+ }++ for (const lang of ['en', 'zh']) {+ test(`initial ${lang} gallery states its evidence limit and offers generic life-diagram starting points`, () => {+ const page = read('gallery', lang);+ const limit = clean(text(find(page, 'gallery-evidence-limit')));+ assert.ok(limit.includes(lang === 'zh' ? '不提供人工视觉评审结果' : 'not human visual-review results'));+ const description = (function walk(node) {+ return node.tagName === 'meta' && attr(node, 'name') === 'description' ? attr(node, 'content') : (node.childNodes || []).map(walk).find(Boolean);+ })(page);- assert.ok(description.includes(lang === 'zh' ? '不代表已完成人工视觉评审' : 'do not establish human visual review'));++ assert.ok(description.includes(lang === 'zh' ? '自动验证与人工视觉评审分别列出' : 'Automated validation and human visual review appear separately'));+ const cards = byClass(page, 'life-card');+ assert.equal(cards.length, 4);+ for (const [index, type] of ['workflow', 'lifecycle', 'dataflow', 'sequence'].entries()) {+ const entryLinks = links(cards[index]);+ const create = entryLinks.find(link => (attr(link, 'class') || '').split(/\s+/).includes('create-link'));+ assert.ok(create, `${type}: a next step is available without JavaScript`);+ assert.equal(clean(text(create)), lang === 'zh' ? '按此类型开始' : 'Create this type');+ assert.equal(attr(create, 'href'), `${lang === 'zh' ? 'zh/' : ''}start${cloudflare ? '' : '.html'}?type=${type}&input=description&source=gallery`);+ assert.ok(entryLinks.some(link => attr(link, 'href').endsWith(`.${type}.html?present=1`)), 'existing artifact remains accessible');+ assert.ok(entryLinks.some(link => attr(link, 'href').endsWith(`.${type}.json`)), 'existing source remains accessible');+ }+ });+ }