⚡
★ 86.6k

Chapter 11: Changelog

Superpowers의 전체 릴리스 기록입니다. 릴리스는 역순(최신 먼저)으로 나열됩니다.

v5.0.2 — 2026년 3월

테마: 인프라 안정성 및 세션 관리

새로운 기능

  • Zero-dependency brainstorm server. Brainstorming companion이 이제 외부 의존성 없이 실행됩니다. Brainstorm server에 npm install이 필요하지 않습니다 — Node.js 기본 내장 모듈만으로 실행됩니다. 이를 통해 설정 실패의 원인을 완전히 제거하고, clone 후 즉시 brainstorm 기능을 사용할 수 있습니다.

  • 30분 유휴 자동 종료. 30분 동안 유휴 상태였던 장시간 실행 세션이 자동으로 정상 종료됩니다. 이를 통해 고아 프로세스를 방지하고, 리소스 소비를 줄이며, 수 시간 전 오래된 작업의 stale context가 세션에 누적되는 것을 방지합니다.

  • Context isolation 개선. Sub-agent context가 이제 parent context에서 더 엄격하게 격리됩니다. 한 agent의 조사에서 얻은 정보가 다른 agent의 추론으로 누출되지 않아, 병렬 워크스트림에서 접근할 수 없어야 할 내용을 agent가 "기억"하는 미묘한 오염 버그 유형을 방지합니다.

Bug Fixes

  • Brainstorm server가 기본 포트를 사용 중일 때 시작에 실패하는 edge case 수정
  • 깊게 중첩된 agent tree의 context 직렬화 수정

v5.0.1 — 2026년 3월

테마: 플랫폼 확장

새로운 기능

  • Gemini CLI extension 지원. Superpowers가 이제 Google의 Gemini CLI에서 extension 시스템을 통해 완전히 지원됩니다. 모든 핵심 skill — TDD, systematic debugging, verification, code review, worktree — 이 Claude Code와 동일한 강제 보장으로 Gemini CLI에서 사용 가능합니다. 설정 지침은 설치 문서에 포함되어 있습니다.

참고 사항

이 릴리스는 플랫폼 지원 릴리스입니다. 기존 skill 또는 프로토콜에 대한 동작 변경은 없습니다.

v5.0.0 — 2026년 3월

테마: 시각적 추론 및 문서 인텔리전스

새로운 기능

  • Visual brainstorming companion. 새로운 companion 모드가 brainstorming 프로세스를 인터랙티브한 시각적 다이어그램으로 렌더링합니다. Brainstorm이 진행됨에 따라 아이디어, 연결 관계, 결정 트리를 시각적으로 확인할 수 있습니다. 복잡한 아키텍처 결정 및 시스템 설계 작업에 특히 유용합니다.

  • Document review 시스템. RFC, 아키텍처 결정 기록, 설계 문서, 명세서 등 기술 문서를 code review와 동일한 엄격함으로 검토하는 새로운 기능입니다. Document review 시스템은 내부 일관성, 누락된 edge case, 명시되지 않은 가정을 확인합니다.

  • Architecture guidance skill. 아키텍처 수준의 결정을 위한 새로운 전용 skill입니다. 시스템 설계, 데이터 저장소 선택, 서비스 경계 계획, 또는 여러 컴포넌트에 영향을 미치는 결정을 내릴 때 활성화됩니다. 트레이드오프 분석을 위한 구조화된 프레임워크를 제공합니다.

Breaking Changes

  • v4.3.0의 brainstorm hard-gate가 이제 아키텍처 논의에도 적용됩니다. Brainstorm + document review 사이클을 완료하지 않으면 아키텍처 구현을 시작할 수 없습니다.

v4.3.1 — 2026년 2월

테마: 공식 Cursor 지원

