obra/superpowers — 코딩 에이전트용 스킬 프레임워크와 개발 방법론

AI 요약

Superpowers는 코딩 에이전트가 코드를 바로 작성하는 대신, 개발자가 원하는 결과를 먼저 확인하고 정해진 절차에 따라 작업하도록 구성한 개발 방법론입니다. 에이전트가 대화에서 명세를 다듬고, 읽기 쉬운 분량으로 설계를 제시하면 개발자가 검토합니다. 승인 뒤에는 주니어 엔지니어도 따라갈 수 있도록 파일 경로와 코드, 검증 단계를 담은 작은 작업 단위로 구현 계획을 작성합니다.

설계부터 구현까지 이어지는 스킬

설계 승인 뒤에는 Git worktree를 만들고 테스트 기준 상태를 확인합니다. 구현 과정에서는 RED-GREEN-REFACTOR 방식의 테스트 주도 개발(TDD)을 적용합니다. 먼저 실패하는 테스트를 작성하고, 테스트를 통과하는 최소한의 코드를 구현한 다음 리팩터링합니다. 계획에 따라 작업할 때는 각 작업마다 새 하위 에이전트를 배정해 검토하거나, 현재 세션에서 구현한 뒤 전체 브랜치를 한 번 검토하는 방식을 선택합니다. 코드 리뷰와 테스트 확인, 병합·PR·브랜치 유지·폐기 선택도 별도 스킬로 다룹니다.

스킬에는 체계적 디버깅, 완료 전 검증, 코드 리뷰 대응, 병렬 에이전트 실행도 포함됩니다. 에이전트는 작업마다 관련 스킬을 확인하며, 저장소는 이를 선택 사항이 아닌 필수 작업 흐름으로 설명합니다. 세션에서 스킬이 잘못 작동하거나 계획을 따르지 않는 경우에는 대화 기록을 근거로 원인을 진단하는 스킬도 제공합니다.

여러 코딩 에이전트 환경 지원

저장소는 Claude Code, Codex, Cursor, Gemini, Pi, OpenCode 등 여러 도구의 플러그인이나 확장 기능으로 설치할 수 있도록 안내합니다. 설치 방법은 도구마다 다르며, 여러 도구를 사용한다면 각각 따로 설치해야 합니다. 스킬 동작은 superpowers-evals의 drill 평가 도구로 시험하고, 플러그인 기반 시설 테스트는 tests 디렉터리의 스크립트나 npm test로 실행합니다.

프로젝트는 MIT 라이선스를 따릅니다. 선택형 시각 기능은 사용 중인 Superpowers 버전 정보만 웹사이트에 전달하며, 프로젝트나 프롬프트, 사용 에이전트 정보는 포함하지 않는다고 안내합니다. 이 기능은 SUPERPOWERS_DISABLE_TELEMETRY 환경 변수로 끌 수 있습니다.

원문: GitHub / 번역·요약: Trawling