Archify

Archify は、型付き JSON IR をアーキテクチャ、ワークフロー、シーケンス、データフロー、ライフサイクル図の 1 つの HTML にコンパイルするエージェントスキルです。リポジトリ tt-a1i/archify は JavaScript、MIT、作成日 2026-04-15。2026-09-18 の GitHub は 65,850 stars、4,399 forks。プロジェクトページは tt-a1i.github.io/archify。65,850 stars は熱量の信号であり、トラフィックではありません。その日の README は開発版 v2.17.0-dev.1 と書いていました。

エージェントが JSON を書く。Archify はスキーマ、レイアウト、経路、ラベル隙間を検証し、直前の合格 HTML を原子的に置き換える。Mermaid テーマでも描画エディタでもない。Markdown 図なら Mermaid Visualizer、手描きなら Excalidraw Diagram。ホストは Claude Code、Codex CLI、Cursor、OpenCode。

インストール：npx skills add tt-a1i/archify -g。リポジトリは不要。チャットでシステムを説明してよい。

主な機能

• 5 種の図：アーキテクチャ、ワークフロー、シーケンス、データフロー、ライフサイクル。任意の architecture deployment-ownership は owner やリージョン欠落で fail closed。
• 決定的 HTML/SVG：4 プリセット、ダーク/ライト、有限モーションで prefers-reduced-motion を尊重。PNG、SVG、WebM、1200x630 シェアカード。
• Architecture Delta：検証済み 2 スナップショットを Before / Delta / After。追加・削除・変更・移動・再配線。node archify/bin/archify.mjs compare ...
• 根拠のあるビューア：ノード検索、著者の上下流と正確な経路、役割比較、名前付きストーリー。トポロジを捏造せず、実行時影響も主張しない。
• 要求時のソース証拠：アーキテクチャノードは公開 commit にピンした Git 検証ファイルと行を開ける。通常成果物はソース無し。
• Last-good プレビュー：任意の loopback 監視。全ゲート通過後だけ再読込。

制約：Mermaid 自動パース、汎用オートレイアウト、ホスト型共有、WYSIWYG は対象外。Claude.ai アップロードはサンドボックスの Node 次第。任意の更新チェックは安定マニフェストを GET（README は IP と時刻のみ）。ARCHIFY_UPDATE_CHECK_DISABLED=1 で無効化。

使用シナリオ

• リポジトリからランタイム経路を説明：8–12 コンポーネント、主経路 1 本、信頼境界。
• PR のアーキテクチャレビュー：マージ前に Delta。マージ安全性は主張しない。
• キャッシュミスや認証シーケンスで、著者の呼び出しに忠実である必要があるとき。

README の短い Mermaid フローだけで足りるなら使わない。

料金プラン

はじめに

1. npx skills add tt-a1i/archify -g
2. チャット：Use Archify to draw: Browser -> API -> Redis cache -> PostgreSQL fallback.
3. 続けて add Redis、highlight the rollback path。
4. リポジトリならコア 8–12 と主経路 1 本。詳細はカード、辺は増やさない。

一次情報：プロジェクトページ、SKILL.md、Proof Lab。

よくある質問

Mermaid ですか？

いいえ。型付き JSON IR とレンダラ。Mermaid パースは意図的に対象外。

ビューアは余分な辺を作りますか？

README は focus、reach、routes、lenses、stories が著者のノードと関係を再利用すると書く。

エージェント無しで動かせますか？

はい。クローン後 node archify/bin/archify.mjs validate|preview|deliver ...。DeepSeek Harness プラグインは Node ^22.19.0 || >=24.0.0。コア CLI は現行 README を確認。

代替案

• Mermaid Visualizer：テキストから Mermaid。Obsidian/GitHub 向け。
• Excalidraw Diagram：手描きボード。検証済み IR ではない。
• Claude Code：Archify を載せられるホスト。
• OpenCode：agent switcher の別ホスト。

ヒント

1. 補足はカードへ。辺を増やすとレイアウトが崩れる。
2. validate --json / deliver --json を使い、supportedFixes だけ適用。
3. リマインダ GET が不要なら更新チェックを切る。

まとめ

Archify は見せても信じられる図向け：型付きソース、置換前ゲート、1 つの HTML。Mermaid のスケッチでは足りないときに使う。README のフローチャートだけなら Mermaid のまま。