tt-a1i/archify

同じ図を 2 つのテーマで、ワンクリック切り替え:

ダーク	ライト

Export メニューから PNG をクリップボードにコピーしたり、静止画・モーション形式でダウンロードできます:

ルートをトレースしたあと、Export → Route Share Card を選ぶと、その記述済みパスを 1200×630 の PNG としてダウンロードできます。図全体も文脈として保持されます。

記述された Upstream / Downstream の到達範囲をトレースしたあと、Export → Reach Share Card はランタイム上の影響を主張することなく、その読み取り結果をそのまま切り出します。

完全なビューアを試すには、examples/web-app.html をローカルで開いてください。

Cursor に明示的・非対話的にインストールする場合:

npx -y skills add tt-a1i/archify --skill archify --agent cursor --global --copy --yes

インストールせずに試す場合:

npx skills use tt-a1i/archify@archify --agent codex

DSH コミュニティ版（任意）: dsh plugin --profile web add @tt-a1i/archify-dsh@1.0.0

エージェント切り替えは cursor、codex、claude-code、opencode に対応しています。

Archify は固定の安定版マニフェストを GET して任意の更新リマインダーを表示することがありますが、更新をダウンロードしたりインストールしたりすることはありません。チェックに成功すると次回まで約 24 時間（±20%）待機し、失敗した場合はアクティブに使用していれば 6 時間後、その後は 24 時間後に再試行します。サーバーが受け取るのは通常の HTTP メタデータ（IP と時刻）だけで、バージョン、Agent、プロジェクトデータ、プロンプト、アカウント／デバイス ID、ETag は送信されません。更新するかどうか、いつ更新するかは常にあなたが決めます。ARCHIFY_UPDATE_CHECK_DISABLED=1 を設定すると、ネットワーク通信とリマインダー状態の書き込みを無効化できます。

Architecture の任意プロファイル deployment-ownership は、記述されたオーナー、リージョン配置、データベースのプライベートスコープ、名前付きの境界越えが欠けている場合は fail-closed で停止します。暗黙的に有効化されることはなく、ライブのインフラを検査することもありません。検証済みのデプロイ実証を参照してください。

設計や PR のレビューでは、Architecture Delta が検証済みの Before / Delta / After スナップショットを機械可読なレシート付きで比較します。記述された変更を選ぶか、有限でビューア専用の Review を 1 つ再生してください。影響度・リスク・マージ安全性を推測することはありません。

node archify/bin/archify.mjs compare architecture base.json head.json architecture-delta.html --json

どれを選べばよいか分からない場合は、インタラクティブなシナリオガイドを使うか、依存関係ゼロの CLI に尋ねてください:

node archify/bin/archify.mjs guide "Show an API request with Redis cache miss"
node archify/bin/archify.mjs guide "Map Kafka topics, consumer groups, replay, and DLQ" --json

Workflow はレーンをまたいでもハッピーパスを明確に保ちます:

Sequence は 1 つのやり取りを時間軸で説明します:

Data Flow はデータの移動と機密性の境界を明示します:

Lifecycle は進行、待機、リトライ、終端結果を切り分けます:

3.1 で ERD、Class、Tree、Timeline、Waterfall が追加されました。

ERD は、テーブル、すべてのカラムとキー、リレーションのカーディナリティをまとめて示します:

Class は契約、主要メンバー、どの型がそれに依存し実装しているかを示します:

Tree は機能の分解のような、親が 1 つの包含関係を示します:

Timeline はイベントを実時間に比例した 1 本の時間軸に置き、ソースごとにレーンを分けます:

Waterfall はネストや重なりのあるスパンのどこで時間がかかったかを示します:

サンプルを開く: ERD · Class · Tree · Timeline · Waterfall。Timeline と Waterfall の例は説明用のデータを使用しています。ログやトレースに基づく時刻や所要時間だけを実データとして扱ってください。

Architecture の例: web-app · Archify pipeline · grid placement · desktop agent

• 汎用オートレイアウトではなくレイアウトの判断 — 階層、余白、経路、強調をエージェントが選択します。共有される自動接続点は決定論的に分散し、1 点に矢印が集中することはありません。
• 型付き JSON IR — レンダラーが担うすべてのモードにスキーマと再現可能なソースがあります。
• 提供前のアトミックな検証 — スキーマ、レイアウト、HTML/SVG、経路、ラベルと経路のクリアランスのすべてのチェックに合格して初めて、ショーケース成果物が直前の正常な出力を置き換えます。
• 失敗には修復レシートが付く — validate --json と deliver --json は、Node のスタックトレースや当てずっぽうのリトライではなく、安定したルールコード、対象、計測された根拠、サポートされている修復手段のみを返します。
• last-good のライブプレビュー — 任意のデスクトップループが 1 つの JSON ファイルを監視し、最新の候補がすべてのゲートを通過したときだけ更新します。保存が不完全または不正な場合は、直前の検証済み図を表示し続けます。
• 誠実なインタラクション — フォーカス、上流/下流の到達範囲、正確な経路、ロール比較、ストーリーは、記述済みのノードと関係のみを再利用し、トポロジーを捏造したりランタイム上の影響を主張したりしません。
• ソース根拠は要求されたときだけ — 根拠付きの Architecture ノードは自らを SRC n と示し、1 つの公開コミットに固定された Git 検証済みのファイルと行範囲を開きます。通常の成果物はソース非依存のままです。
• 既定でポータブル — 出力は 1 つの HTML ファイルです。エクスポートは常に図全体で、一時的なビューア状態を含みません。

Archify は汎用の作図エディタでも Mermaid のテーマでもありません。技術的な意図をコミュニケーションのための成果物に変えるツールです。

よく使うリポジトリコマンド:

cd archify
node bin/archify.mjs doctor
node bin/archify.mjs demo /tmp/archify-demo
node bin/archify.mjs guide "Show CI/CD checks, approval, deploy, and rollback"
node bin/archify.mjs validate workflow examples/agent-tool-call.workflow.json --quality showcase --json
node bin/archify.mjs preview workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase
node bin/archify.mjs deliver workflow examples/agent-tool-call.workflow.json /tmp/workflow.html --quality showcase --open --json

preview はループバック限定の明示的なデスクトップモードです。127.0.0.1 のランダムポートで 1 つの JSON ファイルを監視し、失敗時も直前の検証済み出力を保持し、Ctrl-C で停止し、生成 HTML にランタイムを追加しません。テスト時や URL を自分で開きたい場合は --no-open を使ってください。

deliver --open は、コミット後に一度だけ実行されるオプトインの受け渡しです。オープナーが失敗しても成功は維持され、JSON は stdout に、手動で開くための絶対パスは stderr に出力されます。

失敗時でも、validate --json と deliver --json は 1 つの JSON オブジェクトを出力します。diagnostics[] の各対象について、その supportedFixes だけを Skill が定める 2 回の修正ラウンド内で適用してください。視覚的なレビューは引き続き分離されています。

設定:

{
  "meta": {
    "locale": "en",
    "animation": "trace",
    "visual_preset": "signal-flow"
  }
}

meta.locale=en|zh-CN|zh-TW|es|ko|ar はページタイトル、Legend、状態／エラー、アクセシビリティ、HTML/SVG の lang をローカライズします（記述された内容自体は変更しません）。該当しない場合は省略し、要求された言語の文言はそのまま維持し、英語へフォールバックした場合はその旨を明示してください。静止出力では animation は省略され、classic が既定になります。

WeChat で下の QR コードをスキャンするか、画像を保存して WeChat で読み取ってください。

Alipay で下の QR コードをスキャンするか、画像を保存して Alipay で読み取ってください。