executing-plans

개요

executing-plans 스킬이 하는 일

executing-plans 스킬은 이미 작성된 구현 계획이 있고, 이를 에이전트가 체계적으로 수행해 주길 원할 때를 위해 설계되었습니다. 이 스킬은 다음에 초점을 맞춥니다.

• 프로젝트에 있는 구체적인 단계별(plan) 계획을 로드하기
• 실제 작업을 시작하기 전에 계획을 비판적으로 검토하기
• 각 작업을 하나씩 처리하며 상태 변화를 명확히 기록하기
• 계획에 명시된 검증 및 테스트를 실행하기
• 개발이 완료되면 마무리 워크플로로 넘기기

세션 시작 시, 에이전트는 다음과 같이 알리는 것이 권장됩니다.

"I'm using the executing-plans skill to implement this plan."

이를 통해 에이전트가 자유로운 브레인스토밍이나 계획 수립 모드가 아니라, 구조화된 실행 모드에 있음을 분명히 합니다.

이 스킬이 적합한 사용자

이 스킬은 다음과 같은 경우에 특히 잘 맞습니다.

• 설계를 미리 끝내고, 상세한 실행 계획은 에이전트가 그대로 수행하길 원하는 개발자
• 각 기능이나 브랜치별로 구현 계획을 작성하는 GitHub 기반 팀
• Claude Code, Codex 같은 환경에서 예측 가능하고 반복 가능한 실행 워크플로를 원하는 에이전트 운영자
• 명시적인 체크포인트와 검증 단계를 포함한 계획을 일관되게 따르게 하고 싶은 프로젝트 메인테이너

특히 계획이 이미 작은 단위의 단계로 잘게 나누어져 있고, 명확한 검증 또는 테스트 요구사항이 포함되어 있을 때 유용합니다.

executing-plans가 해결하는 문제

executing-plans 스킬은 다음과 같은 문제를 해결하는 데 도움이 됩니다.

• 사전에 승인된 계획에 작업을 anchoring함으로써 즉흥적이고 방향이 흐트러지는 구현을 방지
• 코드 변경 전에 계획을 비판적으로 검토하도록 요구해 문제를 초기에 발견
• 각 작업을 in_progress, completed로 표시하며 진행 상황을 작업 단위로 추적
• 계획에 명시된 검증과 테스트가 실제로 실행되도록 보장
• 최종 테스트 검증과 의사결정을 위한 finishing 스킬로 깔끔하게 업무를 인계

계획 실행을 표준화함으로써 커뮤니케이션 오류를 줄이고, 사람과 에이전트가 개발 업무에서 보다 예측 가능하게 협업할 수 있게 해 줍니다.

언제 이 스킬을 쓰면 좋고, 언제는 아닌가

executing-plans를 사용하면 좋은 경우:

• 이미 작성된 구현 계획이 있는 경우
• 계획이 작업 또는 단계별로 순서 있게 나누어져 있는 경우
• 에이전트가 해결책 설계보다는 실행 자체에 집중하길 원하는 경우
• 애매하거나 막히는 부분이 있으면 에이전트가 도움을 요청하며 체크포인트를 두길 원하는 경우

다른 스킬이나 워크플로를 고려해야 할 경우:

• 처음부터 계획을 만드는 것부터 도움이 필요한 경우 (이 스킬은 계획이 이미 존재한다고 가정합니다)
• 계획이 지나치게 모호하거나 핵심 정보가 부족한 경우
• 플랫폼에 풍부한 subagent 지원(예: Claude Code, Codex)이 있고, 더 고도화된 오케스트레이션이 필요한 경우 — 이때는 레포지토리에서 superpowers:subagent-driven-development 사용을 권장합니다.
• 아직 특정 구현 전략에 확정적으로 commit할 준비가 되어 있지 않고, 여러 옵션을 더 탐색하고 싶은 경우

