Superpowers biến AI agent thành senior developer thực thụ và hoàn toàn miễn phí

Bạn đã bao giờ thấy AI agent hăm hở gõ code ào ào, rồi khi chạy thử thì… lỗi tứ tung, test không có, và mớ hỗn độn đó hoàn toàn không giống cách một lập trình viên có kinh nghiệm làm việc chưa? Đó không phải lỗi của bạn — đó là cách mà hầu hết AI agent hoạt động theo mặc định. Nhưng có một công cụ tên là Superpowers đang thay đổi điều đó, và nó hoàn toàn miễn phí.

Superpowers là gì? Vấn đề thực sự với AI agent hiện tại

Superpowers là một bộ quy tắc và cấu trúc làm việc mã nguồn mở, giúp các AI agent như Claude Code, Cursor, Codex, hay Gemini CLI làm việc theo đúng quy trình của một kỹ sư cấp cao — thay vì “nhảy bổ” vào viết code ngay mà không suy nghĩ.

Dự án hiện đã vượt ~199k sao trên GitHub. Con số đó nói lên rất nhiều.

Khi bạn yêu cầu Claude Code hay Cursor viết một tính năng, điều thường xảy ra là:

• AI lao vào code ngay, không có kế hoạch rõ ràng
• Debug theo kiểu thử-sai-thử-lại
• Bỏ qua hoàn toàn việc viết test
• Khi dự án lớn dần, AI bắt đầu “ảo giác” — sinh ra code không dùng đến, làm hỏng test đang chạy được, và đi lạc khỏi mục tiêu ban đầu

Đây là hành vi bình thường của AI khi không có cấu trúc ràng buộc. Superpowers giải quyết đúng vấn đề này.

Superpowers làm được gì?

Buộc AI phải suy nghĩ trước khi viết

Không còn chuyện AI gõ code ngay khi nhận yêu cầu. Superpowers bắt buộc AI phải đi qua một quy trình 7 giai đoạn trước khi có bất kỳ dòng code nào xuất hiện:

Brainstorm → Spec → Plan → TDD → Subagents → Review → Ship

Mỗi giai đoạn có mục đích rõ ràng và AI không được phép bỏ qua bước nào.

Áp dụng TDD cực kỳ nghiêm ngặt

TDD (Test-Driven Development) – phát triển hướng kiểm thử – nghĩa là viết test trước, rồi mới viết code để test đó chạy được. Đây là tiêu chuẩn trong ngành phần mềm chuyên nghiệp, nhưng AI thường bỏ qua vì nó… tiện hơn.

Superpowers không cho phép điều đó. Nếu không có test chạy thành công trước, không có code nào được giữ lại — thậm chí sẽ bị xóa đi.

Lưu ý: Quy tắc này nghe có vẻ cứng nhắc, nhưng đây chính xác là lý do tại sao code sinh ra từ Superpowers ít lỗi hơn và dễ bảo trì hơn nhiều.

Chạy nhiều tác nhân song song

Superpowers có thể điều phối nhiều sub-agent làm việc đồng thời trên các nhánh git worktree tách biệt. Thay vì một AI làm từng bước một, bạn có thể có nhiều “phiên bản” AI xử lý song song các phần khác nhau của dự án — và chúng không làm ảnh hưởng lẫn nhau.

Bám sát kế hoạch trong thời gian dài

Một điểm yếu khác của AI agent là sau vài giờ làm việc, chúng thường “trôi” khỏi mục tiêu ban đầu. Superpowers giữ cho ngữ cảnh luôn được kiểm soát, giúp AI hoạt động tự động nhiều giờ mà vẫn đi đúng hướng.

So sánh thực tế

Cài đặt — mỗi công cụ một cách, làm một lần là xong

Superpowers hoàn toàn mã nguồn mở theo giấy phép MIT. Nếu bạn dùng nhiều công cụ khác nhau, cần cài riêng cho từng cái.

Với Claude Code (cách nhanh nhất)

Mở Claude Code lên, gõ lệnh sau vào chat:

/plugin install superpowers@claude-plugins-official

Xong. Không cần làm gì thêm — từ lần sau Claude Code sẽ tự động áp dụng quy trình của Superpowers.

Mẹo nhỏ: Nếu lệnh trên không tìm thấy, thử đăng ký marketplace trước rồi cài lại:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Với Cursor

Trong cửa sổ Cursor Agent chat, gõ:

/add-plugin superpowers

Hoặc vào phần cài plugin trong giao diện và tìm từ khóa “superpowers”.

Với Gemini CLI

gemini extensions install https://github.com/obra/superpowers

Để cập nhật sau này:

gemini extensions update superpowers

