AI 코딩 에이전트 워크플로우: 브레인스토밍·스펙·계획·실행을 강제하는 Superpowers 플러그인

핵심 메시지

• 유능한 코딩 에이전트도 모호한 지시를 받으면 질문도 설계도 없이 엉뚱한 코드를 자신 있게 구현해 버린다.
• Superpowers 플러그인은 브레인스토밍→스펙→계획→실행이라는 구조화된 순서를 에이전트에 강제한다.
• 설치하면 스킬이 자동으로 로드되고, 작업에 해당하는 스킬이 있으면 코드를 쓰기 전에 스스로 발동한다.
• 서브에이전트가 작업 단위로 격리된 깃 워크트리에서 일하고 매 단계 검토를 받으므로, 사람이 통제권을 유지한다.

쉽게 이해하기

코딩 에이전트는 유능하지만, 모호한 프롬프트를 주면 모호한 코드가 나온다. 질문도 하지 않고 설계 검토도 없이, 틀린 것을 자신 있게 구현해 버리는 것이 문제다. Superpowers는 에이전트에 구조화된 워크플로우를 부여하는 플러그인으로, '먼저 브레인스토밍하고, 스펙을 쓰고, 계획을 세운 뒤 실행하라'는 순서를 심는다.

설치는 깃허브의 Superpowers 저장소에서 안내를 따라 진행하며, Codex 같은 환경에 붙이면 스킬이 자동으로 인식된다. 별도 활성화 명령 없이 세션 시작 시 컨텍스트에 스킬 목록이 나타나고, 에이전트는 작업을 받을 때마다 해당하는 스킬이 있는지 먼저 확인한 뒤 어떤 스킬을 쓰는지 알린다. 이 신호로 구조화된 흐름이 작동했음을 알 수 있다.

가장 중요한 스킬은 브레인스토밍이다. 새 기능을 만들라고 하면 에이전트는 코드를 한 줄도 쓰기 전에 브레인스토밍을 발동해, 맥락 탐색 → 명확화 질문 → 접근법 제안 → 설계안 제시 순으로 진행한다. 명확화 단계에서는 한 번에 하나씩, 가능하면 객관식으로 질문해 합의를 먼저 만든 뒤에야 다음으로 넘어간다.

설계가 승인되면 에이전트는 문서 폴더에 스펙 파일을 쓴다. 아키텍처, 구성 요소, 데이터 흐름, 제약 조건 등 검토자가 접근 방식을 검증하는 데 필요한 모든 것을 담은 '계약서'다. 이어 '계획 작성' 스킬이 스펙을 읽어, 정확한 파일 경로와 코드 예시, 각 단계의 테스트 명령까지 담은 단계별 구현 계획을 만든다. 각 작업은 명확한 산출물과 테스트, 커밋으로 잘게 쪼개진다.

마지막은 서브에이전트 기반 개발이다. 계획을 넘기면 작업마다 새로운 서브에이전트가 배정되어 격리된 상태에서 코드를 쓰고 테스트를 돌린 뒤, 커밋하고 검토를 위해 제어권을 돌려준다. 각 작업이 자체 깃 워크트리에서 진행되므로 메인 브랜치를 건드리지 않고, 에이전트가 실제 코드베이스를 먼저 탐색한 뒤 작업하므로 추측이 아닌 실제 맥락 위에서 움직인다.

주요 인사이트

• 에이전트의 품질 문제는 모델 능력보다 '먼저 설계하지 않고 곧장 구현하는' 절차의 부재에서 비롯된다.
• 명확화 질문을 한 번에 하나씩 던지게 하는 것만으로도, 잘못된 가정 위에 코드를 쌓는 실패를 크게 줄일 수 있다.
• 스펙과 계획을 코드보다 먼저 문서로 남기면, 다른 사람이나 다른 에이전트가 어떤 작업이든 이어받을 수 있다.
• 작업마다 격리된 깃 워크트리를 쓰면 자동화된 구현 중에도 메인 브랜치가 보호되고 사람이 검토 지점을 유지한다.

자주 묻는 질문

관련 AI 소식