새로운 기능

  • Cursor IDE 공식 지원. Cursor IDE에 대한 완전한 Superpowers 지원입니다. 모든 skill, 프로토콜, Iron Law가 Cursor의 rules 시스템을 통해 사용 가능합니다. 설치 문서에는 Cursor 전용 설정이 포함되어 있으며, skill을 Cursor의 composer 및 chat 인터페이스에 매핑하는 방법을 안내합니다.

  • 장시간 세션에서 context window 제한에 대한 Cursor 전용 workaround

  • 전용 Cursor 설정 파일 형식 문서화

v4.3.0 — 2026년 2월

테마: Brainstorming 강제 적용

새로운 기능

  • Brainstorming hard-gate. 새 기능 구축, 새 컴포넌트 설계, 새 동작 추가 등 창의적인 작업은 이제 구현을 시작하기 전에 완료된 brainstorm 세션이 필요합니다. 이것은 hard gate입니다: brainstorm을 완료하지 않으면 agent가 구현으로 진행하지 않습니다. 이전에는 소프트 권장 사항이었지만 이제는 강제됩니다.

  • Brainstorm 세션 최소 요구 사항 명시: 문제 탐색, 최소 두 가지 대안적 접근 방식 고려, 추론이 문서화된 명시적 결정.

근거

v4.2.x의 세션 로그 분석에서 중요한 재작업의 73%가 brainstorming이 건너뛰어진 기능에서 발생했음을 확인했습니다. 소프트 권장 사항은 일관되게 따라지지 않았습니다. Hard gate가 이를 해결합니다.

v4.2.0 — 2026년 2월

테마: 격리 및 main branch 보호

새로운 기능

  • 필수 worktree 격리. 모든 기능 개발에 이제 git worktree가 필요합니다. Feature branch에서 메인 repository checkout에서 직접 작업하는 것은 더 이상 허용되지 않습니다. 모든 기능, 모든 bugfix, 모든 실험은 자체 격리된 worktree 디렉토리를 갖습니다.

  • Main branch 보호. Main에 직접 commit하는 것이 이제 프로토콜에 의해 명시적으로 금지됩니다. 모든 변경 사항은 branch를 통해 로컬 merge(test 포함) 또는 pull request로 처리되어야 합니다.

  • 5단계 worktree 생성 프로세스와 4가지 완료 옵션이 포함된 Chapter 8 업데이트.

영향

v4.1.x에서 마이그레이션하는 프로젝트는 worktree workflow를 채택해야 합니다. 전환 가이드는 설치 문서에 있습니다.

v4.0.0 — 2025년 12월

테마: Review 인프라 및 debugging 도구 체인

새로운 기능

  • 2단계 code review. Code review는 이제 2단계 프로세스입니다: 1단계는 자동화된 정적 분석, 2단계는 subagent review. 이를 통해 기계로 감지 가능한 문제가 subagent의 주의를 소비하기 전에 포착됩니다. Subagent는 아키텍처 및 논리적 문제를 위해 예약됩니다.

  • 계획에서 DOT flowchart. 구현 계획에 이제 시각적으로 렌더링되는 DOT 언어 flowchart를 포함할 수 있습니다. 조건부 분기가 있는 복잡한 다단계 계획은 시각화되면 검토하고 이해하기 훨씬 쉽습니다.

  • Debugging 도구 번들. Debugging 유틸리티 세트가 이제 Superpowers에 포함됩니다: 구조화된 로그 분석, test 실패 패턴 감지, regression bisection helper. 이 도구들은 Chapter 6에 설명된 4단계 debugging 프로세스를 지원합니다.

Breaking Changes

  • DOT flowchart block을 지원하도록 Plan 형식이 업데이트되었습니다. 이전 형식의 기존 계획은 계속 작동하지만 시각적 flowchart가 렌더링되지 않습니다.
  • 2단계 review가 superpowers:requesting-code-review의 구조를 변경합니다. 커스텀 review 자동화를 업데이트하세요.

v3.5.0

테마: OpenCode 플랫폼 지원