또한 레포지토리에서는 모든 작업이 완료되면 필수 서브 스킬인 superpowers:finishing-a-development-branch로 전환해 작업을 마무리할 것을 명시하고 있습니다.

사용 방법

설치 및 설정

1. executing-plans 스킬 설치

obra/superpowers 레포지토리에서 스킬을 설치합니다:

npx skills add https://github.com/obra/superpowers --skill executing-plans

이 명령을 실행하면 에이전트 환경에서 executing-plans 워크플로를 사용할 수 있게 됩니다.

2. 구현 계획 준비

스킬을 호출하기 전에, 프로젝트 안에 작성된 구현 계획이 준비되어 있어야 합니다. 이 계획은 이상적으로 다음과 같아야 합니다.

• 에이전트가 읽을 수 있는 파일(예: 레포 안의 파일)로 저장되어 있을 것
• 개별 작업 또는 작은 단계로 쪼개져 있을 것
• 각 작업마다 필요한 검증 또는 테스트 지침이 포함되어 있을 것

계획의 품질과 명확성이 높을수록 executing-plans 워크플로도 더 안정적으로 동작합니다.

핵심 워크플로: 계획에서 실행까지

Step 1: 계획 불러오기 및 검토

executing-plans를 사용하는 세션을 시작하면, 에이전트는 다음을 수행해야 합니다.

1. 프로젝트에서 계획 파일을 읽고
2. 계획을 비판적으로 검토하며 다음을 확인합니다.
   • 누락된 정보나 애매한 지시사항
   • 단계 간 충돌이나 모순
   • 비현실적인 가정이나 성립하지 않을 수 있는 전제
3. 우려 사항을 발견하면, 어떤 실행도 시작하기 전에 이를 사용자에게 알리고 논의합니다.
4. 문제가 없다면, 에이전트는 내부적인 할 일 구조(예: TodoWrite)를 만들고 실행을 준비합니다.

이 검토 단계가 매우 중요합니다. 계획에 결함이 있는 상태로 눈 감고 따르는 일을 막고, 초기 단계에서 명확한 정렬을 유도합니다.

Step 2: 상태 추적과 함께 작업 실행

계획에 포함된 각 작업에 대해, executing-plans 스킬은 다음과 같은 패턴을 기대합니다.

1. 작업을 in_progress 상태로 표시하여 현재 진행 중인 작업을 추적 가능하게 만들기
2. 계획에 적힌 대로 각 단계를 그대로 따라가기
   • 계획은 작은 단위의 구체적 단계로 구성되어 있다고 가정합니다.
   • 계획이 명백히 불충분하지 않은 이상, 에이전트는 임의로 즉흥적인 변경을 자제해야 합니다.
3. 계획에 명시된 대로 검증을 수행하기
   • 여기에 테스트 실행, linter, 수동 점검 등이 포함될 수 있습니다.
4. 해당 작업의 모든 작업과 검증이 끝나면 작업을 completed로 표시하기

이 구조 덕분에 사람은 진행 상황을 쉽게 모니터링할 수 있고, 에이전트는 검증 단계를 건너뛰지 않게 됩니다.

Step 3: finishing 스킬로 개발 마무리

계획의 모든 작업이 실행 및 검증된 후에는:

• 에이전트는 다음과 같이 알립니다.

  "I'm using the finishing-a-development-branch skill to complete this work."

• 이후 필수 서브 스킬인 superpowers:finishing-a-development-branch를 사용합니다.

• finishing 스킬의 절차를 따라:

  • 필요한 경우 테스트를 다시 실행하거나 검증
  • 브랜치 상태나 다음 단계 등 최종 결과/옵션을 제시
  • 선택된 마무리 작업을 실행합니다.

따라서 executing-plans는 개발 파이프라인의 중간 단계로 보는 것이 좋습니다. 작성된 계획을 실제 코드 변경으로 옮기는 역할을 하고, 이후에는 전용 finishing 워크플로에 넘겨 최종 마무리를 진행합니다.

