Hành trình Tối ưu Kiến trúc

Quy trình 8 giai đoạn có thể tạm dừng và tiếp tục, giúp đo lường, dọn dẹp và tăng tốc một codebase đang chạy nhưng ngày càng chậm và rối.

Lập trìnhNâng cao★ 2,047⑂ 212Điểm AI 9/10Cập nhật lần cuối: 28 thg 8, 2026

Làm được gì

Cải thiện đồng thời kiến trúc, chất lượng mã và hiệu năng cho hệ thống đang vận hành nhưng đã trở nên chậm chạp.

8 giai đoạn: ①Khóa hành vi bằng test + đo baseline → ②Khôi phục quy tắc phụ thuộc (Clean Architecture) → ③Làm sâu module → ④Refactor các hot path → ⑤Xử lý điểm nghẽn đã đo → ⑥Sửa tầng dữ liệu (N+1, index, mức cô lập) → ⑦Timeout/circuit breaker khi phụ thuộc lỗi → ⑧Biến ngân sách hiệu năng thành CI gate
Nguyên tắc cốt lõi: không tối ưu thứ chưa đo, không tái cấu trúc thứ chưa có test bảo vệ; thay đổi nào không cải thiện con số thì revert.
Tiếp tục được: mọi tiến trình ghi vào docs/ARCHITECTURE-OPTIMIZATION-PLAN.md, PERFORMANCE.md, ARCHITECTURE.md.
Hỏi ở mỗi quyết định: ngưỡng ngân sách, quy tắc invalidate cache, có thêm index hay không — luôn kèm phương án đề xuất.

Phù hợp với ai

Lập trình viên backend/fullstack đang vận hành sản phẩm thật "chạy được nhưng ngày càng chậm"
Team lead muốn giải quyết p95, slow query, chi phí hạ tầng dựa trên dữ liệu thay vì cảm tính
Tech lead/kiến trúc sư cần tài liệu hóa quyết định tối ưu và nợ kỹ thuật

Ví dụ sử dụng

API thanh toán chậm: "Muốn p95 checkout dưới 500ms" → Giai đoạn 1 viết characterization test và lấy baseline profiler; Giai đoạn 5-6 sửa N+1 và thêm index, ghi số trước/sau vào Optimization Ledger.
Monolith mất ranh giới: logic nghiệp vụ import thẳng ORM → Giai đoạn 2 vẽ đồ thị phụ thuộc, liệt kê vi phạm thành bảng và tách use case không phụ thuộc framework.
Một dịch vụ ngoài treo là sập cả hệ thống: Giai đoạn 7 gắn timeout, circuit breaker, bulkhead cho mọi lời gọi ra ngoài và thiết kế cảnh báo RED metrics.

· · · Hướng dẫn cài đặt · · ·

Dùng thử ngay, không cần cài

Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/wondelai/skills/HEAD/architecture-optimization/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.

↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.

Cài vào ứng dụng Claude (không cần terminal)

Tải tệp ZIP bằng nút bên dưới.
Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.

↓ Tải ZIP

Cài vào Claude Code

Để Claude làm — dán câu dưới đây vào Claude Code

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục architecture-optimization từ repo GitHub wondelai/skills vào ~/.claude/skills/architecture-optimization/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.

Cài bằng lệnh thủ công

git clone https://github.com/wondelai/skills.git /tmp/wondelai-skills && mkdir -p ~/.claude/skills && cp -r /tmp/wondelai-skills/architecture-optimization ~/.claude/skills/

⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.

Mở terminal.
Tải repo: git clone https://github.com/wondelai/skills.git /tmp/wondelai-skills
Tạo thư mục skill: mkdir -p ~/.claude/skills
Sao chép skill này: cp -r /tmp/wondelai-skills/architecture-optimization ~/.claude/skills/
(Nên làm) Sao chép cả 8 skill thành phần để mỗi giai đoạn chạy đầy đủ phương pháp: cp -r /tmp/wondelai-skills/{working-with-legacy-code,clean-architecture,software-design-philosophy,refactoring-patterns,system-design,ddia-systems,release-it,pragmatic-programmer} ~/.claude/skills/
Khởi động lại Claude Code, mở thư mục dự án và yêu cầu: "Ứng dụng của tôi chậm, hãy bắt đầu hành trình tối ưu kiến trúc".
Trả lời các câu hỏi đầu vào (tải thực tế, stack, đã có test chưa...) để tạo docs/ARCHITECTURE-OPTIMIZATION-PLAN.md và bắt đầu.

Xem mã nguồn trên GitHub ↗Giấy phép: MIT