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
Clarify repository prompt fallback and cover homepage case links
tt-a1i8bd80167c4ad
diff --git a/website/src/content/mco-source-case.en.md b/website/src/content/mco-source-case.en.mdindex 82be1028..924caa27 100644--- a/website/src/content/mco-source-case.en.md+++ b/website/src/content/mco-source-case.en.md@@ -31,7 +31,7 @@ Open `mco-replay.html` in a browser. This replays an existing model; it does notUse this prompt in your configured coding agent, from the repository you want it to inspect:-> Use Archify to explain how this repository turns external provider output into retained result files. Pin the repository commit. Trace one invocation through its entry point, provider adapter, decoding, streamed writes, final report writer and cleanup. Include only components and relationships supported by files you read, with source links. Distinguish dataflow edges from direct calls and temporary files from retained artifacts. Mark unknowns instead of filling them in. Deliver the architecture HTML, typed JSON and check results, then explain what I should verify in the source.+> Use Archify to explain one real entry-to-output path in this repository. Pin the repository commit. Trace the entry point, the components that process the input, the resulting output, and any persistence or cleanup steps that exist. If the repository has an external provider-to-retained-files pipeline, use that path; otherwise choose a path supported by this repository’s own code. Include only components and relationships supported by files you read, with source links. Distinguish dataflow edges from direct calls and temporary files from retained artifacts. Mark unknowns instead of filling them in. Deliver the architecture HTML, typed JSON and check results, then explain what I should verify in the source.This scope suits a review of component responsibilities and file ownership. For exact message order, use a sequence diagram; for a live incident or latency claim, bring logs, traces or measurements. An architecture picture alone cannot answer those questions. Your repository may have different components; the MCO names are evidence for this case only.diff --git a/website/src/content/mco-source-case.zh.md b/website/src/content/mco-source-case.zh.mdindex 40cb9270..fa4a978c 100644--- a/website/src/content/mco-source-case.zh.md+++ b/website/src/content/mco-source-case.zh.md@@ -31,7 +31,7 @@ node archify/bin/archify.mjs render architecture docs/cases/mco-runtime.architec在要分析的仓库里,把下面的提示词交给已配置好的 Coding Agent:-> 用 Archify 解释这个仓库如何把外部 provider 的输出变成保留的结果文件。固定仓库 commit。沿一次调用追踪入口、provider 适配器、解码、流式写入、最终报告写入和清理。只保留已读取文件支持的组件和关系,并附源码链接。区分数据流关系与直接调用、临时文件与保留产物;未知信息明确标注,不要补全猜测。交付架构 HTML、结构化 JSON 和检查结果,并说明我应该回源码核对什么。+> 用 Archify 解释这个仓库中的一条真实入口到输出路径。固定仓库 commit。追踪入口、处理输入的组件、最终输出,以及实际存在的持久化或清理步骤。如果仓库有外部 provider 到保留结果文件的流水线,就以这条路径为例;否则选择仓库自身代码支持的路径。只保留已读取文件支持的组件和关系,并附源码链接。区分数据流关系与直接调用、临时文件与保留产物;未知信息明确标注,不要补全猜测。交付架构 HTML、结构化 JSON 和检查结果,并说明我应该回源码核对什么。这个范围适合审查组件职责和文件归属。要看精确消息顺序,应使用时序图;要判断线上事故或延迟,需要日志、trace 或测量数据,架构图本身无法回答。你的仓库可能有不同组件,MCO 的组件名称只属于本案例的证据。diff --git a/website/test/evidence/architecture-first-use/README.md b/website/test/evidence/architecture-first-use/README.mdindex 10d20d5d..93b08078 100644--- a/website/test/evidence/architecture-first-use/README.md+++ b/website/test/evidence/architecture-first-use/README.md@@ -1,7 +1,7 @@# Architecture case to first useBase: `ba701d20a55ed6f139484d9ead7ff45671fe40eb` (main, 2026-10-19).-Candidate: the commit containing this receipt. Checks ran on its complete working diff before commit; no product or output changes followed.+Initial candidate: `d2e4aa880dd72dfcf6e283cdc2e3d69900845aac`. Initial checks below ran on its complete working diff before commit. Follow-up evidence is recorded at the end.## Observed before@@ -14,7 +14,7 @@ The homepage navigation's Install Skill anchor resolved to `#quickstart`, althou- The case provides the original HTML and JSON, a replay pinned to both repositories, an adaptation prompt, boundaries and repository-mode Start.- Original artifact/source bytes and all generation behavior remain unchanged.-## Checks executed by Codex+## Initial checks executed by Codex- `npm --prefix website run check`: 0 errors, 0 warnings, one existing clipboard deprecation hint.- Default build: 14 pages. `npm --prefix website test`: 79 passed, 7 browser tests skipped by their opt-in conditions, 0 failed.@@ -35,3 +35,24 @@ Browser-suite screenshots, inspected by Codex (not human acceptance):Screenshots are bounded page tiles; their top may continue a preceding tile. Text remains readable and within the viewport. Full local browser manifests and tiles are in ignored `website/.browser-evidence/{github,cloudflare}/`.No new tracking was added. Existing Start session events were unchanged. This PR establishes usable links and content, not SEO ranking, traffic growth or installation conversion improvements. Live production acceptance awaits an authorized merge and deployment.+++## Review follow-up++Comparison base: `d2e4aa880dd72dfcf6e283cdc2e3d69900845aac`. Candidate: the follow-up commit containing this update.++The bilingual repository prompt now requests an actual entry-to-output path, uses the provider-to-retained-files path only when present, and otherwise selects a path supported by the repository's code. Source links, pinned commit, explicit unknowns and artifact/check deliverables remain required. This avoids assuming MCO's components exist in another repository.++The existing navigation suite now checks the architecture-panel case link in both homepage locales, resolves it using the deployed HTML base, and verifies that its localized target was actually built. It runs against both deployment outputs. This protects a missing, wrong-locale or broken case destination without freezing the link's copy or markup structure.++Updated checks on the complete follow-up source/test diff:++- Type check: 0 errors/warnings, one existing clipboard deprecation hint.+- Default and Cloudflare builds: 14 pages each.+- Default website tests: 80 passed, 7 opt-in browser checks skipped, 0 failed.+- Cloudflare navigation/case/SEO/deployment tests: 21 passed, 0 skipped/failed.+- Real Chrome homepage and MCO suites on each build: 2 passed per build, 0 skipped/failed; same language/theme/viewport coverage as above.+- A temporary broken-link probe in ignored build output failed the new homepage test as expected; restoring the original output passed. No source file was altered by this probe.+- The linked screenshots were refreshed from the follow-up browser runs and inspected by Codex. This remains Agent visual inspection, not human acceptance.++No original artifact or product behavior changed. The original replay execution evidence remains applicable; no generation code, input JSON or command changed in this follow-up. Review discussion was not replied to or resolved as part of preparing this revision.diff --git a/website/test/evidence/architecture-first-use/desktop-replay.png b/website/test/evidence/architecture-first-use/desktop-replay.pngindex 10a5780c..a5f212ae 100644Binary files a/website/test/evidence/architecture-first-use/desktop-replay.png and b/website/test/evidence/architecture-first-use/desktop-replay.png differdiff --git a/website/test/evidence/architecture-first-use/mobile-en-prompt.png b/website/test/evidence/architecture-first-use/mobile-en-prompt.pngindex 95560226..bedc701c 100644Binary files a/website/test/evidence/architecture-first-use/mobile-en-prompt.png and b/website/test/evidence/architecture-first-use/mobile-en-prompt.png differdiff --git a/website/test/evidence/architecture-first-use/mobile-zh-replay.png b/website/test/evidence/architecture-first-use/mobile-zh-replay.pngindex 3da47d68..919687b1 100644Binary files a/website/test/evidence/architecture-first-use/mobile-zh-replay.png and b/website/test/evidence/architecture-first-use/mobile-zh-replay.png differdiff --git a/website/test/navigation.test.mjs b/website/test/navigation.test.mjsindex 8a0a8e69..387c5fb7 100644--- a/website/test/navigation.test.mjs+++ b/website/test/navigation.test.mjs@@ -57,3 +57,18 @@ test('the homepage retains its footer catalog link alongside the top entry', ()const baseUri = new URL(attr(base[0], 'href'), new URL(cloudflare ? '' : 'index.html', origin));assert.ok(nodes(footer).some(node => node.tagName === 'a' && new URL(attr(node, 'href'), baseUri).href === `${origin}community${extension}`));});+++test('both localized homepages link to the existing architecture source case', () => {+ for (const lang of ['en', 'zh']) {+ const file = lang === 'zh' ? 'zh.html' : 'index.html';+ const dom = parse(fs.readFileSync(new URL(file, output), 'utf8'));+ const baseUri = new URL(attr(nodes(dom).find(node => node.tagName === 'base'), 'href'), new URL(file, origin));+ const expected = `${origin}${lang === 'zh' ? 'zh/' : ''}cases/mco-runtime${extension}`;+ const link = nodes(dom).find(node => node.tagName === 'a' && hasClass(node, 'type-more') &&+ new URL(attr(node, 'href'), baseUri).href === expected);+ assert.ok(link, `${lang}: architecture panel offers the localized source case`);+ assert.ok(nodes(link).some(node => node.nodeName === '#text' && node.value.trim()), 'case entry has readable link text');+ assert.ok(fs.existsSync(new URL(`${lang === 'zh' ? 'zh/' : ''}cases/mco-runtime.html`, output)), 'case destination is built');+ }+});