Superpowers là một methodology + skills framework cho AI coding agents với 228k stars trên GitHub. Nó không làm AI "thông minh hơn" — nó làm AI có kỷ luật hơn: bắt buộc hỏi trước khi code, viết spec, lập plan, TDD, review, rồi mới merge. AI có thể chạy autonomous 1-2 tiếng mà không đi lệch kế hoạch.

1. Vấn đề thực tế mà Superpowers giải quyết

Ai dùng Claude Code / Cursor / Codex đều gặp tình huống này:

Insight quan trọng: AI không thiếu intelligence. Nó thiếu discipline. Superpowers bổ sung đúng thứ đó.

2. Superpowers là gì?

Về bản chất, Superpowers là một folder markdown files đóng gói:

  • Một software development methodology (phương pháp phát triển phần mềm)
  • Một bộ composable skills (kỹ năng có thể kết hợp)
  • Một cơ chế auto-activation (tự động kích hoạt theo context)

Điểm khác biệt lớn nhất: Skills trigger tự động. Bạn không cần gõ command đặc biệt. AI tự biết khi nào cần brainstorm, khi nào cần TDD, khi nào cần review.

3. Cài đặt

Superpowers hỗ trợ hầu hết AI coding agents hiện tại:

AgentCách cài
Claude Code/plugin install superpowers@claude-plugins-official
Codex CLI/plugins → search "superpowers" → Install
Cursor/add-plugin superpowers
Gemini CLIgemini extensions install https://github.com/obra/superpowers
OpenCodeFetch instructions từ repo

Cài cho Claude Code (chi tiết):

# Cách 1: Official Marketplace (recommended)
/plugin install superpowers@claude-plugins-official

# Cách 2: Superpowers Marketplace
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cài xong. Không cần config gì thêm. AI tự có Superpowers.

4. Workflow chi tiết — 7 bước từ ý tưởng đến code

5. Demo: Trước và sau khi có Superpowers

Scenario: Thêm authentication cho API

TRƯỚC (Không có Superpowers):

User: "Add JWT authentication to the API"

Claude Code:
→ Cài jsonwebtoken
→ Tạo middleware auth.js
→ Thêm vào tất cả routes
→ Quên test
→ Quên refresh token
→ Quên error handling cho expired token
→ Hardcode secret trong code
→ Bạn phải fix thêm 2 tiếng

SAU (Có Superpowers):

User: "Add JWT authentication to the API"

Claude Code (with Superpowers):

━━━ BRAINSTORMING ━━━
"Mình có vài câu hỏi trước khi bắt đầu:"
- Access token + refresh token hay chỉ access token?
- Token expire sau bao lâu?
- Lưu secret ở đâu? env var?
- Có cần role-based access control không?
- Routes nào public, routes nào protected?

User: "Access + refresh, 15min/7day, env var, 
       có RBAC, /auth/* public còn lại protected"

━━━ DESIGN SPEC ━━━
[Show spec từng phần cho user approve]

━━━ PLAN ━━━
Task 1: Setup JWT config + env vars (2 min)
Task 2: Create auth middleware - test first (3 min)
Task 3: Login endpoint + test (4 min)
Task 4: Refresh token endpoint + test (4 min)
Task 5: RBAC middleware + test (3 min)
Task 6: Apply to routes + integration test (5 min)

━━━ EXECUTE (TDD) ━━━
[Mỗi task: write failing test → implement → pass → commit]

━━━ REVIEW ━━━
✓ All tests pass
✓ No hardcoded secrets
✓ Error handling complete
✓ Ready to merge

6. Bên trong Skills Library

Superpowers gồm 14 skills, chia 4 nhóm:

Skill highlight: Test-Driven Development

Đây là skill "cứng" nhất — AI bị bắt buộc theo quy trình:

Nếu AI viết code trước khi viết test → Superpowers xoá code đó và bắt làm lại đúng quy trình. Không nhân nhượng.

7. Subagent-Driven Development — Phần hay nhất

Đây là tính năng cho phép Claude Code chạy autonomous hàng giờ mà không cần bạn can thiệp:

Mỗi subagent là một "fresh agent" — không có context cũ, chỉ nhận task description rõ ràng. Giống thuê junior engineer: cho brief chuẩn → output chuẩn.

8. Philosophy — Tại sao Superpowers hiệu quả?

4 nguyên tắc cốt lõi:

9. Systematic Debugging — Cách debug có hệ thống

Khi gặp bug, Superpowers enforce quy trình 4 phase:

So với cách AI debug thông thường (đoán → sửa → đoán → sửa), approach này tiết kiệm rất nhiều iterations.

10. Thực tế sử dụng — Tips & Kinh nghiệm

Tip 1: Để AI brainstorm đủ lâu

Nhiều người vội skip phần brainstorming. Đừng. Đây là phần tạo ra sự khác biệt lớn nhất. AI hỏi được những câu mà bạn quên hỏi chính mình.

Tip 2: Review plan kỹ trước khi "go"

Plan là "bản thiết kế" cho AI execution. Plan sai → toàn bộ execution sai. Dành 2-3 phút đọc plan trước khi approve.

Tip 3: Kết hợp với Git Worktrees

Superpowers tự tạo branch riêng cho mỗi feature. Nếu AI đi sai hướng, bạn chỉ cần discard branch — không ảnh hưởng main code.

# Superpowers tự động:
git worktree add ../feature-auth feature/add-auth
# → Workspace riêng, branch riêng
# → Fail? Discard. Không sợ.

Tip 4: Dùng cho task phức tạp, không dùng cho task đơn giản

✓ Phù hợp:
  - Feature mới cần thiết kế
  - Refactor lớn
  - Bug phức tạp nhiều component
  - Migration / Integration

✗ Overkill:
  - Fix typo
  - Rename variable
  - Thêm 1 field đơn giản
  - Format code

11. So sánh với các approach khác

12. Kết luận

Superpowers không phải magic. Nó là engineering discipline được đóng gói thành markdown và auto-enforce bởi AI agent.

Giá trị cốt lõi:

AI coding agent + Superpowers = Junior engineer có SOP chuẩn,
làm việc 24/7, không skip test, không skip review.

3 điều quan trọng nhất mình rút ra sau khi dùng:

  1. Discipline > Intelligence — AI đã đủ thông minh. Thiếu kỷ luật mới là vấn đề.
  2. Plan trước, code sau — 5 phút planning tiết kiệm 2 tiếng fixing.
  3. TDD không phải optional — Khi AI bị ép viết test trước, chất lượng code tăng rõ rệt.

228k stars trên GitHub không phải tự nhiên có. Thử cài và chạy 1 feature — bạn sẽ hiểu tại sao.

Nguồn tham khảo