v0.2.2 — Restore README badges and showcase images

visual-architecture v0.2.2

Patch release: restore README showcase images and shields.io badges on npm / GitHub.

Fixes

• Reinstated Markdown image embeds for hero, design-system comparison grid, Android lifecycle sample, and pipeline diagrams
• Restored npm / Node / license badges and added GitHub release + stars badges
• Applied to both README.md and README.en.md

Install

npx visual-architecture@0.2.2
# or
npx visual-architecture@latest

---

简体中文

补丁版：恢复 README 样图与 shields.io 徽章（同步 npm / GitHub）。

修复

• 恢复头图、三风格对比、Android 生命周期、工作流示意的图片嵌入
• 恢复 npm / Node / License 徽章，并增加 GitHub Release、Stars
• 中英文 README 同步

安装

npx visual-architecture@0.2.2

v0.2.1 — Progressive load & lower instruction context

visual-architecture v0.2.1

Release relative to v0.1.0: progressive loading, shared visual/routing contracts, scriptable validation, and substantially smaller skill-instruction context.

Highlights

• Progressive loading — Interview and full generation load instructions by stage, instead of pulling every design system and gate into the first turn
• Shared contracts — contracts/routing.md and contracts/visual.md as the single source of truth for routing and visual rules
• Validatable artifacts — schemas/ plus bin/validate-{ir,resolution,layout}.mjs
• Package entry — Root SKILL.md as the install/discovery entrypoint
• PNG export (G11) — Self-contained HTML must expose a visible PNG export action

Performance (instruction context)

Scenario	Before (≈tokens)	Now (≈tokens)	Reduction	Relative efficiency
Interview	4,100	2,083	49.2%	1.97×
Full · Apple Document	32,000	12,463	61.1%	2.57×
Full · Neural Blueprint	31,000	12,307	60.3%	2.52×
Full · Cyber Nexus	30,000	11,821	60.6%	2.54×

Metrics measure skill-instruction context (unique bytes ÷ 2.8), not end-to-end wall-clock latency. Detailed audit protocols remain in the development repository and are not shipped in the npm / npx package.

Behavior changes

• Grill-me: one recommendation package + one confirmation; after that, “you decide / just generate” accepts the package
• Routing policy standardized to orthogonal-shared-bus
• Nested skill/SKILL.md removed in favor of the package-root entry

Install

npx visual-architecture@0.2.1
# or
npx visual-architecture@latest

Links

• Repository: https://github.com/endlessYoung/visual-architecture
• npm: https://www.npmjs.com/package/visual-architecture

---

简体中文

相对 v0.1.0：渐进加载、契约化视觉/路由、可脚本校验，以及显著降低的 Skill 指令上下文占用。

亮点

• 渐进加载 — Interview 与完整出图分阶段加载指令，避免首轮灌入全部设计系统与门禁
• 共享契约 — contracts/routing.md、contracts/visual.md 作为路由与视觉 SSOT
• 可校验产物 — schemas/ + bin/validate-{ir,resolution,layout}.mjs
• 包入口 — 根目录 SKILL.md 作为安装/发现入口
• PNG 导出（G11） — 自包含 HTML 必须提供可见的 PNG 导出

性能（指令上下文）

场景	优化前（≈tokens）	当前（≈tokens）	降幅	相对效率
Interview	4,100	2,083	49.2%	1.97×
完整路径 · Apple Document	32,000	12,463	61.1%	2.57×
完整路径 · Neural Blueprint	31,000	12,307	60.3%	2.52×
完整路径 · Cyber Nexus	30,000	11,821	60.6%	2.54×

指标为 Skill 指令上下文（unique bytes÷2.8），非端到端墙钟。详细审计协议仅保留在开发仓库，不随 npm / npx 包分发。

行为变化

• Grill-me：一套推荐 + 一次确认；之后「你定 / just generate」即接受该方案
• 路由策略统一为 orthogonal-shared-bus
• 移除嵌套 skill/SKILL.md，统一使用包根入口

安装

npx visual-architecture@0.2.1

visual-architecture 0.1.0

visual-architecture 0.1.0

AI Skill package: technical description to HTML+SVG architecture diagrams.

Highlights

• Three design systems: Neural Blueprint, Apple Document, Cyber Nexus
• Single-shot grill-me: one recommendation package + one confirm
• G11: self-contained HTML must include PNG image export
• Install via npx visual-architecture (npm) or npx github:endlessYoung/skills

Install

npx visual-architecture@0.1.0