Chương 11: Changelog

Lịch sử phát hành đầy đủ của Superpowers. Các bản phát hành được liệt kê theo thứ tự thời gian ngược (mới nhất trước).

v5.0.2 — Tháng 3/2026

Chủ đề: Khả năng phục hồi cơ sở hạ tầng và quản lý session

Tính Năng Mới

Brainstorm server không phụ thuộc bên ngoài. Companion brainstorming giờ chạy mà không cần bất kỳ dependency bên ngoài nào. Không cần npm install cho brainstorm server — nó chạy hoàn toàn trên các built-in của Node.js. Điều này loại bỏ cả một nhóm lỗi cài đặt và làm cho tính năng brainstorm hoạt động ngay sau khi clone.
Tự động thoát sau 30 phút không hoạt động. Các session chạy lâu mà không có hoạt động trong 30 phút sẽ tự động thoát sạch. Điều này ngăn các tiến trình bị bỏ rơi, giảm tiêu thụ tài nguyên và đảm bảo các session không tích lũy context cũ từ công việc nhiều giờ trước.
Cải thiện cô lập context. Context của sub-agent giờ được cô lập nghiêm ngặt hơn khỏi context của agent cha. Thông tin từ cuộc điều tra của một agent không bị rò rỉ vào lý luận của agent khác, ngăn chặn một nhóm lỗi nhiễm context tinh vi — khi một agent "nhớ" điều gì đó từ một luồng công việc song song mà nó không nên có quyền truy cập.

Sửa Lỗi

Sửa lỗi edge case khi brainstorm server không khởi động được nếu cổng mặc định đang được sử dụng
Sửa lỗi serialization context cho các cây agent lồng sâu

v5.0.1 — Tháng 3/2026

Chủ đề: Mở rộng nền tảng

Tính Năng Mới

Hỗ trợ Gemini CLI extension. Superpowers giờ được hỗ trợ đầy đủ trên Google's Gemini CLI thông qua hệ thống extension. Tất cả các skill cốt lõi — TDD, systematic debugging, verification, code review, worktrees — đều có sẵn trên Gemini CLI với cùng các đảm bảo thực thi như Claude Code. Hướng dẫn cấu hình được bao gồm trong tài liệu cài đặt.

Ghi Chú

Đây là bản phát hành hỗ trợ nền tảng. Không có thay đổi hành vi đối với các skill hoặc giao thức hiện có.

v5.0.0 — Tháng 3/2026

Chủ đề: Lý luận trực quan và thông minh tài liệu

Tính Năng Mới

Companion brainstorming trực quan. Một chế độ companion mới hiển thị quá trình brainstorming dưới dạng sơ đồ tương tác. Xem các ý tưởng, kết nối và cây quyết định một cách trực quan khi brainstorm tiến hành. Đặc biệt hữu ích cho các quyết định kiến trúc phức tạp và công việc thiết kế hệ thống.
Hệ thống review tài liệu. Khả năng mới để review các tài liệu kỹ thuật — RFC, architecture decision records, design documents và specifications — với cùng mức độ nghiêm ngặt áp dụng cho code review. Hệ thống review tài liệu kiểm tra tính nhất quán nội bộ, các edge case bị thiếu và các giả định chưa được nêu rõ.
Skill hướng dẫn kiến trúc. Một skill mới chuyên dụng cho các quyết định cấp kiến trúc. Kích hoạt khi thiết kế hệ thống, chọn data store, lập kế hoạch ranh giới service hoặc đưa ra các quyết định ảnh hưởng đến nhiều thành phần. Cung cấp các framework có cấu trúc cho phân tích đánh đổi.

Thay Đổi Không Tương Thích (Breaking Changes)

Hard-gate brainstorm từ v4.3.0 giờ cũng áp dụng cho các cuộc thảo luận kiến trúc. Bạn không thể bắt đầu triển khai kiến trúc mà không hoàn thành chu trình brainstorm + document review.

v4.3.1 — Tháng 2/2026

Chủ đề: Hỗ trợ chính thức Cursor

Tính Năng Mới

