Visitar URL original
Improve website path from architecture case to first use · tt-a1i/archify@d2e4aa8 · GitHub
Skip to content

Commit d2e4aa8

Browse files
committed
Improve website path from architecture case to first use
1 parent ba701d2 commit d2e4aa8

11 files changed

Lines changed: 119 additions & 2 deletions

File tree

‎website/src/components/Navigation.astro‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ const links = [
3535
<svg class="theme-sun" width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><circle cx="8" cy="8" r="3" stroke="currentColor" stroke-width="1.4"/><path d="M8 1.2v1.6M8 13.2v1.6M1.2 8h1.6M13.2 8h1.6M3.2 3.2l1.1 1.1M11.7 11.7l1.1 1.1M3.2 12.8l1.1-1.1M11.7 4.3l1.1-1.1" stroke="currentColor" stroke-width="1.4" stroke-linecap="round"/></svg>
3636
</button>
3737
<a class={home ? 'btn btn-lang' : 'btn-lang'} id={home ? 'btn-lang' : 'language'} href="zh/" data-language-switch aria-label="切换到中文">中文</a>
38-
<a class="btn btn-primary nav-cta" href={home ? '#quickstart' : page === 'start' ? '#install' : 'start.html'} {...(home ? { 'data-i18n': 'nav-install' } : page === 'guide' ? { 'data-i18n': 'navInstall' } : { 'data-en': 'Install Skill', 'data-zh': '安装技能' })}>Install Skill</a>
38+
<a class="btn btn-primary nav-cta" href={page === 'start' ? '#install' : home ? 'start.html#install' : 'start.html'} {...(home ? { 'data-i18n': 'nav-install' } : page === 'guide' ? { 'data-i18n': 'navInstall' } : { 'data-en': 'Install Skill', 'data-zh': '安装技能' })}>Install Skill</a>
3939
</div>
4040
</nav>
4141
<script is:inline>

‎website/src/content/mco-source-case.en.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,37 @@ The MCO runtime architecture example in Archify separates provider execution, an
44

55
This case explains the existing MCO runtime diagram, not a newly executed agent run. Open the published diagram: [MCO runtime diagram](cases/mco-runtime.architecture.html)
66

7+
<span class="section-anchor" id="case-reproduce"></span>
8+
9+
## Replay the existing architecture example
10+
11+
Start with the [interactive HTML](cases/mco-runtime.architecture.html) and its [typed JSON source](cases/mco-runtime.architecture.json). No installation is needed to inspect these files. Follow the Answer Transport → Invocation Artifacts relationship, then compare it with the pinned code links below: the edge describes data ownership, not a direct function call.
12+
13+
To render the same authored input locally, use Node.js 18 or newer, Git, and a fresh directory. These commands pin the stable Archify checkout used for this replay; they do not run MCO or invoke a model:
14+
15+
```sh
16+
git clone https://github.com/tt-a1i/archify.git archify-mco-case
17+
cd archify-mco-case
18+
git checkout --detach ba701d20a55ed6f139484d9ead7ff45671fe40eb
19+
git clone https://github.com/mco-org/mco.git mco-source
20+
git -C mco-source checkout --detach 9f1a1cf1afdc04d7b5406782b40dfec76d9bc798
21+
node archify/bin/archify.mjs render architecture docs/cases/mco-runtime.architecture.json mco-replay.html --repo-root mco-source
22+
```
23+
24+
Open `mco-replay.html` in a browser. This replays an existing model; it does not rediscover the repository or establish a new validation or visual-review result. Check that the provider adapters, answer transport, invocation runtime and artifact writer are still distinct, and use the source links to verify who calls the decoder and who writes files. Rendering with another Archify revision may produce different output.
25+
26+
<span class="section-anchor" id="case-use-your-repo"></span>
27+
28+
## Make a source-backed diagram of your own repository
29+
30+
[Choose your agent and install Archify →](start.html?type=architecture&input=repository#install)
31+
32+
Use this prompt in your configured coding agent, from the repository you want it to inspect:
33+
34+
> 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.
35+
36+
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.
37+
738
<span class="section-anchor" id="case-version-boundary"></span>
839

940
## Version boundary

‎website/src/content/mco-source-case.zh.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,37 @@ Archify 的 MCO 运行时架构案例把 provider 执行、答案解码和结果
44

55
本文解释已有的 MCO 运行时架构图,不代表重新执行了一次 agent 任务。查看原图:[MCO 运行时架构图](cases/mco-runtime.architecture.html)
66

7+
<span class="section-anchor" id="case-reproduce"></span>
8+
9+
## 复现已有架构案例
10+
11+
先打开[交互 HTML](cases/mco-runtime.architecture.html)和[结构化 JSON 源文件](cases/mco-runtime.architecture.json)。查看成品不需要安装。沿 Answer Transport → Invocation Artifacts 这条关系阅读,再对照下方固定版本的代码链接:这条边表达数据职责,不代表直接函数调用。
12+
13+
要在本地渲染同一份输入,需要 Node.js 18 或更新版本、Git 和一个新目录。以下命令固定本次重放使用的 Archify 稳定版源码,不会运行 MCO 或调用模型:
14+
15+
```sh
16+
git clone https://github.com/tt-a1i/archify.git archify-mco-case
17+
cd archify-mco-case
18+
git checkout --detach ba701d20a55ed6f139484d9ead7ff45671fe40eb
19+
git clone https://github.com/mco-org/mco.git mco-source
20+
git -C mco-source checkout --detach 9f1a1cf1afdc04d7b5406782b40dfec76d9bc798
21+
node archify/bin/archify.mjs render architecture docs/cases/mco-runtime.architecture.json mco-replay.html --repo-root mco-source
22+
```
23+
24+
用浏览器打开 `mco-replay.html`。这是对已有模型的重放,不会重新分析仓库,也不代表取得了新的验证或视觉审核结论。检查 provider 适配器、答案传输、调用运行时和产物写入器是否仍然分开,再沿源码链接核对谁调用解码器、谁写文件。换用其他 Archify 版本,输出可能不同。
25+
26+
<span class="section-anchor" id="case-use-your-repo"></span>
27+
28+
## 用自己的仓库开始
29+
30+
[选择 Agent 并安装 Archify →](start.html?type=architecture&input=repository#install)
31+
32+
在要分析的仓库里,把下面的提示词交给已配置好的 Coding Agent:
33+
34+
> 用 Archify 解释这个仓库如何把外部 provider 的输出变成保留的结果文件。固定仓库 commit。沿一次调用追踪入口、provider 适配器、解码、流式写入、最终报告写入和清理。只保留已读取文件支持的组件和关系,并附源码链接。区分数据流关系与直接调用、临时文件与保留产物;未知信息明确标注,不要补全猜测。交付架构 HTML、结构化 JSON 和检查结果,并说明我应该回源码核对什么。
35+
36+
这个范围适合审查组件职责和文件归属。要看精确消息顺序,应使用时序图;要判断线上事故或延迟,需要日志、trace 或测量数据,架构图本身无法回答。你的仓库可能有不同组件,MCO 的组件名称只属于本案例的证据。
37+
738
<span class="section-anchor" id="case-version-boundary"></span>
839

940
## 先确认两个版本

‎website/src/pages/cases/mco-runtime.astro‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ import head from '../../data/agent-diagrams-head.html?raw';
77
import css from '../../styles/agent-diagrams.css?raw';
88
const { lang = 'en' } = Astro.props;
99
const Content = lang === 'zh' ? Chinese : English;
10-
const sectionIds = ['case-version-boundary', 'case-decoding', 'case-file-writes', 'case-persistence', 'case-reading-the-arrow', 'case-limits'];
10+
const sectionIds = ['case-reproduce', 'case-use-your-repo', 'case-version-boundary', 'case-decoding', 'case-file-writes', 'case-persistence', 'case-reading-the-arrow', 'case-limits'];
1111
const headings = (lang === 'zh' ? chineseHeadings() : englishHeadings()).filter(heading => heading.depth === 2).map((heading, index) => ({ ...heading, slug: sectionIds[index] }));
1212
---
1313
<SiteLayout page="cases/mco-runtime" lang={lang} head={head} css={css}>

‎website/src/pages/index.astro‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -308,6 +308,11 @@ const { lang = 'en' } = Astro.props;
308308
<img data-type="timeline" src="assets/archify-timeline.png" alt="Timeline diagram" loading="lazy" decoding="async">
309309
<img data-type="waterfall" src="assets/archify-waterfall.png" alt="Waterfall diagram" loading="lazy" decoding="async">
310310
</div>
311+
<a class="type-more" href="cases/mco-runtime.html">
312+
<span data-en="From repository evidence to an architecture diagram" data-zh="从仓库证据到架构图">From repository evidence to an architecture diagram</span>
313+
<span class="type-more-sub" data-en="Read the MCO case · replay the source · try your own repo" data-zh="阅读 MCO 案例 · 复现源文件 · 换成自己的仓库">Read the MCO case · replay the source · try your own repo</span>
314+
<span class="type-more-arrow" aria-hidden="true">→</span>
315+
</a>
311316
<a class="type-more" href="gallery.html">
312317
<span data-i18n="types-more">Browse the full proof gallery</span>
313318
<span class="type-more-sub" data-i18n="types-more-sub">Live artifacts · every preset · every type</span>
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Architecture case to first use
2+
3+
Base: `ba701d20a55ed6f139484d9ead7ff45671fe40eb` (main, 2026-10-19).
4+
Candidate: the commit containing this receipt. Checks ran on its complete working diff before commit; no product or output changes followed.
5+
6+
## Observed before
7+
8+
The homepage navigation's Install Skill anchor resolved to `#quickstart`, although Start already supports agent and install-scope selection. The architecture type panel linked only to the general gallery. The existing MCO case had pinned evidence and limits but no replay command or direct repository-mode installation action. These are inspection findings, not measured conversion failures.
9+
10+
## Changed experience
11+
12+
- Homepage Install Skill opens localized Start at `#install`.
13+
- The architecture type panel links to the existing localized MCO case.
14+
- The case provides the original HTML and JSON, a replay pinned to both repositories, an adaptation prompt, boundaries and repository-mode Start.
15+
- Original artifact/source bytes and all generation behavior remain unchanged.
16+
17+
## Checks executed by Codex
18+
19+
- `npm --prefix website run check`: 0 errors, 0 warnings, one existing clipboard deprecation hint.
20+
- Default build: 14 pages. `npm --prefix website test`: 79 passed, 7 browser tests skipped by their opt-in conditions, 0 failed.
21+
- Cloudflare build: 14 pages. `ARCHIFY_SITE_TARGET=cloudflare node --test website/test/mco-source-case.test.mjs website/test/seo-content.test.mjs website/test/deployment-target.test.mjs`: 18 passed.
22+
- Existing homepage and MCO real Chrome browser suites: 2 passed, 0 skipped on each host build. Covers English/Chinese, light/dark, widths 1440/390/320, text bounds, section navigation, language continuity, gallery links and artifact load.
23+
- Replay command ran successfully using this Archify base and the existing local MCO checkout containing `9f1a1cf1afdc04d7b5406782b40dfec76d9bc798`, passed as `--repo-root`. It produced `/tmp/archify-mco-replay.html`. The initial probe without `--repo-root` failed as designed; the documented commands now include cloning and pinning that repository. The full network clone commands were not repeated for the replay.
24+
- Ego keyboard checks: focus homepage Install Skill and Enter → `/archify/start.html#install`; focus Chinese homepage MCO link and Enter → `/archify/zh/cases/mco-runtime.html`; case repository-mode action and Enter → Start preserving `type=architecture&input=repository#install`. No installation was executed.
25+
- `git diff --check`: passed.
26+
27+
## Visual evidence
28+
29+
Browser-suite screenshots, inspected by Codex (not human acceptance):
30+
31+
- [Desktop replay, English light, 1440×1000](desktop-replay.png)
32+
- [Mobile replay, Chinese light, 390×1000](mobile-zh-replay.png)
33+
- [Mobile adaptation prompt, English dark, 320×1000](mobile-en-prompt.png)
34+
35+
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}/`.
36+
37+
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.
337 KB
Loading
111 KB
Loading
176 KB
Loading

‎website/test/mco-source-case.test.mjs‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,14 @@ test('MCO case exposes pinned source, honest limits, stable sections and nested
4444
assert.equal(next.tagName, 'h2');
4545
assert.equal(text(next), text(link));
4646
}
47+
const start = nodes(article).find(node => node.tagName === 'a' && attr(node, 'href')?.includes('input=repository'));
48+
assert.ok(start, 'the case offers a repository-mode installation next step');
49+
const startUrl = new URL(attr(start, 'href'), base);
50+
assert.equal(startUrl.pathname, new URL(`${prefix}start${cloudflare ? '' : '.html'}`, origin).pathname);
51+
assert.equal(startUrl.searchParams.get('type'), 'architecture');
52+
assert.equal(startUrl.hash, '#install');
53+
const replay = nodes(article).find(node => node.tagName === 'pre');
54+
assert.ok(text(replay).includes('--repo-root mco-source'), 'replay can verify declared repository evidence');
4755
const artifact = nodes(article).find(node => attr(node, 'href') === 'cases/mco-runtime.architecture.html');
4856
assert.ok(artifact);
4957
assert.equal(new URL(attr(artifact, 'href'), base).href, origin + 'cases/mco-runtime.architecture.html');

0 commit comments

Comments
 (0)