dym-archify-compare-architecture-delta

Skill: dym-archify-compare-architecture-delta — So sánh hai bản architecture (Architecture Delta)

Vì sao dùng: review thiết kế và review PR. Thay vì bắt người đọc so hai sơ đồ bằng mắt, Archify so hai nguồn architecture đã validate và sinh một trang Before / Delta / After kèm biên lai máy đọc được.

Kết quả nhận được: một file HTML delta tự chứa và một sidecar *.receipt.json liệt kê chính xác cái gì thêm, bớt, đổi, dời — không suy diễn.

Chỉ hỗ trợ architecture.

export A=~/.claude/skills/archify

Chạy

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

Đã chạy thật với hai ví dụ đóng gói sẵn:

node $A/bin/archify.mjs compare architecture \
  $A/examples/checkout-platform.base.architecture.json \
  $A/examples/checkout-platform.head.architecture.json \
  out/delta.html --json

rc 0. Sinh ra hai file:

delta.html          1.9M
delta.receipt.json  5.2K

Sidecar biên lai mặc định đặt cạnh HTML, cùng tên gốc. Đổi chỗ bằng --receipt:

node $A/bin/archify.mjs compare architecture base.json head.json out/delta.html \
  --receipt out/delta-receipt.json --json

Các cờ khác giống phần còn lại của CLI: --quality standard|showcase, và --repo-root <path> khi hai nguồn có khai bằng chứng mã (xem 04).

Đọc biên lai

Các khoá top-level thật (quan sát trực tiếp trên delta.receipt.json đã sinh):

schemaVersion  ok  command  type  comparatorVersion  canonicalVersion
completeness   proofLevel   base   head   summary   changes
identity       view         limitations   artifact   validation

base và head mỗi bên mang title, rawSha256, semanticSha256, bytes. Hai loại hash tách biệt có chủ đích: rawSha256 đổi khi byte đổi (kể cả chỉ format lại), semanticSha256 chỉ đổi khi ý nghĩa đổi.

summary thật từ lần chạy trên:

{
  "components":  { "added": 1, "changed": 1, "evidenceChanged": 0, "removed": 1, "moved": 1 },
  "connections": { "added": 1, "changed": 2, "removed": 1, "rerouted": 1 },
  "boundaries":  { "added": 0, "changed": 2, "removed": 0, "geometryChanged": 0 },
  "presentationChanged": true,
  "provenanceChanged": false
}