AI 코딩 에이전트를 써보신 분들은 공감하실 텐데요, 어떤 날은 시니어 개발자처럼 착착 일하다가도, 어떤 날은 테스트도 없이 코드를 밀어붙이거나 엉뚱한 방향으로 산으로 가버리죠. 이게 모델이 부족해서라기보다는 '일하는 방식'이 그때그때 달라서 생기는 문제라는 관점이 있어요. 그 관점을 가장 밀도 있게 구현한 오픈소스 프로젝트가 Superpowers인데요, 여섯 번째 메이저 버전이 나왔어요.
Superpowers가 뭐냐면
Superpowers는 Claude Code 같은 코딩 에이전트에게 '소프트웨어 엔지니어링 프로세스'를 가르치는 스킬 모음이에요. 만든 사람은 Jesse Vincent인데, Perl 커뮤니티에서 이슈 트래커의 원조 격인 RT(Request Tracker)를 만들었고 Keyboardio라는 키보드 회사를 공동 창업한 베테랑 개발자예요. 에이전트 시대가 열리자 자기 수십 년 경력의 개발 프로세스를 에이전트에게 이식하는 실험을 계속해왔고, 그 결과물이 이 프로젝트죠.
여기서 스킬(skill)이 뭐냐면, 에이전트가 특정 상황에서 꺼내 읽는 작업 지침서라고 생각하면 돼요. 신입사원에게 주는 업무 매뉴얼 같은 거예요. '디버깅할 때는 이 절차를 따라라', '계획을 세울 때는 이 형식으로 문서를 써라' 같은 노하우를 마크다운 문서로 정리해두면, 에이전트가 관련 작업을 시작할 때 그 문서를 찾아 읽고 절차대로 일하는 거죠. 모델 자체를 바꾸는 게 아니라, 모델에게 주는 '업무 규정집'을 바꾸는 접근이에요.
어떻게 일하게 만드나
Superpowers를 설치하면 에이전트의 일하는 순서가 달라져요. 코드를 짜달라고 하면 곧장 파일부터 수정하는 게 아니라, 먼저 브레인스토밍 단계에서 요구사항을 꼬치꼬치 캐물어요. 뭘 만들려는 건지, 엣지 케이스는 뭔지, 어떤 트레이드오프가 있는지를 정리한 다음에야 구현 계획 문서를 쓰죠. 구현 단계에서는 테스트를 먼저 작성하고 실패하는 걸 확인한 뒤에 구현하는 TDD, 그러니까 RED-GREEN-REFACTOR 사이클을 따르게 해요. 덩치 큰 작업은 서브에이전트(본체가 부리는 별도의 작은 에이전트)에게 쪼개서 위임하고, 결과물은 리뷰 절차를 거치고요. 사람으로 치면 시니어가 주니어 팀을 이끄는 방식을 그대로 에이전트 세계에 옮겨온 셈이에요.
이런 접근이 왜 중요하냐면, 모델 성능이 좋아져도 프로세스가 없으면 결과 품질이 복불복이기 때문이에요. 항공 업계가 조종사 개인기에 기대는 대신 체크리스트로 사고율을 낮췄던 것처럼, 에이전트도 좋은 프로세스를 따르게 하면 평균 품질이 확 올라간다는 거죠. 버전 6까지 오는 동안 이 프로젝트는 실사용 피드백을 받으면서 스킬들을 계속 갈아엎어 왔는데요, 이렇게 빠른 개편이 이어진다는 것 자체가 '에이전트 워크플로 설계'라는 분야가 아직 정답 없이 활발하게 진화 중이라는 증거이기도 해요.
업계 맥락: 프롬프트에서 프로세스로
큰 흐름에서 보면, 프롬프트 한 줄을 잘 쓰는 시대에서 에이전트의 업무 프로세스를 설계하는 시대로 넘어가는 중이에요. 프로젝트 규칙을 담는 CLAUDE.md나 AGENTS.md 같은 컨벤션, 에디터별 rules 기능이 비슷한 문제의식을 공유하고 있죠. MCP(Model Context Protocol)가 에이전트와 외부 도구를 연결하는 표준이라면, 스킬은 '지식과 절차'를 패키징해서 나눠 쓰는 방식에 가까워요. Superpowers는 그 스킬이라는 그릇에 뭘 담아야 하는지를 보여주는 대표 사례고요.
한국 개발자에게 주는 시사점
오픈소스라서 Claude Code를 쓰고 있다면 플러그인으로 설치해서 바로 체험해볼 수 있어요. 그런데 더 가치 있는 건 아이디어 자체를 가져오는 거예요. 우리 팀의 코드 리뷰 기준, 배포 절차, 장애 대응 노하우, 자주 하는 실수 목록 같은 걸 스킬 문서로 정리해서 에이전트에게 주면, 결과물 품질이 눈에 띄게 달라지거든요. 팀의 암묵지를 문서화하라는 건 십 년 넘게 들어온 잔소리인데, 이제는 그 문서를 사람만 읽는 게 아니라 에이전트가 실시간으로 읽고 그대로 일하니까, 문서화의 보상이 즉각적으로 돌아오는 시대가 된 거죠. 어떤 지침이 실제로 효과가 있는지 실험하고 다듬는 과정 자체가 새로운 엔지니어링 역량이 되고 있어요.
한 줄 정리: Superpowers 6은 '좋은 모델'만큼이나 '좋은 프로세스'가 에이전트 품질을 좌우한다는 걸 보여주는 프로젝트예요. 여러분은 코딩 에이전트에게 어떤 규칙이나 절차를 주고 계신가요? 효과 봤던 지침이 있다면 댓글로 나눠주세요.
🔗 출처: Hacker News