Hỗ trợ chính thức Cursor IDE. Hỗ trợ đầy đủ Superpowers cho Cursor IDE. Tất cả các skill, giao thức và Iron Laws đều có thể sử dụng qua hệ thống rules của Cursor. Tài liệu cài đặt bao gồm cấu hình dành riêng cho Cursor, bao gồm cách ánh xạ các skill vào các giao diện composer và chat của Cursor.
Giải pháp workaround dành riêng cho Cursor đối với giới hạn context window trong các session dài
Định dạng file cấu hình Cursor chuyên dụng được ghi lại

v4.3.0 — Tháng 2/2026

Chủ đề: Thực thi brainstorming

Tính Năng Mới

Hard-gate brainstorming. Công việc sáng tạo — xây dựng tính năng mới, thiết kế thành phần mới, thêm hành vi mới — giờ yêu cầu hoàn thành session brainstorm trước khi bất kỳ triển khai nào có thể bắt đầu. Đây là hard gate: agent sẽ không tiếp tục triển khai mà không có brainstorm hoàn chỉnh. Trước đây đây là khuyến nghị mềm; giờ nó được thực thi.
Yêu cầu tối thiểu của session brainstorm được chỉ định: khám phá vấn đề, ít nhất hai cách tiếp cận thay thế được xem xét, quyết định rõ ràng được đưa ra với lý do được ghi lại.

Lý Do

Phân tích các log session từ v4.2.x cho thấy 73% công việc làm lại đáng kể xảy ra trên các tính năng mà brainstorming bị bỏ qua. Khuyến nghị mềm đã không được tuân theo nhất quán. Hard gate giải quyết vấn đề này.

v4.2.0 — Tháng 2/2026

Chủ đề: Cô lập và bảo vệ main branch

Tính Năng Mới

Bắt buộc cô lập worktree. Tất cả phát triển tính năng giờ yêu cầu một git worktree. Làm việc trực tiếp trong checkout repository chính trên một feature branch không còn được phép. Mỗi tính năng, mỗi bugfix, mỗi thử nghiệm đều có thư mục worktree cô lập riêng.
Bảo vệ main branch. Commit trực tiếp vào main hiện bị nghiêm cấm rõ ràng bởi giao thức. Tất cả các thay đổi phải đi qua một branch và hoặc là local merge (với tests) hoặc là pull request.
Cập nhật Chương 8 với quy trình tạo worktree năm bước và bốn tùy chọn hoàn thành.

Tác Động

Các dự án chuyển từ v4.1.x cần áp dụng quy trình làm việc với worktree. Hướng dẫn chuyển đổi có trong tài liệu cài đặt.

v4.0.0 — Tháng 12/2025

Chủ đề: Cơ sở hạ tầng review và chuỗi công cụ debugging

Tính Năng Mới

Code review hai giai đoạn. Code review giờ là quy trình hai giai đoạn: phân tích tĩnh tự động ở giai đoạn một, review bằng subagent ở giai đoạn hai. Điều này đảm bảo các vấn đề có thể phát hiện bằng máy được bắt trước khi tiêu tốn sự chú ý của subagent, vốn được dành riêng cho các vấn đề kiến trúc và logic.
DOT flowcharts trong lập kế hoạch. Các kế hoạch triển khai giờ có thể bao gồm các DOT language flowcharts được hiển thị trực quan. Các kế hoạch nhiều bước phức tạp với các nhánh điều kiện dễ review và hiểu hơn đáng kể khi được trực quan hóa.
Bundled debugging tools. Một tập hợp các tiện ích debugging giờ được bao gồm với Superpowers: phân tích log có cấu trúc, phát hiện mẫu lỗi test và các helper phân đoạn hồi quy. Các công cụ này hỗ trợ quy trình debugging bốn giai đoạn được mô tả trong Chương 6.

Thay Đổi Không Tương Thích (Breaking Changes)

Định dạng kế hoạch được cập nhật để hỗ trợ các khối DOT flowchart. Các kế hoạch hiện có ở định dạng cũ vẫn tiếp tục hoạt động nhưng sẽ không hiển thị visual flowcharts.
Review hai giai đoạn thay đổi cấu trúc của superpowers:requesting-code-review. Cập nhật bất kỳ automation review tùy chỉnh nào.

v3.5.0

Chủ đề: Hỗ trợ nền tảng OpenCode

Tính Năng Mới

