지난 호 Gstack 활용에 이어서, 이번에는 Superpowers라는 skill을 사용해보려고 한다.

 

Superpowers는 ‘로버트 치알딘’이라고 하는 심리학자의 설득의 심리학의 6가지 항목을 LLM에 적용하였고, 따라서 권위의 원칙, 일관성의 원칙 등 심리학의 원칙들이 들어가 있다고 한다. Gstack과 마찬가지로 superpowers도 바로 코딩을 시작하지 않는다. 백문이 불여일견이니, 우선 설치부터 시작해보도록 하자.

 

 


 

 

#1. superpowers 설치하기

 

 

superpowers는 클로드코드 플러그인 마켓플레이스에서 설치가 가능하다. (코덱스도 가능) 아래 링크를 통해 설치 방법에 대해서 확인해보자.

>> https://claude.com/plugins/superpowers

 

아니면 아래 명령어를 직접 클로드코드에 붙여넣기 해도 된다.

claude plugin install superpowers@claude-plugins-official

 

 


 

 

#사용가능한 Skills

 

 

· brainstorming – 코드를 작성하기 전에 활성화. 질문을 통해 초기 아이디어를 다듬고, 대안을 탐색하며, 검증을 위해 설계를 부분별로 제시. 설계 문서를 저장

 

· using-git-worktrees 설계 승인 후 활성화됨. 새 브랜치에 격리된 작업 공간을 생성하고, 프로젝트 설정을 실행하며, 테스트 기준선이 제대로 설정되었는지 확인

 

· writing-plans 승인된 디자인으로 활성화, 작업을 2~5분 정도의 짧은 작업으로 나누어 줌. 모든 작업에는 정확한 파일 경로, 전체 코드, 검증 단계가 포함되어 있음

 

· subagent-driven-development or executing-plans 계획에 따라 활성화. 2단계 검토(사양 준수, 코드 품질)를 거쳐 작업별로 새로운 서브에이전트를 배포하거나, 사람의 검토를 거쳐 일괄적으로 실행

 

· test-driven-development(TDD) 구현 중에 활성화됨. 레드-그린 리팩토링(RED-GREEN-REFACTOR) 방식을 적용함. 즉, 실패하는 테스트를 작성하고, 실패하는 것을 확인한 후, 최소한의 코드만 작성하고, 테스트 통과를 확인한 다음 커밋함. 테스트 전에 작성된 코드는 삭제됨.

 

· requesting-code-review 작업 사이에 활성화, 계획 대비 검토를 수행하고 심각도별로 문제를 보고함. 심각한 문제는 진행을 차단함.

 

· finishing-a-development-branch 작업이 완료되면 활성화, 테스트를 검증하고, 옵션(병합/PR/유지/폐기)을 제시하며, 작업 트리를 정리함

 

 


 

 

에이전트는 모든 작업을 시작하기 전에 관련 기술을 확인하지만, 제안사항을 필수 워크플로로 간주하지는 않는다.

이제 superpowers를 활용해 간단한 스킬을 하나 만들어보도록 하자.

 

신규 아이디어, 혹은 기본 수정, 개선사항만 적어도 1pager와 PRD와 간단한 ascii code기반의 와이어프레임을 그려주는 클로드코드 스킬을 하나 만들어보려고 한다.

 

먼저 claudecode에게 가볍게 물어보도록 하자.

skill을 하나 만들려고해. /하고 스킬명 적으면 바로 해당 스킬을 실행시켜서 원하는 작업을 할 수 있도록. 어디서 부터 시작하면 될지, 프로세스 간단히 설명해줘.

 

 

superpowers의 writing-skill을 먼저 로딩하는 걸 보니, 앞단의 아디이더 상세 검증, 기획 단계를 우선 넘어가는 것으로 보여져서, 다시 brainstorming 세션을 진행해달라고 요청해보았다.

 

 

superpowers의 brainstorming 세션

 

 

오. 이제 brainstorming skill이 구동되면서, 원하던 질문 항목으로 시작하게 되었다.

이제부터 brainstorming을 통해 제공되는 질문에 하나씩 답해보도록 하겠다.

 

  • 스킬명은?
    • 스킬명은 idea2planning으로 할게

 

  • 사용자가 어디서부터 시작하면 되고 무얼 얻고 싶을까?
    • 우선 막연한 아이디어가 있어도 시작할 수 있으면 좋겠어.
      아이디어를 어느정도 수준으로 가져갈지는, 이렇게 생각해봤어.신규 아이디어, 혹은 기본 수정, 개선사항만 적어도 1pager와 PRD와 간단한 ascii code기반의 와이어프레임을 그려주는 스킬을 만들고 싶어.

 

  • 이 스킬의 주요 사용자는 누구인가요?
    • it분야에 일하는 주니어들이 주요 사용자이고, 미들급이나 시니어들도 충분히 업무생산성에 도움이 될거라 생각해. 도메인 직군별로는 PM이나 Product Designer들이 주로 도움될거라 생각하고.

 

  • PM, PD 직군 주니어들이 메인이군요. 그럼 이 스킬의 인터랙션 방식은 어떻게 생각하세요?
    • 생각해보니, 처음에 물어보면 좋겠다.이 스킬로 1) 1pager를 통해 명확한 문제정의가 포함된 PMF까지 고려된 문서를 정의할 것인지, 2) prd수준의 개발자와 디자이너 커뮤니케이션을 위한 스펙 문서를 만들건지, 아니면 3) ascii코드 기반의 와이어프레임 아이데이션을 할 것인지. 4) 아니면 1번부터 차근차근 만들어갈 것인지, 5) 모르겠고, 내 아이디어 부터 설명해볼게. > 처럼 모르겠다고 하면 아이디어 듣고 나서 어떤 단계부터 하는 것이 좋을지 추천해주면 좋을 것 같아. 추천 순서는 1,2,3 순서가 되겠지? (물론 아이디어가 아니라 기본 PRD문서 있어! 혹은 난 그냥 아이디어를 wireframe으로만 먼저 받아보고 싶어! 라면 맞는 단계로 추천해주면 돼)
      이 정도?
      그리고 1번이 마무리되면 2번으로 갈건지 물어보고, 2번 마무리되면 3번으로 갈건지 물어보는 식으로 구성되면 좋겠어.

 

  • 생성되는 문서의 언어는 어떻게 할까요?
    • 사용자가 아이디어를 입력한 언어로 자동 맞춤

 

