Archify: Khi AI Biến Codebase Thành Kiến Trúc Hệ Thống Đẹp
Archify biến codebase hoặc mô tả hệ thống thành biểu đồ kiến trúc tương tác, đẹp mắt — trực tiếp trong terminal AI.
Tại Sao Bạn Cần Biết Về Archify?#
Bạn từng mất hàng giờ vẽ sơ đồ kiến trúc hệ thống bằng tay, rồi phải cập nhật mỗi khi code thay đổi? Archify giải quyết vấn đề đó — chỉ cần mô tả bằng ngôn ngữ tự nhiên, AI sẽ biến codebase thành biểu đồ kiến trúc tương tác, đẹp mắt.
[!TIP] Archify hiện có trên GitHub trending với hàng nghìn sao. Đây là một trong những công cụ AI agent skill hot nhất hiện nay.
Archify Là Gì?#
Archify là một hệ thống render và xác thực mã nguồn mở, hoạt động như một agent skill cho Cursor, Claude Code, Codex CLI, và OpenCode. thay vì vẽ tay hoặc dùng Mermaid, bạn chỉ cần nói với AI: “Hãy vẽ sơ đồ kiến trúc cho repo này” — và Archify sẽ:
- Tạo JSON IR có kiểu — AI mô tả hệ thống bằng cấu trúc dữ liệu chuẩn
- Xác thực tự động — Kiểm tra schema, layout, HTML/SVG, route
- Render ra HTML — Một file HTML duy nhất, mở là xong, có thể chia sẻ
[!NOTE] Archify không phải là trình vẽ tổng quát hay theme Mermaid. Nó biến ý định kỹ thuật thành artifact giao tiếp.
Năm Loại Biểu Đồ#
Archify hỗ trợ 5 loại biểu đồ chính:
| Loại | Tốt Nhất Cho | Ví dụ |
|---|---|---|
| Architecture | Components, services, storage, boundaries | Kiến trúc runtime |
| Workflow | CI/CD, approvals, tool calls | Quy trình phê duyệt |
| Sequence | API calls, cache fallback, auth | Chuỗi gọi API |
| Data Flow | Pipelines, lineage, PII | Luồng dữ liệu |
| Lifecycle | States, retries, waits | vòng đời request |
Cài Đặt và Sử Dụng#
npx skills add tt-a1i/archify -gSau khi cài đặt, chỉ cần hỏi AI agent trong chat:
Analyze this repository, then use archify to create a high-level runtime architecture diagram.
Show 8–12 core components, one primary path, external dependencies, and trust boundaries.Tại Sao Archify Khác Biệt?#
Layout Thông Minh#
Thay vì auto-layout generic, AI chọn hierarchy, spacing, routes, và emphasis. Các endpoint tự động spread thay vì chồng chất mũi tên vào một điểm.
JSON IR Có Kiểu#
Mỗi renderer-backed mode đều có schema và reproducible source. Bạn có thể diffs, validates, và reproduces bất kỳ diagram nào.
Xác Thực Nguyên Tử#
Trước khi deliver, Archify chạy 5 bước xác thực:
- Schema validation
- Layout rules check
- HTML/SVG rendering
- Route clearance
- Label-to-route clearance
Last-Good Preview#
Một desktop loop optional theo dõi source, refresh chỉ khi pass mọi gate. Nếu save chưa hợp lệ, diagram cuối cùng vẫn hiển thị.
So Sánh Với Các Công Cụ Khác#
| Tính năng | Archify | Mermaid | Lucidchart | Draw.io |
|---|---|---|---|---|
| Tự động từ code | ✅ | ❌ | ❌ | ❌ |
| Xác thực tự động | ✅ | ❌ | ❌ | ❌ |
| Export HTML | ✅ | ❌ | ❌ | ❌ |
| Before/After Delta | ✅ | ❌ | ❌ | ❌ |
| Free & Open Source | ✅ | ✅ | ❌ | ✅ |
Ví Dụ Thực Tế#
Use archify to draw this login flow: Browser -> Web App -> API -> JWT validation ->
Redis session lookup -> PostgreSQL fallback. Keep the cache-miss path secondary.Archify sẽ tạo ra một file HTML tương tác với:
- Dark/Light theme
- Zoom và pan
- Search nodes
- Route tracing
- Export PNG, SVG, WebM
Kết Luận#
Archify đang thay đổi cách chúng ta communicate kiến trúc hệ thống. Thay vì vẽ tay rồi update thủ công, giờ AI làm tất cả — từ phân tích codebase đến render diagram đẹp, có thể chia sẻ.
[!WARNING] Archify hiện đang trong phiên bản dev (v2.16.0-dev.0). Hãy theo dõi repository để cập nhật.
🔗 Repository: github.com/tt-a1i/archify ↗