블로커와 불확실성 처리

언제 실행을 멈추고 도움을 요청해야 할까

스킬 정의에 따르면, 에이전트는 다음과 같은 상황에서 즉시 실행을 중단하고 도움을 요청해야 합니다.

• 다음과 같은 블로커에 부딪힌 경우:
  • 누락된 의존성이나 도구
  • 예상치 못한 방식으로 실패하는 테스트
  • 현재 이용 가능한 컨텍스트로는 수행할 수 없는 지시사항
• 계획에 작업을 시작하거나 이어갈 수 없을 정도의 치명적인 공백이 있는 경우
• 계획의 일부를 충분히 이해하지 못해 자신 있게 진행할 수 없는 경우

이럴 때 세션은 실행 모드에서 설명/명확화 모드로 전환되어야 하며, 에이전트는 진행을 막는 원인과 필요한 도움(정보나 결정 등)을 명확히 설명해야 합니다.

executing-plans 사용 시 좋은 실천 방법

executing-plans 스킬을 최대한 효과적으로 사용하려면 다음을 권장합니다.

• 각 작업이 하나의 명확한 결과를 갖도록 구체적이고 순서가 있는 계획을 작성하기
• 주요 변경 사항마다 검증 지침을 포함하기
• 초기 검토 단계에서 발견한 우려 사항을 에이전트가 조용히 추측하지 말고 요약해서 공유하도록 유도하기
• 실행 이후에는 항상 finishing-a-development-branch 스킬을 사용해 전체 워크플로를 예측 가능하게 유지하기

FAQ

executing-plans 스킬을 한마디로 설명하면?

executing-plans 스킬은 에이전트가 미리 작성된 구현 계획을 불러오고(load), 검토하며(review), 실행하는(execute) 데 사용하는 구조화된 워크플로입니다. 계획의 작업을 단계별로 따라가면서, 지정된 검증을 수행한 뒤, 개발이 끝나면 finishing 스킬에 제어권을 넘깁니다.

executing-plans 스킬은 어떻게 설치하나요?

obra/superpowers 레포지토리에서 다음 명령으로 설치할 수 있습니다.

npx skills add https://github.com/obra/superpowers --skill executing-plans

설치 후에는 에이전트 또는 실행 환경이 구현 계획 파일을 읽을 수 있도록 설정하고, 관련 세션에서 executing-plans를 호출하도록 구성하면 됩니다.

executing-plans를 쓰려면 subagent가 꼭 필요하나요?

필요 없습니다. executing-plans 스킬은 subagent 지원이 없어도 동작하도록 설계되었습니다. 다만 레포지토리에서는 Superpowers가 subagent와 함께 사용할 때 더 잘 동작한다고 언급하며, 플랫폼이 subagent를 지원(예: Claude Code, Codex)한다면, executing-plans 대신 더 풍부한 오케스트레이션을 제공하는 superpowers:subagent-driven-development 사용을 고려하라고 권장합니다.

언제 executing-plans를 subagent-driven development보다 우선해서 써야 하나요?

다음과 같은 경우 executing-plans 사용을 추천합니다.

• 환경에 subagent 지원이 제한적이거나 아예 없는 경우
• 이미 존재하는 계획을 단순하고 선형적인 플로우로 실행하고 싶은 경우
• 복잡한 에이전트 오케스트레이션 없이, 리뷰 → 실행 → 마무리의 간단한 흐름을 선호하는 경우

반대로 다중 에이전트 협업, 동적인 작업 분해, 더 자율적인 의사결정이 필요하다면 superpowers:subagent-driven-development가 더 적합한 대안입니다.

어떤 유형의 계획이 executing-plans에 가장 잘 맞나요?

executing-plans는 다음과 같은 특성을 가진 계획과 가장 궁합이 좋습니다.