중간에 질문이 하나 더 생겨서 물어보았다.

    • 1pager 문서들을 참조할 수 있게 해당 폴더를 만들고 참조할 수 있는 문서를 몇 개 넣어둘까 하는데, skill을 만들 때는 이런 방식이 어려울까?

 

 

 

 

이후 skill이 필요한 md파일들을 만들기로 했고, 해당 파일들을 reference폴더 하위에 넣을 수 있도록 아래와 같이 만들어두었다.

 

 

 

 

템플릿 파일을 만드는데 시간이 좀 걸렸고, 해당 example의 사례들은 dummy data로 만들어 사례들을 함께 첨부해두었다. 실무적으로 사용해본다면 이 reference영역에 실제 실무 파일을 하나씩 업로드 해두어도 좋겠다.

 

같이 이런저런 이야기들을 도란도란 나누다 보니, 어느새 참조파일 세트가 모두 완료되고

 

 

 

 

그리고 이어서 진행하다 보니 이렇게 idea2planning skill의 디자인.md파일 또한 만들어주었다. 전체 이 skill이 어떻게 동작하고 무엇을 위해 만들어졌고 등에 대한 내용을 잘 설명해주고 있다.

 

 

skill의 전체 가이드 문서

 

 

이제 brainstorming을 통한 앞단의 논의는 마무리되었다. writing-plans로 넘어가보도록 하자.

 

클로드에는 아래와 같이 적어보았다.

스펙 확인했어, 이제 구현계획으로 넘어가자

 

 

당연히 1번 방식으로 진행 시작.

 

 

 

 

이제 /idea2planning을 스킬로 등록해두었고, 언제든지 사용할 수 있다고 한다.

 

어느 시점에서 TDD(Test Driven Development)나 code-review를 진행했는지가 궁금하여 한번 내용을 문의해보았더니 TDD는 skill을 만드는 것에는 필요하지 않기 때문에 skip, 그리고 code-review의 경우는 앞 선 task별 스펙 리뷰에 이미 포함되어 있었다고 한다. 허허.

 

그리고 브레인스토밍을 통해 충분히 검증했기 때문에 writing-plan에서도 베이스라인 테스트는 패스했다고 대답한다.

 

이제 스킬이 모두 만들어졌기 때문에, 바로 활용하면 되겠지만, 다른 사람들도 쉽게 github에서 다운로드 받아서 사용하면 좋을 듯 하여 아래와 같이 확인해보았다.

 

그런데 이 스킬을 다른 사람도 쉽게 사용하고 확장/추가해도 좋을 것 같은데. github에 올리고 파일관리하면 더 편하지 않을까?

 

 

>> https://github.com/pentaxzs/skill-idea2planning

 

설치방법은 아래와 같다.

 

✅ 스킬 디렉토리에 클론

git clone https://github.com/pentaxzs/skill-idea2planning ~/.claude/skills/idea2planning

 

github를 통해 해당 skill을 설치해볼 수 있고, 결과가 궁금하다면 사용해보시고 피드백을 알려주셔도 좋겠다. 🙂

 

해당 리포의 reference등 파일이 업데이트된 경우, 아래와 같은 방식을 통해 업데이트된 파일 기준으로 skill을 이용할 수 있다. 물론 지금 reference 기준으로 사용해보아도 기본 적인 기준으로 활용하기는 충분해 보이긴 한다.

 

현재 클로드 터미널 명령어로 표기할 때는 아래와 같이.

! cd ~/.claude/skills/idea2planning && git pull

 

별도 터미널에서 해당 변경사항을 다시 업데이트 하기 위해서는 아래와 같이 명령어를 실행하면 최신 업데이트된 버전의 스킬로 사용가능하다.

cd ~/.claude/skills/idea2planning
git pull

 

참고로 ‘마케팅 배너 개선’이라는 주제로 간단히 테스트를 진행해보았고, 각각의 결과는 아래와 같다.

앱 화면 상단에 있는 마케팅 배너의 클릭률이 떨어지고 있어. 개선할 수 있을지에 대한 고민이 있는데, 1pager 부터 작성 부탁해.

 

 

#1-pager

 

 

 

#PRD

 

 

 

#Wireframe

 

 

 


 

 

오늘의 superpowers 사용후기는 여기서 마무리하려고 한다.

 

이 외 정말 상세하게 잘 소개해준 글이 있어 소개해본다. 더 궁금하다면 superpowers에 대해서 아래 내용을 통해서도 확인해보면 좋겠다.

>> https://maily.so/makersnote/posts/1do1dwqlox6

 

 


Reference

– https://github.com/obra/superpowers
– https://www.youtube.com/watch?v=308zzinIVSA
– https://maily.so/makersnote/posts/1do1dwqlox6


해당 글은 글쓰는몽글C 님과 모비인사이드의 파트너쉽으로 제공되는 기사입니다.