Hỗ trợ OpenCode. Superpowers giờ hỗ trợ nền tảng OpenCode. Tài liệu cấu hình và ánh xạ skill được bao gồm.

v3.3.0 — Tháng 10/2025

Chủ đề: Tích hợp Codex thử nghiệm

Tính Năng Mới

Hỗ trợ Codex thử nghiệm. Hỗ trợ early access cho OpenAI Codex. Các skill cốt lõi có sẵn; một số tính năng nâng cao bị giới hạn. Được đánh dấu là thử nghiệm — hành vi có thể thay đổi trong các bản phát hành tiếp theo.
Các giới hạn đã biết với Codex: giới hạn context window ảnh hưởng đến các session lập kế hoạch dài; một số trigger skill yêu cầu đặt tên rõ ràng thay vì phát hiện tự động.

v3.2.0 — Tháng 10/2025

Chủ đề: Tài liệu thiết kế và namespace

Tính Năng Mới

Design docs trong brainstorming. Quy trình brainstorming giờ tạo ra một design document có cấu trúc như đầu ra. Tài liệu này ghi lại các phương án đã khám phá, quyết định được đưa ra và lý do — và đưa trực tiếp vào giai đoạn kế hoạch triển khai.
Namespace superpowers:. Tất cả các Superpowers skill giờ được tiền tố với namespace superpowers: (ví dụ: superpowers:systematic-debugging, superpowers:verification-before-completion). Điều này ngăn chặn xung đột tên với các skill do người dùng tạo và làm cho các lời gọi skill trở nên rõ ràng.

Di Chuyển

Các skill từ v3.1.x không có tiền tố namespace vẫn tiếp tục hoạt động thông qua aliases. Tiền tố namespace được khuyến nghị cho tất cả các lời gọi mới.

v3.0.1 — Tháng 10/2025

Chủ đề: Di chuyển hệ thống Skills

Tính Năng Mới

Di chuyển sang hệ thống skills first-party của Anthropic. Các skill giờ được quản lý thông qua hệ thống skills first-party chính thức của Anthropic thay vì cơ chế tùy chỉnh trước đây. Điều này mang lại độ tin cậy được cải thiện, quản lý phiên bản tốt hơn và quyền truy cập vào cơ sở hạ tầng phân phối skill của Anthropic.
Tất cả các skill hiện có được di chuyển sang hệ thống mới với khả năng tương thích ngược được duy trì.
Quy trình cài đặt skill mới được ghi lại trong hướng dẫn cài đặt.

v2.0 — Tháng 10/2025

Chủ đề: Tách repository skills và mở rộng

Tính Năng Mới

Tách repository skills. Thư viện skills giờ được duy trì như một repository riêng biệt so với cấu hình Superpowers cốt lõi. Điều này cho phép các skill được cập nhật độc lập với giao thức cốt lõi, và cho phép các nhóm duy trì các repository skill riêng tư bên cạnh thư viện công khai.
9 skill mới được thêm vào:
- systematic-debugging — Giao thức debugging bốn giai đoạn
- verification-before-completion — Cổng kiểm tra 5 bước
- receiving-code-review — Sự nghiêm ngặt kỹ thuật trong phản hồi review
- requesting-code-review — Giao thức yêu cầu review có cấu trúc
- using-git-worktrees — Quy trình cô lập worktree
- writing-plans — Lập kế hoạch trước khi triển khai
- executing-plans — Thực thi kế hoạch với các checkpoint
- dispatching-parallel-agents — Điều phối multi-agent
- writing-skills — Tạo và kiểm tra skill

Ghi Chú

v2.0 đánh dấu thời điểm Superpowers trở thành một phương pháp phát triển hoàn chỉnh thay vì là một tập hợp các công cụ riêng lẻ. Chín skill trong bản phát hành này bao gồm toàn bộ vòng đời của một tính năng từ lập kế hoạch đến kiểm tra.

Các Phiên Bản Trước Đó

Các phiên bản trước v2.0 được ghi lại trong legacy changelog có trong lịch sử repository. Bản phát hành v2.0 đại diện cho một tái cấu trúc kiến trúc đáng kể; lịch sử phiên bản trước đó được giữ lại để tham khảo nhưng các giao thức được mô tả ở đó đã được thay thế.