• 에이전트가 접근할 수 있는 파일 형태로 작성되어 있을 것
• **작은 단위의 순서 있는 작업(bite-sized, ordered tasks)**으로 쪼개져 있을 것
• 기대하는 결과, 입력과 출력이 명확할 것
• 각 변경 후 수행해야 할 검증 또는 테스트 단계가 명시되어 있을 것

너무 상위 수준이거나 모호한 계획은 에이전트가 잦은 추가 질문을 하게 만들고, 실행이 자주 막힐 수 있습니다.

executing-plans는 테스트와 검증을 어떻게 처리하나요?

이 스킬은 계획에 어떤 테스트나 검증을 실행해야 하는지가 명시되어 있다고 가정합니다. 각 작업에 대해 에이전트는 다음을 수행해야 합니다.

• 계획에 적힌 코드 또는 설정 변경을 수행
• 계획에 명시된 특정 테스트, 체크, 명령을 실행
• 이러한 검증이 성공하거나, 실패한 경우에도 당신과 상의해 reconciled될 때까지 작업을 completed로 표시하지 않기

이를 통해 테스트 실행이 부가적인 단계가 아니라, 워크플로의 핵심 부분으로 자리잡게 됩니다.

모든 작업이 끝나면 어떻게 되나요?

모든 작업이 실행되고 검증이 완료되면, executing-plans는 finishing-a-development-branch 워크플로로 제어를 넘깁니다.

• 에이전트는 finishing 스킬로 전환 중임을 알리고
• 필수 서브 스킬인 superpowers:finishing-a-development-branch를 사용합니다.
• 이 스킬이 최종 점검, 옵션 제시, 선택한 마무리 작업 실행을 담당합니다.

이렇게 실행(execution)과 최종 마무리(finalization)를 분리함으로써, 각 단계를 더 명확하고 이해하기 쉽게 관리할 수 있습니다.

계획이 잘못된 것으로 드러나면 어떻게 하나요?

계획을 그대로 따르면 잘못된 동작이 발생한다는 것을 에이전트가 발견했거나, 계획대로는 성공할 수 없다는 것이 명확해지면, 에이전트는 다음과 같이 해야 합니다.

1. 추가 작업 실행을 중단
2. 계획의 어떤 점이 잘못되었는지 명확히 설명
3. 계획을 수정할지, 새 계획을 만들지, 아니면 다른 워크플로로 전환할지 당신에게 질문

executing-plans는 계획을 진실의 근거(source of truth)로 간주합니다. 이 전제가 깨지는 순간, 반드시 사람이 개입해 계획을 재검토해야 합니다.

executing-plans는 코드 변경에만 사용할 수 있나요?

이 스킬은 기본적으로 **개발 작업(코드 및 관련 작업)**에 맞춰져 있지만, "계획을 불러오고, 검토하고, 작업을 실행하고, 검증을 수행하는" 패턴은 잘 정의된 다른 프로젝트 워크플로에도 적용할 수 있습니다. 다만, 명확한 작업 단위와 객관적인 성공 기준을 정의할 수 있는 영역에서 사용할 때 가장 좋은 결과를 얻을 수 있습니다.

우리 프로젝트에서 executing-plans가 잘 작동하는지 어떻게 평가할 수 있나요?

다음과 같은 지표를 살펴보면 도움이 됩니다.

• 계획에 있는 작업이 in_progress와 completed로 일관되게 표시되고, 추적 가능성이 높을 것
• 에이전트가 계획에 명시된 검증을 꾸준히 실행하고, 그 결과를 보고할 것
• 계획이 불명확하거나 막히는 지점에 대해 초기에 알림을 받는지 여부
• finishing-a-development-branch로의 전환 과정이 자연스럽고 예측 가능하게 느껴지는지 여부

이 조건들이 충족된다면, executing-plans는 팀의 프로젝트 관리 및 워크플로 자동화 요구사항에 잘 맞는 스킬일 가능성이 높습니다.