새로운 기능

  • OpenCode 지원. Superpowers가 이제 OpenCode 플랫폼을 지원합니다. 설정 및 skill 매핑 문서가 포함되어 있습니다.

v3.3.0 — 2025년 10월

테마: 실험적 Codex 통합

새로운 기능

  • 실험적 Codex 지원. OpenAI Codex에 대한 early access 지원입니다. 핵심 skill을 사용할 수 있습니다; 일부 고급 기능은 제한됩니다. 실험적으로 표시됨 — 동작은 이후 릴리스에서 변경될 수 있습니다.

  • Codex의 알려진 제한 사항: context window 제약으로 인해 장시간 계획 세션이 영향을 받습니다; 일부 skill trigger는 자동 감지 대신 명시적 명명이 필요합니다.

v3.2.0 — 2025년 10월

테마: 설계 문서화 및 namespace

새로운 기능

  • Brainstorming에서 Design docs. Brainstorming workflow가 이제 구조화된 설계 문서를 출력으로 생성합니다. 이 문서는 탐색된 대안, 내려진 결정, 그 추론을 캡처하며 — 구현 계획 단계로 직접 연결됩니다.

  • superpowers: namespace. 모든 Superpowers skill에 이제 superpowers: namespace가 접두사로 붙습니다 (예: superpowers:systematic-debugging, superpowers:verification-before-completion). 이를 통해 사용자가 만든 skill과의 이름 충돌을 방지하고 skill 호출을 명확하게 만듭니다.

마이그레이션

namespace 접두사 없이 v3.1.x의 skill은 alias를 통해 계속 작동합니다. 모든 새 호출에는 namespace 접두사를 권장합니다.

v3.0.1 — 2025년 10월

테마: Skills 시스템 마이그레이션

새로운 기능

  • Anthropic first-party skills 시스템 마이그레이션. Skills가 이제 이전의 커스텀 메커니즘 대신 Anthropic의 공식 first-party skills 시스템을 통해 관리됩니다. 이를 통해 신뢰성 향상, 더 나은 버전 관리, Anthropic의 skill 배포 인프라에 대한 접근이 가능해집니다.

  • 모든 기존 skill이 하위 호환성을 유지하면서 새 시스템으로 마이그레이션되었습니다.

  • 새 skill 설치 프로세스가 설정 가이드에 문서화되었습니다.

v2.0 — 2025년 10월

테마: Skills repository 분리 및 확장

새로운 기능

  • Skills repository 분리. Skills 라이브러리가 이제 핵심 Superpowers 설정과 별도의 repository로 유지됩니다. 이를 통해 skill이 핵심 프로토콜과 독립적으로 업데이트될 수 있으며, 팀이 공개 라이브러리와 함께 비공개 skill repository를 유지할 수 있습니다.

  • 9개의 새로운 skill 추가:

    • systematic-debugging — 4단계 debugging 프로토콜
    • verification-before-completion — 5단계 verification gate
    • receiving-code-review — Review 응답의 기술적 엄격함
    • requesting-code-review — 구조화된 review 요청 프로토콜
    • using-git-worktrees — Worktree 격리 workflow
    • writing-plans — 구현 전 계획 작성
    • executing-plans — Checkpoint가 있는 계획 실행
    • dispatching-parallel-agents — Multi-agent 조정
    • writing-skills — Skill 생성 및 테스트

참고 사항

v2.0은 Superpowers가 개별 도구의 모음이 아닌 완전한 개발 방법론이 된 시점을 표시합니다. 이 릴리스의 9개 skill은 계획부터 검증까지 기능의 전체 lifecycle을 커버합니다.

이전 버전

v2.0 이전 버전은 repository history에서 사용 가능한 legacy changelog에 문서화되어 있습니다. v2.0 릴리스는 중요한 아키텍처 재구성을 나타냅니다; 이전 버전 기록은 참고를 위해 보존되어 있지만 거기에 설명된 프로토콜은 대체되었습니다.