매일 아침, 어제의 AI를 한 통으로 정리해 보내드립니다메일로 받아보기

METAL LAB

obra/superpowers

★ 274,467오늘 +557Shell

AI 코딩 에이전트가 곧장 코드부터 짜지 못하게, 기획-계획-테스트-리뷰 순서를 강제하는 규칙집

Superpowers는 Claude Code나 Codex 같은 코딩 에이전트가 무작정 코드를 작성하는 대신 정해진 절차를 따르게 만드는 재사용 가능한 '스킬' 모음과 시작 지침이다. 에이전트는 대화를 통해 요구사항을 구체화하고, 세부 실행 계획을 세운 뒤, 하위 에이전트들이 각 작업을 테스트 우선 방식으로 구현하고 2단계 코드 리뷰를 거치도록 이끈다. 하나의 도구에 국한되지 않고 여러 코딩 에이전트 플랫폼에 플러그인 형태로 설치할 수 있다.

무엇을 하는 레포인가

  1. 문제의식: 코딩 에이전트들이 명확한 설계, 계획, 테스트 없이 바로 코드를 작성해 결과물이 엉성해지거나 요구사항과 어긋나는 경우가 많다.
  2. 해결 방식: 아이디어를 질문으로 구체화하는 브레인스토밍, 2~5분 단위의 작은 작업으로 쪼갠 실행 계획 작성, 작업별 하위 에이전트 투입, RED-GREEN-REFACTOR 방식의 테스트 주도 개발(TDD), 스펙 준수와 코드 품질을 각각 확인하는 2단계 코드 리뷰까지 여러 '스킬'을 자동으로 연쇄 발동시킨다.
  3. Claude Code, Antigravity, Codex App/CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Hermes Agent 등 다양한 코딩 에이전트 환경에 플러그인/확장 형태로 설치된다.
  4. 결과: 합의된 계획에서 벗어나지 않도록 계획과 리뷰가 에이전트를 계속 붙잡아 주기 때문에, 에이전트가 몇 시간씩 자율적으로 작업을 이어가는 경우도 드물지 않다고 소개한다.
  5. 이 저장소는 스타 274467개를 받았고 주 언어는 셸(Shell)이며, Jesse Vincent와 Prime Radiant가 관리한다. 선택적으로 버전 정보만 담긴 익명 사용량 텔레메트리를 수집하며 환경변수로 끌 수 있다.

왜 중요한가

AI 코딩 에이전트를 실무에 쓰는 사람이라면, 검토받지 않고 테스트도 안 된 코드가 그대로 배포되는 위험을 줄일 구체적인 절차를 얻을 수 있다. 또한 특정 도구에 종속되지 않고 여러 에이전트 플랫폼에 걸쳐 일관된 작업 흐름을 설계하는 참고 사례로도 유용하다.

이 레포의 용어

  • 스킬(skill) · 특정 상황에서 에이전트가 자동으로 불러 쓰는, 재사용 가능한 독립 지침 모듈
  • RED-GREEN-REFACTOR · 실패하는 테스트를 먼저 작성(레드)하고, 최소한으로 통과시킨 뒤(그린), 코드를 정리(리팩터)하는 테스트 주도 개발 순환
  • 서브에이전트 주도 개발 · 작업 하나마다 새 하위 에이전트를 투입해 처리시키고, 그 결과를 검토한 뒤 다음으로 넘어가는 방식
  • YAGNI · '지금 필요 없는 건 만들지 마라'는 뜻의 소프트웨어 개발 원칙
  • 워크트리(worktree) · 하나의 git 저장소에서 별도의 작업 폴더를 분리해 브랜치 작업을 독립적으로 진행하는 방식

레포 원문 소개 (영문)

An agentic skills framework & software development methodology that works.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

METAL LAB 최신 기사