Claude Code로 구현 계획을 진행하기 ― executing-plans
機械翻訳 / Machine-translated
機械翻訳 / Machine-translated
원문: Claude Code로 구현 계획을 진행하기 ― executing-plans（cccskills）
스킬 페이지: executing-plans
이 글의 결론
executing-plans를 넣으면, 작성된 구현 계획을 Claude Code 등의 에이전트가 같은 세션 안에서 태스크별로 구현할 수 있습니다.
테스트 결과와 판단을 기록하면서 끝까지 진행하는 방식입니다.
이 글에서는 처리 흐름과 설치 방법, 요청문 예시, worktree 및 관련 스킬에 관한 주의 사항을 소개합니다.
작성된 구현 계획을 넘기면, 에이전트 스스로 태스크를 하나씩 구현하면서 끝까지 진행합니다.
테스트 결과와 판단도 진행하면서 기록해 나가는 방식입니다.
요청은 다음과 같은 한 문장으로 충분합니다.
docs/plans/search.md의 구현 계획을 이 세션에서 끝까지 진행해 주세요.
가장 먼저 하는 것은 준비입니다.
에이전트는 worktree(Git의 작업 영역을 분리하는 방식)를 준비하고 계획을 읽습니다.
태스크 간 연결에 불일치가 없는지 확인하는 것도 이 단계에서 이루어집니다.
각 태스크에서는 먼저 테스트를 작성하여 실패를 확인합니다.
그 후 구현하여 성공을 확인하고, 계획대로 커밋하는 흐름입니다.
진행 기록에 '완료'로 남는 것은 테스트가 통과한 태스크뿐입니다.
해당 행에는 커밋 범위와 테스트 결과가 함께 기록됩니다.
모든 태스크를 마친 후에는 브랜치 전체 리뷰 차례입니다.
최종 메시지에는 판단 목록 「Rulings I made」와 보류한 지적 목록 「Deferred minors」가 나열됩니다.
사람이 확인해야 할 사항을 한꺼번에 받아볼 수 있는 형식입니다.
executing-plans는 별도의 구현 담당 에이전트를 두지 않고, 현재 대화 중인 에이전트 스스로 계획을 구현하기 위한 스킬입니다.
태스크별 구현 역할이나 리뷰 역할을 두지 않으며, 리뷰는 마지막에 브랜치 전체에 1회만 실시합니다.
그 대신 품질은 테스트·기록·최종 리뷰 세 가지로 유지하는 구조입니다.
각 태스크의 합격 기준은 테스트입니다.
먼저 테스트를 작성하고 실패하는 것을 직접 확인한 후 구현하여 성공을 확인합니다.
구현 전에 이미 통과되는 테스트는 테스트 자체의 문제로 처리하는 규칙입니다.
계획의 각 명령에는 예상 출력이 적혀 있으며, 에이전트는 실제 출력과 하나씩 대조합니다.
불일치가 발생했을 때의 대응은 원인에 따라 두 가지입니다.
코드가 원인이면 systematic-debugging으로 원인을 찾고, 계획이 원인이면 판단을 기록하고 계속 진행합니다.
태스크 사이에 "계속해도 될까요?"라고 확인하지 않는 것이 이 스킬의 방침입니다.
계획의 모순이나 애매한 점은 에이전트가 스스로 결정합니다.
결정한 내용과 이유, 벗어났을 경우의 영향을 한 줄씩 기록하고 계속 진행하는 흐름입니다.
작업을 멈추고 사람에게 확인하는 것은 다음 네 가지 경우에 한정됩니다.
기록이 없는 계획으로부터의 이탈은 '몰래 내린 판단'으로 간주되므로, 변경은 반드시 기록에 남깁니다.
대화가 요약되어 기억이 희미해져도, 기록 파일과 Git 이력에서 작업을 계속할 수 있습니다.
완료로 기록된 태스크는 다시 하지 않으며, 첫 번째 미완료 태스크부터 재개하는 절차입니다.
기록과 자신의 기억이 다를 때, 신뢰하는 것은 기록과 git log입니다.
기록은 Git 관리 대상 외의 폴더에 계획별로 생성됩니다.
다른 계획의 기록에는 손대지 않습니다.
subagent-driven-development와 같은 위치·같은 형식이므로, 도중에 진행 방식을 바꿔도 같은 기록에서 이어서 시작할 수 있습니다.
마지막 마무리는 브랜치 전체 리뷰입니다.
별도 에이전트를 사용할 수 있는 환경에서는 가장 능력이 높은 모델을 명시하여 리뷰 역할을 맡깁니다.
사용할 수 없는 환경에서는 에이전트가 직접 리뷰합니다.
그 경우에는 자기 리뷰였음을 기록과 최종 보고에 남깁니다.
지적은 중요도에 따라 분류하며, 심각과 중요에 해당하는 것만 1회 수정으로 모아서 처리합니다.
수정할 때마다 지적을 재현하는 테스트를 작성하고, 실패를 확인한 후 수정하는 절차입니다.
수정 후에는 모든 테스트가 통과하는지 확인합니다.
이 스킬이 적합한 경우는 다음 세 가지입니다.
태스크마다 리뷰를 삽입하고 싶은 경우에는 subagent-driven-development가 권장됩니다.
계획이 길고 후반 태스크가 요약 후의 문맥에서 동작하는 경우도 마찬가지입니다.
긴 계획이라도 기록이 있으면 복구할 수 있지만, 후반 태스크일수록 에이전트의 여유는 줄어듭니다.
계획이 세밀하게 정해져 있다면 구현은 중간 수준의 모델로도 처리할 수 있습니다.
가장 고성능 모델이 필요한 것은 최종 리뷰뿐이라는 위치입니다.
설치 방법은 명령어를 한 줄 실행하거나, 에이전트에게 문구를 보내어 부탁하는 두 가지입니다.
명령어에서는 npx skills add를 사용하며, Claude Code나 Codex 등 설치할 대상 에이전트를 선택할 수 있습니다.
npx skills add https://github.com/obra/superpowers --skill executing-plans
에이전트에게 부탁하는 경우에는 다음 문구를 그대로 보내 주세요.
내용 확인부터 배치까지 에이전트에게 맡길 수 있습니다.
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/executing-plans
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/executing-plans/、Codex なら ~/.agents/skills/executing-plans/ に配置してください。
저장 위치는 다음 표와 같습니다.
| 에이전트 | 모든 프로젝트에서 사용 | 특정 프로젝트에서만 사용 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 프로젝트의 .claude/skills/ |
| Codex | ~/.agents/skills/ | 프로젝트의 .agents/skills/ |
배포처는 GitHub의 obra/superpowers입니다.
요청문은 계획 파일을 지정하고 진행 방식을 한마디 덧붙이면 충분합니다.
이 구현 계획을 같은 세션에서 진행하고, 각 태스크의 테스트 결과를 기록해 주세요.
에이전트는 worktree 확인부터 시작하여 테스트의 실패와 성공을 확인하면서 태스크를 순서대로 구현합니다.
태스크가 하나 끝날 때마다 기록에 완료 행이 한 줄 추가됩니다.
그 행에 적히는 것은 커밋 범위와 테스트 결과입니다.
진행 기록을 확인하고 미완료 태스크부터 재개해 주세요.
먼저 확인하는 것은 기록의 첫 번째 행이 같은 계획의 것인지 여부입니다.
그 위에서 완료된 태스크를 건너뛰고 첫 번째 미완료 태스크부터 계속합니다.
다른 계획의 기록이었을 경우에는 그 기록에 손대지 않고 새 기록을 만들어 시작합니다.
모든 태스크 완료 후 브랜치 전체를 리뷰해 주세요.
반환되는 것은 중요도에 따라 분류된 리뷰 결과와 수정 내용입니다.
심각·중요 지적은 테스트와 함께 수정되고, 경미한 지적은 「Deferred minors」로 최종 보고에 나열됩니다.
가장 중요한 전제는 작성된 구체적인 계획이 있어야 한다는 것입니다.
이 스킬은 계획을 실행하는 역할이며, 계획을 고안하는 단계는 담당하지 않습니다.
계획의 각 절차에 테스트나 예상 출력이 적혀 있을수록 확실하게 진행됩니다.
같은 리포지토리의 다른 스킬을 호출하는 것을 전제로 한다는 점에도 주의가 필요합니다.
SKILL.md에는 첫 번째 태스크 전에 test-driven-development를 반드시 읽어 들여야 한다고 명시되어 있습니다.
worktree 준비에 using-git-worktrees를 사용하도록 지정되어 있는 점도 마찬가지입니다.
작업 폴더와 리뷰 자료 작성에는 subagent-driven-development의 부속 스크립트를 사용합니다.
최종 리뷰는 requesting-code-review의 절차에, 종료 처리는 finishing-a-development-branch를 따르는 형식입니다.
executing-plans뿐만 아니라 superpowers의 관련 스킬도 함께 넣어 두는 것이 전제입니다.
Git 처리에도 몇 가지 규칙이 있습니다.
사람의 명확한 동의가 없는 한, main이나 master 브랜치에서 구현을 시작하지 않습니다.
기록을 저장하는 폴더는 Git 관리 대상 외이므로, git clean -fdx로 삭제될 수 있습니다.
그 경우에는 Git 이력에서 복구하는 절차를 따릅니다.
라이선스는 MIT입니다.
부속 파일은 SKILL.md와 scripts/task-start·scripts/task-done 두 개의 스크립트입니다.
설치 전에 내용을 읽고 처리 내용을 확인해 주세요.
executing-plans 전후에 사용하는 스킬은 같은 superpowers 리포지토리에 모여 있습니다.
태스크마다 리뷰를 삽입하고 싶을 때나 계획이 길 때는 subagent-driven-development가 적합합니다.
비용을 절감하고 같은 세션에서 진행하고 싶을 때나 별도 에이전트를 호출할 수 없는 환경이라면 executing-plans가 적합합니다.
두 가지는 기록 형식이 같아 도중에 전환도 가능합니다.
기록 파일과 Git 이력을 바탕으로 완료된 태스크를 확인하고 재개합니다.
완료로 기록된 태스크는 다시 하지 않습니다.
이어서 시작하는 것은 기록이 없는 태스크부터입니다.
가능합니다.
에이전트가 리뷰 절차를 읽고 스스로 브랜치 전체를 리뷰합니다.
그 경우에는 자기 리뷰였음이 기록과 최종 보고에 기재되며, 머지 여부는 사람이 판단하는 형식입니다.
요청받지 않습니다.
확인을 위해 멈추는 것은 파괴적인 작업이나 보안에 관련된 작업, 공유 브랜치로의 push 등 네 가지 경우뿐입니다.
계획의 모순은 스스로 판단하고 그 내용을 기록에 남기고 계속 진행합니다.
executing-plans는 작성된 구현 계획을 에이전트 스스로 같은 세션에서 끝까지 구현하기 위한 스킬입니다.
테스트를 먼저 실패시킨 후 구현하고, 판단과 진행 상황을 기록하므로 대화가 끊겨도 미완료 태스크부터 재개할 수 있습니다.
마지막에는 브랜치 전체 리뷰가 이루어지며, 판단 목록과 보류한 지적 목록을 받을 수 있는 흐름입니다.
먼저 태스크가 몇 개인 작은 계획으로 기록과 리뷰의 흐름을 확인해 보세요.
자세한 소개는 cccskills 페이지에 정리되어 있습니다.
이 글은 cccskills의 읽을거리 「Claude Code로 구현 계획을 진행하기 ― executing-plans」의 전재입니다.
스킬의 세부 내용과 설치 방법은 cccskills의 executing-plans 페이지에 있습니다.