저는 최근 에이전트(Agent)와 바이브 코딩(Vibe Coding)에 대해 많은 이야기를 하고 있습니다.
하지만 점점 더 많은 친구들에게 추천하면서, 자주 간과되는 문제를 깨달았습니다.
대부분의 사람들에게 진짜 병목은 표준 워크플로우가 없다는 점입니다.
특히 원하는 소프트웨어나 프로그램을 만들 때, 표준 프로세스가 없다는 것은 사실 매우 무서운 일입니다.
그래서 바이브 코딩을 하면서 경험을 개선하기 위해 사용해 온 매우 유용한 플러그인을 공유하고자 합니다. 제가 추천하는 모든 사람에게 사실상 필수 설치 항목이며, Claude Code, Codex, OpenCode, Cursor 등과 호환됩니다.
이미 GitHub에서 110,000개의 별을 받았습니다.
이름은 Superpowers입니다.
GitHub 링크는 여기 있습니다:
https://github.com/obra/superpowers
또한 공식적으로 인증된 Claude 플러그인으로, Anthropic의 공식 플러그인 마켓에 등록되어 있으며 230,000회 설치로 2위를 기록하고 있습니다.
1위는 디자인을 더 세련되게 만드는 유명한 Skill인 Frontend Design입니다.
Superpowers는 전통적인 도구가 아닙니다. 저는 에이전트가 작업을 완료하는 방법을 안내하는 시스템으로 정의해야 한다고 생각합니다.
솔직히 말하면, 대부분의 에이전트는 작업을 받으면 자연스럽게 설계, 테스트, 검토를 건너뛰고 바로 코드 작성을 시작하는 경향이 있어 유지보수가 불가능한 코드 덩어리를 만들어냅니다.
Superpowers는 에이전트의 경로에 구조화된 워크플로우를 강제로 삽입합니다. 14개의 Skill과 결합하면 최종 결과물의 품질을 몇 단계 끌어올릴 수 있습니다.
이 Skill들이 무엇을 위한 것이고 어떻게 결합되는지 보여주는 다이어그램을 만들었습니다. 자세히 볼 필요는 없고, 원리만 이해하시면 됩니다.
보시다시피 Superpowers는 본질적으로 14개의 Skill로 구성된 워크플로우 시스템입니다. 게다가 이 시스템은 개발에만 국한되지 않습니다. 무언가를 창조하는 본질은 비슷하기 때문입니다.
모든 것은 계획(Planning) - 분해(Decomposition) - 실행(Execution) - 검토(Review) - 반성(Reflection)입니다.
따라서 마케팅 계획, PPT, 데이터 분석 등에도 사용할 수 있습니다. 원리는 동일합니다.
매우 유용합니다.
먼저 Superpowers 없이 Claude Code나 Codex를 사용하는 기본 개발 프로세스가 어떤지 보여드리는 것이 좋을 것 같습니다.
일반적인 프로세스는 매우 간단합니다. 요구사항 문서(계획)를 작성한 다음 개발합니다.
Claude Code를 예로 들어 보겠습니다. 여기서 계획은 Plan 모드입니다.
예를 들어, 팀원 중 한 명이 ADHD가 있어 글을 읽을 때 쉽게 주의가 산만해집니다. 최근에 작은 읽기 도우미를 만들자고 논의했습니다.
이 요구사항에 대해 Claude Code를 열고 대화 상자에 /plan을 입력하여 계획 모드로 들어갑니다.
요구사항을 간단히 설명합니다: ADHD 사용자를 위한 중국어 웹 리더 애플리케이션을 만들어 줘.
계획을 세우도록 합니다.
그러면 한 차례 조사를 수행하고 한 번에 대답해야 할 여러 질문을 던집니다. 이 질문들은 병렬적이며 서로 인과 관계가 없다는 것을 알 수 있습니다.
예를 들어, 사용 시나리오, 기술 스택 선호도, ADHD 친화적 기능에 대해 묻습니다. 저는 바이오닉 리딩(bionic reading)—각 단어의 첫 몇 글자를 굵게 표시하는 방법—을 선택했습니다. ADHD를 완화하는 고전적인 방법입니다.
답변했고, 바로 작업을 시작했습니다.
몇 분 후에 완료되었습니다. 검토 없이 결과물을给了我.
지금 보면 괜찮아 보이시나요?
사실 큰 문제가 있습니다...
바이오닉 리딩은 영어를 위해 설계되었기 때문입니다.
영어에는 괜찮지만, 중국어에는 전혀 적용할 수 없어 읽기가 혼란스러워집니다.
이유는 간단합니다. 영어 단어는 경계를 찾기 위한 공백이 있지만, 중국어 문자는 그렇지 않습니다. 공백이 없으면 단어 경계를 찾을 수 없고 효과가 매우 어색합니다.
스타일이 맞지 않는 것 외에도, 국내 사용자에 대한 적응도 좋지 않습니다.
중국어로 읽을 때 우리는 위챗 공식 계정과 즈후를 가장 많이 사용하지만, 이 플러그인은 제대로 읽을 수 없었습니다.
제가 원했던 리더와는 거리가 멀었습니다.
공정하게 말하면, Claude Code를 탓할 수 없습니다.
ADHD 읽기 지원은 전문적인 분야로, 표적 연구가 필요하며 중국어 시나리오와 국내 플랫폼 호환성을 고려해야 합니다.
그것이 던진 몇 가지 간단하고 고통 없는 질문으로는 분명 모든 요구사항을 포괄할 수 없었기 때문에 제가 원하는 답을 얻기 어려웠습니다.
대부분의 사용자는 머릿속에 막연한 생각만 가지고 있습니다. 특정 문제를 해결하고 싶다는 것은 알지만, 그것이 어떤 모습이어야 하는지, 달성 경로는 무엇인지, 경계는 어디인지 명확히 생각하지 못합니다.
그래서 에이전트 이전 시대에 저는 글을 썼습니다:
디지털 라이프 카직스
@Khazix0918
·
글
제가 가장 자주 사용하는 6가지 프롬프트 기술을 공유합니다.
벌써 2026년인데도, 많은 친구들이 AI와 더 잘 대화하는 방법을 모른다고 말하는 것을 봅니다. 일상적인 답변은 괜찮지만, 조금만 전문적이거나 다차원적이 되면 AI의 성능이 즉시 떨어집니다...
55
222
953
프롬프트 기술 중 하나는 소크라테스식 질문법(Socratic questioning method)입니다. 프롬프트를 사용하여 AI가 시작하기 전에 질문을 하나씩 던져 요구사항을 완전히 이해할 때까지 하는 것입니다.
【질문/요구사항】
답변하기 전에 질문을 해주세요.
요구사항: 한 번에 하나의 질문만 하세요. 제 답변에 따라 질문을 계속하고, 제 진정한 필요와 목표를 95% 확신할 때까지 계속 질문한 후에야 해결책을 제시하세요.
에이전트 시대에는 비슷하지만, 프롬프트에서 프로세스의 Skill로 업그레이드되었습니다.
Superpowers로 다시 개발해 보겠습니다.
먼저 플러그인을 설치합니다.
에이전트에게 한 문장만 말하면 됩니다:
이 플러그인을 다운로드하여 설치해 줘: https://github.com/obra/superpowers
설치 후에는 적용을 위해 다시 시작해야 합니다. 핫 리로드되지 않습니다.
ADHD 리더로 돌아가서 다시 시도해 보겠습니다.
정확히 동일한 프롬프트를 보냅니다.
Superpowers를 호출하고 워크플로우를 시작하는 것을 볼 수 있습니다.
가장 먼저 하는 일은 사용자가 어떻게 사용할 것인지 묻는 것입니다. 이는 방화벽으로 막힌 콘텐츠를 읽을 수 없는 문제를 직접적으로 해결합니다.
Plan 모드의 병렬 질문과 달리, Superpowers는 한 번에 하나의 질문만 합니다. 답변에 따라 다음 질문을 결정합니다—제가 언급한 소크라테스식 질문법입니다. 이렇게 하면 질문이 표면에 머무르지 않고 깊이 들어갈 수 있습니다.
저는 브라우저 확장 프로그램을 선택했고, 다음으로 핵심 기능에 대해 물었습니다. 이 단계에서 저는 잘 알지 못해 망설였고, 조사를 해달라고 했습니다.
실제로 조사를 수행하고 보고서를 가져왔습니다.
그런 다음 제안을 하고 핵심 기능의 우선순위 목록을 정리했습니다.
바이오닉 리딩에 대해서는 "약하지만 사용자가 좋아하는" 기능으로 직접 분류하고, ADHD 중국어 사용자의 읽기에 크게 도움이 되지 않는다는 연구를 인용했습니다.
제가 몇 가지 기능을 선택하도록 도와달라고 했습니다.
그런 다음 계속해서 질문을 던져 제가 명확히 생각하도록 강요했습니다: 어떤 대상 브라우저인지? 중국어 분절 라이브러리 선호도는? UI 언어와 스타일은?
생각할 때까지 강요합니다.
이 데모 프로젝트는 그렇게 복잡하지는 않지만, 대규모 프로젝트를 개발할 때는 심문을 받는 듯한 "식은땀" 나는 느낌을 진정으로 경험하게 될 것입니다.
모든 질문에 답변한 후, AI는 대략적으로 요구사항을 알게 됩니다.
이 시점에서 Plan 모드와 달리, 세 가지 아키텍처 솔루션을 제안하고 각각의 장점, 단점 및 적용 시나리오를 명확히 나열합니다.
하나를 선택하거나 추천을 사용합니다.
저는 B를 선택했습니다. 하이브리드 솔루션을 원하지 않았기 때문입니다.
그런 다음 다양한 세부 사항을 하나씩 확인하도록 했습니다.
전체 아키텍처, 기능 모듈의 상세 설계, 제어판, 데이터 흐름 및 저장 등.
다시 확인하는 과정에서 식은땀이 났습니다. AI 앞에서 완전 아마추어처럼 느껴졌습니다.
모든 것이 확인되자 마지막으로 매우 길고 상세한 설계 문서를 작성하여 로컬에 저장했습니다.
많은 친구들이 최종 결과물이 원하는 것이 아니라고 느낍니다. 보통 AI가 나빠서가 아니라 요구사항이 명확하지 않았기 때문입니다.
2시간 계획, 10분 실행. 점점 실행이 그렇게 중요하지 않다고 느낍니다. 초기 계획을 잘 생각하는 것이 가장 중요합니다.
AIFUT 티켓 미니 프로그램을 만들 때 우리는 지나치게 자신했고 표준 AI 지원 프로세스를 따르지 않았습니다. 많은 사용자 요구가 출시 전에 고려되지 않았고 경계 위험이 명확하지 않았습니다. 그것은 초기 계획의 문제였습니다.
따라서 지금 제 느낌은 AI 개발이 충분히 빠르며, 시간을 쏟아야 할 곳은 시작하기 전이라는 것입니다.
끊임없이 심문을 받고, 팀과 함께 모든 경계 사례를 분석하고, 경험 많은 사람의 감독 아래 있어야 사용자에게 진정으로 전달할 수 있는 무언가를 만들 수 있습니다.
Superpowers로 돌아가서, 계획의 첫 번째 단계가 모두 설정되었습니다. 위의 모든 것은 Superpowers 프로세스의 첫 번째 Skill에 불과합니다.
바로 브레인스토밍(Brainstorming)입니다.
네, 첫 번째입니다.
설계 문서가 확인된 후, 코드 작성을 시작할 것이라고 생각하시나요?
하지만 그 다음, 두 번째 Skill이 작동합니다: using-git-worktrees Skill을 사용하여 격리된 작업 공간을 생성합니다.
메인 브랜치에서 새 브랜치를 가져옵니다. 이후 모든 개발은 이 새 브랜치에서 이루어집니다. 메인 브랜치 코드는 영향을 받지 않으며, 새 브랜치에서 아무리 망쳐도 원래 코드에 영향을 미치지 않습니다. 완료되고 괜찮아 보이면 다시 병합합니다.
이것이 격리입니다. 많은 사람들이 버전 격리 없이 이전 프로젝트를 직접 수정하여 모든 것을 망가뜨립니다. 그것은 매우 나쁜 습관입니다.
다음으로, 세 번째 Skill인 writing-plans이 나타납니다.
참고, 여전히 코드는 작성되지 않았습니다.
그 설계 문서를 단계별 개발 작업 목록으로 분해하여, 특히 2-5분 안에 완료할 수 있는 작업으로 만듭니다.
흥미로운 점은 목표가 그들의 말로는 "취향도, 판단력도, 프로젝트 맥락도 없고 테스트를 싫어하는 열정적인 주니어 엔지니어가 따라할 수 있도록 하는 것"이라고 합니다.
그 말을 보고 웃었습니다.
따라서 Superpowers를 사용하면 반드시 Claude Opus 4.6만 사용해야 하는 것은 아닙니다. 사실, 모델이 평범할수록 더 많은 혜택을 봅니다. 이것이 이 Skill의 역할입니다.
분해에는 또 다른 이점이 있습니다: 모든 작은 작업을 검증할 수 있다는 것입니다. 문제가 있으면 전체 프로젝트가 완료되어 폭발할 때까지 기다리지 않고 즉시 발견합니다.
이는 실행 단계에서 더욱 분명해집니다.
이 단계 후에 마침내 코드 실행 단계에 도달합니다.
subagent-driven-development Skill을 호출합니다.
여러 하위 에이전트를 열어 위에서 언급한 모든 작업을 수행합니다.
각 작업이 개발된 후에는 단순히 결과물을 제공하지 않습니다. 두 번의 검토를 거칩니다.
첫 번째 검토에서는 독립적인 검토 에이전트를 보내 작업이 요구사항을 따랐는지, 해야 할 일이 제대로 되었는지, 불필요한 것이 추가되었는지, 또는 터무니없는 과잉 설계가 있는지 확인합니다.
두 번째 검토에서는 다른 검토 에이전트를 보내 코드 품질을 확인하며, 코드가 표준화되고 유지보수 가능한지에 중점을 둡니다.
두 검토 중 하나라도 통과하지 못하면 수정을 위해 다시 보내고 통과할 때까지 재검토합니다.
이 10개의 작은 작업이 개발된 후에도 검토는 끝나지 않습니다. 다음 단계에서 requesting-code-review Skill은 최종 검토 에이전트를 보내 처음부터 끝까지 모든 코드를 살펴봅니다.
이전 검토는 부분에 초점을 맞춘 반면, 이번 검토는 전체에 초점을 맞춰 모듈이 통합될 수 있는지, 놓친 것이 없는지, 전체 로직이 일관적인지 확인합니다.
마지막으로 모든 테스트가 통과되었는지 확인하는 검증을 실행하고, 코드를 메인 브랜치에 병합한 후 작업 공간을 정리합니다.
드디어 완료되었습니다.
리더의 효과를 살펴보겠습니다.
두 가지 매우 실용적인 읽기 모드가 있습니다.
하나는 품사 색상 지정(part-of-speech coloring)으로, 명사, 동사, 형용사를 다른 색상으로 표시하여 문장 구조를 훨씬 명확하게 만듭니다.
또 다른 모드는 단락 포커스(paragraph focus)로, 읽고 있는 단락을 강조 표시하고 다른 단락을 흐리게 표시합니다. 긴 단락에 적합하며 주변 텍스트의 방해를 크게 줄여 집중력을 유지하는 데 도움이 됩니다.
ADHD 사용자에게 가장 큰 적은 주변 텍스트에 의해 주의가 분산되는 것입니다.
이 리더는 초점을 더 명확하게 만들어 내용을 더 쉽게 볼 수 있게 하고 방해를 줄여 전체를 읽는 것이 덜 피로하게 만듭니다.
그리고 이번에는 플러그인 솔루션이기 때문에 위쉿 공식 계정과 즈후 같은 페이지도 정상적으로 읽을 수 있습니다.
처음 시도에 완벽하게 작동하여 많은 수고를 덜었습니다...
이것이 AI 시대에 올바른 워크플로우가 어떤 모습이어야 하는지 완전히 보여줍니다.
2시간 계획, 10분 실행, 1시간 검토.
그게 전부입니다.
제가 언급한 Skill 외에도 언급하지 않은 다른 Skill이 있습니다. 직접 시도해 보세요.
이것은 제가 모든 사람에게 추천하는 필수 설치 플러그인입니다.
제 생각에는 skill-creator와 같은 수준입니다.
저를 믿으세요. 작업 품질을 크게 향상시켜 줄 것입니다.
그리고 효율성도요.
