에이전트가 단순히 코드를 짜는 도구를 넘어, 스스로를 개선하고 엄격한 워크플로우를 준수하는 ‘슈퍼파워’를 갖게 된다면 어떨까요? Jesse Vincent가 2025년 10월에 공개한 Superpowers 는 Claude Code를 위한 단순한 플러그인 그 이상입니다. 이는 에이전트의 행동을 규정하는 ‘스킬(Skills)‘을 핵심 추상화로 삼고, 이를 통해 개발 프로세스 전체를 체계화하는 방법론입니다.
더보기
Claude Code를 오래 쓰다 보면 한 가지 패턴이 반복됩니다. 요청을 던지면 바로 코딩은 시작되는데, 질문이 부족하고 설계가 얕으면 결국 버그 수정과 방향 수정에 더 많은 시간을 쓰게 됩니다.
이 영상이 소개하는 obra/superpowers 의 핵심은 바로 그 지점을 바꾸는 데 있습니다. “바로 구현” 대신 질문, 설계, 계획, 테스트, 리뷰를 먼저 강제하는 흐름을 스킬 프레임워크로 만든 것 이라는 점이 핵심입니다. 근거 영상
영상은 이 프레임워크를 단순 프롬프트 모음이 아니라, Claude Code가 더 공학적인 방식으로 일하게 만드는 운영 체계로 설명합니다. 특히 왜 이런 구조가 나왔는지, 실제로 어떤 단계로 실행되는지, 그리고 언제 효과가 큰지를 데모와 함께 보여 준다는 점이 인상적입니다. 근거 영상
더보기
temp/agent.md 초안을 블로그 글 형식으로 다시 풀어 쓰면, 핵심 질문은 단순합니다.
GSD, oh-my-claudecode, Superpowers 중 무엇이 더 강하냐가 아니라, 각 도구가 개발 파이프라인의 어느 병목을 풀도록 설계되었느냐 입니다.
셋 다 “AI 코딩을 더 잘하게 해 주는 프레임워크"처럼 보이지만 실제로는 결이 다릅니다.
GSD는 스펙과 단계 관리, oh-my-claudecode는 멀티 에이전트 오케스트레이션, Superpowers는 스킬 기반 워크플로우와 품질 규율에 더 가깝습니다.
여기에 PM-Skills를 붙이면 기획-실행 연결성이 달라집니다.
더보기
ProductTalk의 글은 Claude Code를 이루는 building block을 6개로 나눠 설명합니다.
Markdown files, slash commands, agents, skills, hooks, plugins를 각각 언제 써야 하는지 사용자 관점에서 매우 잘 정리한 글입니다.
특히 “무엇을 어떤 상황에서 꺼내 써야 하는가"라는 실전 감각을 잡는 데 도움이 됩니다.
다만 한 가지는 반드시 최신 기준으로 보정해서 읽어야 합니다.
ProductTalk 글은 slash commands를 독립 기능처럼 설명하지만, 현재 Anthropic 공식 문서는 “Custom commands have been merged into skills” 라고 명시합니다.
즉 지금은 “슬래시 커맨드 vs 스킬"을 완전히 분리해서 보기보다, 사용자가 / 로 호출하는 표면과 Skill 기반 실행 모델이 점점 하나로 합쳐지는 중 이라고 이해하는 편이 더 정확합니다.
더보기
핵심 요약 스킬 자동 발동은 ‘좋은 skill 설명 + 좋은 시작 프롬프트 + 적절한 프로젝트 메모리 + 필요한 곳만 수동 호출’ 조합일 때 가장 잘 됩니다.
Claude Code는 skill의 description 필드를 보고 언제 쓸지 판단합니다. 관련 있을 때 자동으로 로드하거나 /skill-name으로 직접 호출할 수 있습니다.
flowchart TD A[사용자 요청] --> B{description 매칭} B -->|키워드 일치| C[스킬 자동 발동] B -->|애매함| D[수동 호출 필요] C --> E[작업 수행] D --> F["/skill-name 직접 호출"] F --> E style A fill:#c5dcef style C fill:#c0ecd3 style D fill:#ffc8c4 style E fill:#fde8c0
더보기
Claude Code를 조금만 깊게 써 보면 금방 부딪히는 문제가 있습니다. 규칙은 CLAUDE.md에 몰아넣고, 자동화는 훅에 넣고, 반복 작업은 스킬로 빼야 한다는 말은 알겠는데, 실제로 레포를 어떻게 나눠야 할지 애매합니다.
특히 프로젝트가 커질수록 “무엇을 항상 읽게 할지”, “무엇을 필요할 때만 불러올지”, “무엇을 문서로 남길지"가 섞이기 시작합니다.
이번 글은 temp/claude-structor.md의 간단한 구조 예시를 출발점으로, 실제로 운영 가능한 Claude Code 프로젝트 디렉터리 구조로 확장한 버전입니다. 단순히 폴더 이름만 나열하지 않고, 각 폴더가 왜 필요한지, 어떤 파일을 넣어야 하는지, 그리고 바로 가져다 쓸 수 있는 샘플 예제까지 같이 정리합니다.
더보기