Với OpenAI Codex CLI

Mở Codex, gõ /plugins để mở giao diện tìm kiếm, tìm “superpowers” và chọn Install Plugin.

Dùng thực tế trông như thế nào?

Đây là điểm khác biệt rõ nhất. Cùng một yêu cầu, nhưng trải nghiệm hoàn toàn khác.

Ví dụ: Bạn muốn xây một tính năng đăng nhập

❌ Không có Superpowers — Claude Code thông thường:

Bạn: “Viết chức năng đăng nhập cho app Node.js của mình”

Claude: (bắt đầu gõ code ngay)

app.post('/login', async (req, res) => {
  const user = await User.findOne({ email: req.body.email });
  // ...tiếp tục viết không dừng...

(Không hỏi gì thêm, không có test, không có kế hoạch)

✅ Có Superpowers — Claude Code làm việc như senior developer:

Bạn: “Viết chức năng đăng nhập cho app Node.js của mình”

Claude: “Trước khi bắt đầu, mình cần làm rõ một số điểm:

• Dùng session hay JWT token?
• Có yêu cầu refresh token không?
• Xử lý tài khoản bị khóa sau nhiều lần sai mật khẩu không?
• Tích hợp OAuth (Google, GitHub…) hay chỉ email/password?”

(Sau khi bạn trả lời → Claude trình bày bản thiết kế tóm tắt để bạn xác nhận)

(Sau khi bạn đồng ý → Claude lập kế hoạch từng bước, mỗi bước 2–5 phút)

(Bắt đầu viết test trước)

// test/auth.test.js — viết TRƯỚC khi có code thực
describe('POST /login', () => {
  it('trả về 401 khi mật khẩu sai', async () => { ... });
  it('trả về JWT token khi đăng nhập thành công', async () => { ... });
  it('khóa tài khoản sau 5 lần sai', async () => { ... });
});

(Test chạy → đỏ → bắt đầu viết code → test chạy → xanh → commit → sang bước tiếp)

Sự khác biệt không chỉ là kết quả cuối cùng. Là toàn bộ cách tiếp cận vấn đề.

Cách mình khuyên dùng nhất với Cursor

Bạn đang dùng Cursor với Superpowers và thấy AI cứ “nghĩ nhiều”, giải thích dài dòng, chia nhỏ task không cần thiết — trong khi bạn chỉ muốn sửa một cái lỗi CSS? Đó không phải lỗi của bạn. Đó là vì bạn đang để AI chạy hết công suất cho những việc không cần thiết.

Superpowers là bộ công cụ mạnh, nhưng đi kèm với đó là một bộ hành vi mặc định khá “nặng”:

• Luôn động não tìm ý tưởng trước
• Luôn lập kế hoạch trước khi làm
• Luôn kiểm tra lại sau khi xong
• Luôn xem xét toàn bộ ngữ cảnh

Kết quả? AI của bạn sẽ verbose hơn, nghĩ nhiều hơn, chia nhỏ task hơn — và tốn token hơn rất nhiều, kể cả với những tác vụ đơn giản như sửa màu nền hay đổi tên biến.

Mẹo nhỏ: Hãy nghĩ Superpowers như chế độ “kiến trúc sư” — rất cần khi xây nhà, nhưng thừa hoàn toàn khi bạn chỉ muốn vặn lại cái bóng đèn.

Giải pháp: Dùng file rules để điều tiết AI

Cursor cho phép bạn cài quy tắc hành vi cho AI thông qua hai nơi:

• Thư mục .cursor/rules/
• File AGENTS.md

Đây là cách để bạn “dạy” AI biết lúc nào cần nghĩ nhiều, lúc nào cứ làm thẳng vào việc.

Bộ cài đặt 3 file — cân bằng giữa chất lượng và tiết kiệm

Cấu trúc thư mục gợi ý:

.cursor/rules/
├── core.mdc
├── stack.mdc
└── superpowers-heavy.mdc

Mỗi file đảm nhận một vai trò riêng, không chồng chéo nhau.

Bộ tối ưu cuối cùng mình nghĩ hợp lý cho mọi người

Trong đó:

• core.mdc → concise + anti-overthinking
• stack.mdc → coding philosophy generic
• superpowers-heavy.mdc → architecture mode thủ công/on-demand

Đây là setup khá cân bằng giữa:

• chất lượng code
• token usage
• flexibility
• ít conflict với Graphify / Antigravity / Superpowers.

File 1: core.mdc — Chặn AI nói nhiều

File này luôn được áp dụng (alwaysApply: true). Nhiệm vụ của nó là giữ cho AI đi thẳng vào việc, không vòng vo. Với file này, AI sẽ không còn viết 3 đoạn giải thích trước khi sửa một dòng CSS nữa.

---
alwaysApply: true
---

# Core Rules

Prefer concise implementation-first responses.

Avoid:
- verbose explanations
- repeated summaries
- unnecessary planning
- over-engineering

Do not use heavy reasoning for:
- CSS fixes
- copy updates
- simple bug fixes
- tiny refactors

Prefer:
- small reusable functions
- modular code
- readable structure

File 2: stack.mdc — Triết lý code chung

File này định hình phong cách code mà AI nên theo — luôn được áp dụng, nhưng không liên quan đến việc AI “nghĩ nhiều hay ít”. File này không ảnh hưởng tốc độ, nhưng giúp code output nhất quán và sạch hơn.

---
alwaysApply: true
---

# Development Guidelines

Prefer:
- clean architecture
- modular code
- reusable components
- readable structure
- maintainable solutions

Avoid:
- unnecessary abstractions
- over-engineering
- giant files
- deeply nested logic
- duplicate code

Code style:
- keep functions focused
- prefer explicit naming
- separate business logic from UI
- write scalable code

Performance:
- avoid unnecessary re-renders
- avoid loading unnecessary context
- optimize only when needed

File 3: superpowers-heavy.mdc — Chế độ “kiến trúc sư” thủ công

File này không bật tự động. Bạn chỉ kích hoạt nó khi đang làm những task thực sự lớn. Khi cần refactor toàn bộ hệ thống hay thiết kế lại kiến trúc database, bạn mới gọi file này vào. Còn lại? Hai file trên là đủ.

---
description: Heavy workflow for architecture and large refactors
---

# Superpowers Heavy

Use ONLY for:
- architecture redesign
- multi-file refactors
- infrastructure changes
- database migrations
- large feature implementation

Workflow:
1. Analyze architecture
2. Create concise plan
3. Implement incrementally
4. Validate changes

Rules:
- Avoid overthinking
- Avoid excessive reasoning
- Prefer practical implementation
- Keep explanations concise
- Minimize token usage

Tóm lại — Khi nào dùng gì?

Cách kích hoạt khi làm Task lớn

Khi bạn bắt tay vào làm một task lớn và muốn gọi “vị kiến trúc sư” này dậy, bạn có 2 cách kích hoạt thủ công trực tiếp trong khung Chat (Ctrl/Cmd + L) hoặc Composer (Ctrl/Cmd + I):

Cách 1: Gõ @ để gọi trực tiếp (Khuyên dùng)

Trong khung chat hoặc Composer, bạn chỉ cần gõ ký tự @, chọn mục Rules (hoặc gõ tiếp tên file), rồi chọn superpowers-heavy.mdc.

Ví dụ câu lệnh: @superpowers-heavy.mdc Hãy phân tích và thiết kế lại module thanh toán này giúp tôi.

Cách 2: Kích hoạt bằng “Từ khóa” (Trigger Word)

Nếu bạn muốn tiện hơn nữa, bạn có thể thêm một dòng hướng dẫn ngay trong phần description của file .mdc để AI tự nhận biết khi bạn nói một từ khóa nhất định.

Cập nhật lại phần đầu file:

---
description: Chế độ "kiến trúc sư" thủ công. Chỉ kích hoạt khi người dùng sử dụng từ khóa "Kiến trúc sư" hoặc "Heavy Mode".
globs: ""
alwaysApply: false
---

Điểm mấu chốt:

• globs: “” bỏ trống nghĩa là nó không tự động kích hoạt dựa trên file cụ thể nào cả.
• alwaysApply: false đảm bảo Cursor sẽ không tự động lôi file này vào mọi cuộc hội thoại.

Khi đó, chỉ cần trong câu lệnh của bạn có chữ “Kiến trúc sư”, Cursor sẽ chủ động đọc và áp dụng các rule nghiêm ngặt trong file này để xử lý task cho bạn.

Có đáng thử không?

Nếu bạn chỉ dùng AI để viết các đoạn code nhỏ, script ngắn — thì chưa cần thiết lắm. Nhưng nếu bạn đang xây dựng dự án thực thụ với AI agent và hay gặp cảnh “code chạy được hôm nay, hỏng không rõ lý do hôm sau” — thì Superpowers chính xác là thứ bạn cần.

Thay vì tốn thời gian prompt đi prompt lại cho đến khi AI chịu làm đúng, bạn có một quy trình cố định buộc AI làm việc có trách nhiệm hơn ngay từ đầu.

Thử xem — miễn phí mà, mất gì đâu. Bạn đã thử công cụ nào tương tự chưa? Chia sẻ bên dưới nhé!