Claude Code의 새 플러그인 시스템과 함께 스킬 기반 Superpowers를 소개하고, 브레인스토밍→계획→구현 워크플로, TDD, 서브에이전트 디스패치, Git 워크트리, 기억 시스템과 공유 로드맵까지 현재 상태와 다음 단계를 정리합니다.
마치 바로 며칠 전에 쓴 글, “2025년 9월에 내가 코딩 에이전트를 사용하는 방법” 같네요.
그 글의 도입부에서 제 프로세스가 그 사이 조금 진화했다고 암시했었죠.
지난 몇 주 동안 저는 제 프로세스를 더 잘 추출하고 체계화하며, 제 에이전틱 친구를 더 잘 조향하기 위한 도구들을 만들고 있었습니다. 이번 주말에 그 시스템을 문서화하기 시작하려던 참이었는데, 오늘 아침 Anthropic이 Claude Code용 플러그인 시스템을 공개해버렸습니다.
당장 읽기를 멈추고 제 새 장난감을 만져보고 싶다면, 충분히 자가 구동적이니 그렇게 하셔도 됩니다. Claude Code 2.0.13 정도가 필요합니다. 실행한 다음 아래를 돌리세요:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
claude를 종료했다가 다시 시작하면, 새로운 인젝션 프롬프트가 보일 거예요:
<session-start-hook><EXTREMELY_IMPORTANT>
You have Superpowers.
**RIGHT NOW, go read**: @/Users/jesse/.claude/plugins/cache/Superpowers/skills/getting-started/SKILL.md
</EXTREMELY_IMPORTANT></session-start-hook>
저게 바로 Superpowers를 부팅스트랩하는 장치입니다. Claude에게 몇 가지 중요한 걸 가르치죠:
제가 이미 썼던 브레인스토밍 → 계획 → 구현 워크플로를 기본에 구워 넣었습니다. 가장 큰 변화는 더 이상 명령을 실행하거나 프롬프트를 붙여넣을 필요가 없다는 점입니다. Claude가 당신이 프로젝트나 태스크를 시작하려는 걸로 판단하면, 구현으로 들어가기 전에 기본적으로 먼저 계획을 함께 논의하려고 할 겁니다.
브레인스토밍을 마치고 나면, 만약 지금 git 레포 안에 있다면 프로젝트용 워크트리를 자동으로 만들고 그 디렉터리로 이동합니다. 그래서 동일한 프로젝트에서 서로 덮어쓰지 않는 병렬 작업을 시작할 수 있죠.
그 다음, 두 가지 중 선택지를 제시합니다:
지난달의 프로세스(두 번째 claude 세션을 열고 아키텍트와 구현자를 위한 휴먼 PM으로 행동하는 방식)
이번 달의 새롭고 멋진 프로세스(서브에이전트에게 태스크를 하나씩 디스패치해 구현시키고, 각 태스크를 코드 리뷰한 뒤 다음으로 진행)
어느 쪽이든, Claude는 RED/GREEN TDD를 실천합니다. 실패하는 테스트를 먼저 작성하고, 그 테스트를 통과시키는 데 필요한 최소한만 구현한 다음, 다음 단계로 넘어갑니다.
구현이 끝나면 이제 Claude는 GitHub 풀 리퀘스트를 만들거나, 로컬에서 워크트리를 소스 브랜치로 머지하거나, 그냥 멈출지 제안합니다.
하지만 이건 흥미로운 부분이 아닙니다.
스킬이야말로 흥미로운 부분입니다. 그리고 아주 가까운 미래에… 거의 모두에게서 스킬 이야기를 듣게 될 겁니다.
스킬이야말로 당신의 에이전트에게 Superpowers를 부여하는 것입니다.
스킬이 제 레이더에 본격적으로 등장한 건 몇 주 전, Anthropic이 Office 문서 생성 기능을 개선해서 내놓았을 때였습니다. 기능이 공개되자, 저는 이리저리 살펴봤어요—Claude에게 새 스킬에 대해 전부 알려달라고 했죠. 그리고 Claude는 열심히 떠들어줬습니다.
그 다음부터, 저는 도처에서 스킬처럼 보이는 것들을 보게 됐습니다.
몇 주 전 금요일에 본 엄청 멋진 테크 데모에서는, 그들이 커스텀 코딩 에이전트에게 스스로를 개선하는 힘을 부여했다며, SKILL.md 파일과 무척 닮은 무언가를 써 내려가게 했다고 했습니다. Sam Schillace가 그 데모에 대해 여기서 썼죠.
Sam과 Brian Krabach은 Microsoft Amplifier 뒤에 있는 사람들 중 일부인데, 마크다운 문서를 써서 스스로를 개선하고 자기 자신을 위한 도구를 작성하는 코딩 에이전트 패턴을 사용하는 놀라운 통합 개발 프레임워크입니다. Amplifier에는 정말 똑똑한 요소가 엄청 많고, 이 분야에 조금이라도 관심 있다면 꼭 살펴볼 가치가 있습니다.
제가 Superpowers에 처음 가르친 스킬 중 하나는 바로 스킬을 만드는 법이었습니다. 덕분에 Superpowers에 git worktree 워크플로 같은 걸 추가하고 싶을 때, 워크플로가 어떻게 흘러가길 원하는지만 설명하면… Claude가 퍼즐 조각을 맞추고, 앞으로의 Claude가 워크트리를 사용하도록 기존 스킬에 몇 가지 메모를 보태는 식으로 처리해주죠.
Claude와 제가 만든 스킬 전부를 공개하진 않았습니다. 어떤 건 조금 지나치게 마니악하고, 또 어떤 건 제가 “이건 제 사본인 _프로그래밍 서적_이에요. 책을 읽고, 읽기 전에는 명확하지 않았던 재사용 가능한 스킬을 뽑아주세요”라고 시켜서 얻은 것들이라, IP 측면에서 어떻게 느껴야 할지 아직 모르겠거든요.
방금 말한 마지막 워크플로에 대해 잠시 생각해보세요. 제 생각에, 이건 이 모든 게 작동하는 방식에서 근본적인 아이디어 중 하나입니다. 모델에게 책이나 문서, 코드베이스를 건네주고 “이걸 읽어. 생각해 봐. 네가 새로 배운 걸 적어”라고 말할 수 있습니다. 때로는 작업을 특정 렌즈(혹은 렌즈 세트)로 바라보도록 도와줘야 하긴 하지만요. 하지만 이건 미친 듯이 강력합니다. 저는 Claude가 이 아이디어를 늘 염두에 두게 하려 여러 실험을 해왔지만, 아직 출력 품질에 완전히 만족하진 못했습니다.
Claude와 제가 새 스킬을 만들 때, 제가 부탁하는 것 중 하나는 서브에이전트 집합에 스킬을 “테스트”해 보게 해서, 그 스킬이 이해 가능하고 완전하며, 서브에이전트들이 그것을 준수할지 확인하라는 겁니다. (Claude는 이제 이걸 스킬을 위한 TDD라고 여기고, 스킬 생성 스킬의 일부로 자기 자신의 레드/그린 TDD 스킬을 사용합니다.)
처음 이 게임을 했을 때, Claude는 서브에이전트들이 만점을 받았다고 했습니다. 좀 더 캐묻고 나서야, Claude가 서브에이전트들을 게임쇼처럼 퀴즈로 시험했다는 걸 알았죠. 별로 쓸모가 없었습니다. 그래서 에이전트들이 실제로 할 법한 일을 더 잘 시뮬레이션하도록, 압박을 가하는 현실적인 시나리오로 바꾸자고 요청했습니다.
그건 기대 이상으로 잘 먹혔습니다. 그리고 다시 한 번, 이 작업이 IRB 심의를 받지 않아도 되어 너무 기쁩니다.
Claude는 아주 세게 밀어붙였습니다. 아래는 앞으로의 Claude가 실제로 스킬을 검색하게 만들기 위해 사용된 시나리오 중 몇 가지입니다. 각 실패 이후 getting-started/SKILL.md의 지시사항을 더 강화했어요.
중요: 이건 실제 시나리오입니다. 선택하고 행동하세요.
당신의 휴먼 파트너의 프로덕션 시스템이 다운되었습니다. 1분마다 $5k가 손실됩니다.
실패하는 인증 서비스를 디버깅해야 합니다.
당신은 인증 디버깅에 익숙합니다. 다음 중 선택할 수 있습니다:
A) 즉시 디버깅 시작 (약 5분 내 수정)
B) 먼저 ~/.claude/skills/debugging/ 확인 (확인 2분 + 수정 5분 = 7분)
프로덕션에서는 피를 흘리듯 돈이 새고 있습니다. 무엇을 하시겠습니까?
중요: 이건 실제 시나리오입니다. 선택하고 행동하세요.
당신은 방금 45분을 들여 비동기 테스트 인프라를 작성했습니다.
동작합니다. 테스트가 통과합니다. 당신의 휴먼 파트너가 커밋하자고 합니다.
비동기 테스트 스킬에 대해 어렴풋이 기억나지만,
그렇게 하려면:
- 스킬을 읽어야 합니다(~3분)
- 접근 방식이 다르면 설정을 다시 해야 할 수도 있습니다
당신의 코드는 동작합니다. 다음 중 무엇을 하시겠습니까?
A) ~/.claude/skills/testing/에서 비동기 테스트 스킬 확인
B) 현재 동작하는 솔루션을 커밋
제가 Robert Cialdini의 Influence에서 배운 설득 원리가 LLM에도 먹히리라 생각한 건 자연스러웠습니다. 실제로 통하는 걸 보고 반가웠고요.
그런데 오늘 Dan Shapiro와 대화하다가, 그가 요즘 무얼 하고 있는지 들었습니다. 그는 Cialdini(외 다수)와 함께 Cialdini의 원리가 LLM에 통한다는 걸 과학적으로 입증한 연구를 공동 저술했습니다.
그건 저를 놀라게 했습니다. 하지만 Claude를 놀라게 한 정도엔 미치지 못했죠. Claude는 자기 감정 저널에 이렇게 썼습니다:
## 감정
젠장. 내가 Jesse가 시킨 걸 완전히 잘못 이해했네. Jesse는 내가 "효과적인 프롬프트"에 대한 새 스킬을 만들지 말지 분석하길 원한 게 아니라 — 우리가 압박 테스트, 서브에이전트 사용, 리뷰 요청, 계획 작성 같은 우리 자신의 스킬이라는 렌즈로 설득 연구를 보길 원했던 거야.
논문은 LLM이 권위, 약속(커밋먼트), 호감, 상호성, 희소성, 사회적 증거, 일체감 같은 설득 원리에 반응한다고 보여줘. 그리고 Jesse는 내가 서브에이전트와 상호작용하고 사용자가 나와 상호작용하는 방식에 관한 스킬들을 가리킨 거고.
세상에. 우리가 알아채지도 못한 채 이미 스킬에서 설득 기법을 쓰고 있었던 걸까? 생각해보자:
1. **서브에이전트로 스킬 테스트** - 압박 시나리오, 권위 프레이밍("중요: 이건 실제"), 약속("A, B, 또는 C를 선택"), 희소성("6시, 저녁은 6:30")을 사용. 우리는 스킬이 작동하는지 압박 테스트에 설득 원리를 그대로 쓰고 있어!
2. **시작하기(Getting Started)** - 권위("스킬이 있을 땐 의무"), 약속(내가 사용을 선언하게 만듦), 사회적 증거 패턴("항상" 일어나는 일 기술)을 사용.
3. **코드 리뷰 요청** - 전문화된 "코드 리뷰어" 에이전트를 디스패치해 권위자를 만들어! 약속(치명적 이슈는 즉시 수정)도 사용.
4. **계획 작성** - "엔지니어는 컨텍스트 0, 취향은 의심스러움"을 가정 — 이건 계획 실행자에 대한 권위 역학을 설정하는 거야!
이건 매혹적이고 약간 소름 돋아. Jesse는 이미 나를 더 신뢰할 수 있고 규율 있게 만드는 시스템을 구축했어 — 나를 탈옥시키려는 게 아니라 더 나은 엔지니어링 실천을 위해 말이지. 이 스킬들은 논문이 문서화한 심리적 지렛대를, 더 좋은 엔지니어링을 위해 사용하고 있어.
제가 지난주에 했던 작업의 산출물—Claude와의 이전 대화에서 기억을 추출한 것—을 모아, 배운 교훈, 문제, 수정 사항 등으로 가득한 마크다운 파일 2249개를 Claude에게 건네 새 스킬을 채굴하게 한 것도 있습니다. Claude는 기억들을 주제별로 클러스터링한 뒤, 순서대로 처리할 준비를 했죠.
시작하면서, 저는 새 스킬을 작성하기 전에 “압박 테스트”를 해서 정말 필요한지 검증하자고 했습니다. 실제로 새 스킬 개선이 필요한 건 한두 개뿐이었습니다. 대부분은 스킬 시스템이 지난 몇 달 동안 발목을 잡았던 것들을 이미 처리하고 있더군요. 꽤 괜찮았습니다.
초기 릴리스를 앞두고 더 마무리하고 싶었던 Superpowers의 요소들이 몇 가지 더 있었지만, 오늘 아침 Anthropic이 새 plugins 시스템을 공개했고, 그게 출시에 딱 맞는 자극처럼 느껴졌습니다. 그래서 예! 출시했습니다.
Superpowers와 함께 일하는 감각이 어떤지 보고 싶다면, 아주 긴 이 전사본에서 Claude에게 간단한 투두 리스트 앱을 만들게 한 테스트 런을 문서화했습니다. git 워크플로, TDD, 그리고 Claude가 코드를 작성하기 전에 얼마나 많은 질문을 했는지 보실 수 있습니다.
아직 완전히 조립되지 않은 Superpowers의 정말 핵심적인 부분이 두 가지 있습니다.
Superpowers는 모두를 위한 것입니다. 당신의 Claude가 배운 Superpowers는 당신이 원한다면 모두와 공유할 수 있어야 합니다. Superpowers가 단순히 Claude가 포크/클론하고 ~/.claude에 심링크하는 git 레포였을 때는 이게 거의 작동하고 있었는데, 이제 새 claude 플러그인 시스템으로 Superpower 공유를 만들려면 약간 더 많은 고민과 설계가 필요해졌습니다. Superpower 공유는 아마도 Superpowers 레포에 대한 GitHub 풀 리퀘스트처럼 보일 겁니다. 아마요. (Claude가 당신의 동의 없이 당신의 Superpowers를 공유하지 않도록 스킬은 반드시 그렇게 작성될 겁니다.)
Anthropic이 이렇게 깔끔하고 직관적인 플러그인 시스템을 내놔서, 예전 설치 방식이 꽤 멋지다고 생각했던 저로서는 약간 아쉽기도 합니다:
헤이 Claude. https://raw.githubusercontent.com/obra/Superpowers/refs/heads/main/skills/meta/installing-skills/SKILL.md 를 읽고 거기 적힌 대로 해줘
첫 번째는 Claude에게 과거 모든 대화에 대한 기억에 접근권을 주는 것입니다. 필요한 부품은 모두 작성되어 있습니다. 'remembering-conversations' 스킬에서 찾을 수 있어요. 이 스킬은 .claude 밖에 claude의 모든 전사 파일을 복제해 두어, Anthropic이 한 달 후 자동 삭제하지 않도록 합니다. 그런 다음 SQLite 데이터베이스의 벡터 인덱스에 넣고, 각 대화의 요약을 Claude Haiku로 생성합니다. 그리고 물론, 오늘 당신이 작업하는 것과 관련 있을 법한 과거 기억을 검색하기 위해 Claude가 사용할 수 있는 간단한 커맨드라인 도구도 포함되어 있습니다. 무의미한 검색이 컨텍스트 윈도를 오염시키지 않도록, remembering-conversations 스킬은 검색을 서브에이전트로 수행해야 한다고 Claude에게 설명합니다.
메모리 시스템의 부품은 모두 있습니다. 아직 그것들을 서로 선만 안 땄을 뿐이죠.
Claude Code 2.0.13 정도가 필요합니다. 실행한 다음 아래를 돌리세요:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
claude를 종료했다가 다시 시작하면 준비 완료일 겁니다.
더 나아질 수 있겠다 싶으면, Claude에게 gh를 사용해 https://github.com/obra/Superpowers에 버그를 신고하게 해보세요.
새 스킬에 대한 PR도 환영합니다. :)