Claude Code의 구현 계획을 서브 에이전트에 분담하여 리뷰하기
機械翻訳 / Machine-translated
cccskills
2日前・12分で読める
機械翻訳 / Machine-translated
원문 기사: Claude Code의 구현 계획을 서브 에이전트에 분담하여 리뷰하기（cccskills）
스킬 페이지: subagent-driven-development
이 글의 결론
subagent-driven-development를 도입하면, Claude Code의 구현 계획을 태스크별로 별도 에이전트에 맡길 수 있습니다.
각 태스크 확인부터 전체 리뷰까지, 작업이 끊김 없이 진행됩니다.
진척 상황은 파일에 남기 때문에 도중에 중단하더라도 이어서 재개할 수 있습니다.
이 글에서는 실제 진행 방식과 설치 방법, 요청 문구 예시, 사용 전 확인해야 할 전제 조건을 소개합니다.
구현 계획을 전달하고 한마디만 부탁하면, 에이전트가 지휘 역할을 맡아 태스크의 구현과 리뷰를 끝까지 진행합니다.
이 구현 계획을 subagent-driven-development로 끝까지 진행해주세요.
요청을 받은 에이전트는 먼저 작업용 Git 워크트리（같은 저장소를 별도 폴더에서 작업하는 방식）를 준비합니다.
이어서 계획을 한 번 읽고 태스크별 ToDoを 작성합니다.
착수 전에는 계획 내의 모순을 찾아내고, 파일이나 전달 사항을 공유하는 태스크 쌍을 표로 정리해 진척 기록에 작성합니다.
그 후 태스크 1부터 순서대로 새로운 구현 담당 서브 에이전트（작업을 분담하는 별도 에이전트）를 호출합니다.
구현 담당의 역할은 구현, 테스트, 커밋과 결과를 보고 파일에 작성하는 것까지입니다.
다음으로 별도의 리뷰 담당이 변경 사항(diff)을 읽고, 사양 적합성과 코드 품질 두 가지에 대해 판정을 반환하는 흐름입니다.
모든 태스크가 완료되면, 브랜치 전체의 변경 사항을 가장 성능이 높은 모델로 리뷰합니다.
마지막 메시지에 추가되는 것이 에이전트가 도중에 스스로 결정한 판단의 목록인 "Rulings I made"입니다.
이용자가 확인해야 할 내용은 최종 리뷰 결과와 판단 목록에 정리됩니다.
태스크 사이에 "계속하시겠습니까?"라고 확인을 요청하는 일은 없습니다.
멈추고 사람에게 묻는 경우는 다음 4가지 상황뿐입니다.
이 스킬은 "태스크별로 새로운 구현 담당", "태스크별 리뷰", "마지막 전체 리뷰"의 3가지를 조합하여 계획대로의 구현을 지원합니다.
배포처는 GitHub의 obra/superpowers입니다.
같은 저장소에는 계획 수립이나 리뷰 요청 스킬도 함께 있습니다.
각 태스크는 이전 대화의 경위를 이어받지 않는 새로운 서브 에이전트가 구현합니다.
지휘 역할은 태스크 전문을 잘라낸 지시 파일을 전달하며, 계획 파일 전체는 읽히지 않습니다.
이전 태스크의 요약을 누적해서 전달하는 일도 없으므로, 구현 담당은 자신의 태스크에만 집중할 수 있습니다.
같은 종류의 작은 수정이 여러 개 이어지는 경우에는 묶어서 하나의 서브 에이전트에 전달합니다.
반면 구현 담당을 여러 개 동시에 실행하지는 않습니다.
변경 사항 간의 충돌을 피하기 위해서입니다.
같은 저장소의 executing-plans와의 차이는 다음과 같습니다.
| 항목 | subagent-driven-development | executing-plans |
|---|---|---|
| 구현 담당 | 태스크별로 새로운 서브 에이전트 | 하나의 컨텍스트에서 모든 태스크 |
| 리뷰 시점 | 각 태스크 후 및 마지막 전체 리뷰 | 마지막 리뷰만 |
| 컨텍스트 비용 | 태스크와 리뷰마다 새로운 컨텍스트 | 하나의 컨텍스트와 최종 리뷰 1회 |
| 공통점 | 같은 세션에서 동작하며, 같은 진척 기록을 사용하고, 태스크 간에 멈추지 않음 | 동일 |
각 태스크에서는 리뷰 담당이 사양 적합성과 품질 두 가지를 확인합니다.
리뷰 담당에게 전달되는 것은 지시 파일, 구현 담당의 보고 파일, 커밋 목록과 변경 사항(diff)을 정리한 파일입니다.
어느 한쪽 판정이 빠진 보고는 받아들이지 않습니다.
구현 담당의 자체 리뷰가 있더라도 이 리뷰는 생략되지 않습니다.
중요한 지적이 나오면 수정 재작업에 들어갑니다.
재작업은 1태스크당 최대 5회입니다.
경미한 지적은 재작업에 포함하지 않고 진척 기록에 보류로 기재합니다.
보류 목록은 최종 리뷰에 전달되어 머지 전에 수정해야 할 항목이 여기서 선별됩니다.
진척 상황은 기록 파일에 남기 때문에, 중단되더라도 완료된 태스크는 건너뛰고 재개할 수 있습니다.
기록 파일의 저장 위치는 저장소 내의 .superpowers/sdd/ 하위이며, 계획별로 생성되는 방식입니다.
이 폴더는 Git 관리 대상 외입니다.
완료된 태스크에는 완료 표시 행이 붙습니다.
대화 기억은 압축（컴팩션）으로 손실될 수 있습니다.
따라서 재개 시에는 자신의 기억보다 기록 파일과 git log를 신뢰하는 절차입니다.
완료된 태스크를 통째로 재작업하는 실수를 이 방식으로 방지할 수 있습니다.
모델은 역할별로 처리 가능한 최소한의 성능을 가진 것을 선택합니다.
호출할 때마다 모델을 명시하는 규칙이 있으며, 지정 없이 고비용 모델을 계속 사용하는 일은 없습니다.
| 역할 | 선택하는 모델 |
|---|---|
| 1~2개 파일로 사양이 명확한 구현 | 빠르고 저렴한 모델 |
| 여러 파일에 걸친 통합이나 버그 조사 | 표준 모델 |
| 설계 판단 및 마지막 전체 리뷰 | 가장 성능이 높은 모델 |
마지막 리뷰에서는 브랜치 시작 시점부터 현재까지의 변경 사항(diff)을 한꺼번에 읽힙니다.
지적이 나온 경우에는 모든 지적을 하나의 수정 담당에게 묶어 전달하며, 재리뷰는 1회만 진행합니다.
그 후 작업용 폴더를 삭제하고 finishing-a-development-branch로 이관하여 머지나 Pull Request 선택으로 넘어갑니다.
설치는 커맨드 1줄로 하는 방법과, Claude에게 확인을 맡겨 설치하는 방법이 있습니다.
커맨드로 설치하는 경우 다음을 실행하세요.
npx skills add https://github.com/obra/superpowers --skill subagent-driven-development
Claude에게 부탁하는 경우 다음 문구를 그대로 보내세요.
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/subagent-driven-development
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、~/.claude/skills/subagent-driven-development/ に配置してください。
저장 위치는 모든 프로젝트에서 사용하는 경우 ~/.claude/skills/, 특정 프로젝트에서만 사용하는 경우 해당 프로젝트의 .claude/skills/입니다.
배포처의 파일 구성은 GitHub의 SKILL.md에서 확인할 수 있습니다.
스킬에 포함된 것은 구현 담당·태스크 리뷰·재리뷰용 지시 템플릿과, 작업용 폴더 및 변경 사항(diff) 파일을 생성하는 3개의 스크립트입니다.
요청 문구는 계획 파일의 위치와 무엇을 해주길 원하는지 간략하게 전달하는 것으로 충분합니다.
docs/plan.md의 구현 계획을 태스크별로 별도 에이전트에 맡겨 진행해주세요.
워크트리를 확인한 후, 계획 내 모순을 조사한 표가 진척 기록에 작성됩니다.
이어서 태스크 1부터 구현과 리뷰가 순서대로 진행되고, 마지막에 전체 리뷰 결과와 판단 목록이 반환됩니다.
이전 작업이 도중에 중단되었습니다.
진척 기록을 확인하여 미완료 태스크부터 재개해주세요.
이 경우 기록 파일에서 완료된 태스크를 확인하고, 첫 번째 미완료 태스크부터 재개합니다.
수정 재작업 중에 멈춘 태스크는 그 다음 회차부터 이어서 진행하는 절차입니다.
각 태스크에서 사양과 품질을 확인하고, 마지막에 브랜치 전체의 변경 사항을 리뷰해주세요.
태스크별 리뷰에 더하여, 브랜치 시작 시점부터의 변경 사항(diff)을 가장 성능이 높은 모델이 리뷰합니다.
보류 중이던 경미한 지적을 수정할지 여부도 이 리뷰에서 판단됩니다.
이 스킬을 사용하려면 구현 계획과 서브 에이전트를 호출할 수 있는 환경, 이 두 가지가 필요합니다.
계획이 없거나 태스크 간 의존도가 높은 경우에는 수작업으로 진행하거나, 먼저 계획을 수립하는 단계로 돌아가도록 안내됩니다.
서브 에이전트를 사용할 수 없는 환경에서는 executing-plans가 대안이 됩니다.
작업 공간은 Git의 분리된 작업 영역입니다.
main/master 브랜치에서 구현을 시작하는 경우에는 이용자의 명시적인 동의를 요청합니다.
부속 스크립트는 bash로 동작합니다.
작업용 폴더는 Git 관리 외이므로 git clean -fdx를 실행하면 삭제된다는 점에 주의하세요.
도중의 판단은 4가지 정지 조건을 제외하고 에이전트가 스스로 내립니다.
판단 목록은 반드시 읽고, 의도와 다른 내용이 있으면 수정을 지시해주세요.
또한 태스크와 리뷰마다 새로운 컨텍스트를 사용하기 때문에, 하나의 대화로 진행하는 것보다 컨텍스트 비용이 증가합니다.
최종 리뷰에서 참조하는 것은 같은 저장소의 requesting-code-review에 포함된 리뷰용 템플릿입니다.
단독으로 설치하는 경우, 이 스킬도 함께 설치해 두어야 절차대로 동작합니다.
라이선스는 MIT입니다.
설치 전에 SKILL.md와 부속 스크립트의 내용을 읽고 처리 내용을 확인하세요.
같은 obra/superpowers 스킬 중 이 스킬의 전후로 사용하는 것을 3가지 소개합니다.
executing-plans는 작성된 구현 계획을 같은 세션에서 태스크별로 실행합니다.
서브 에이전트를 사용할 수 없는 환경이나 하나의 컨텍스트로 진행하고 싶은 경우의 선택지입니다.
requesting-code-review는 별도 에이전트에 코드 리뷰를 요청하는 스킬입니다.
subagent-driven-development의 최종 리뷰는 이 스킬의 템플릿을 사용합니다.
finishing-a-development-branch는 구현 완료 후 테스트를 확인하고, 머지나 Pull Request 생성을 선택하여 진행합니다.
subagent-driven-development의 마지막에 이관되는 스킬입니다.
실행할 수 없습니다.
변경 충돌을 피하기 위해 구현 담당은 항상 하나씩 호출하는 절차입니다.
같은 종류의 작은 수정이 이어지는 경우에는 하나의 담당에게 묶어서 전달합니다.
그렇지 않습니다.
진척 상황은 계획별 기록 파일에 남으며, 완료된 태스크는 건너뛰고 재개합니다.
기록 파일이 삭제된 경우에도 git log에서 상황을 복원하는 절차로 진행됩니다.
기본적으로는 요청받지 않습니다.
멈추는 경우는 파괴적인 조작, 보안과 관련된 조작, 머지나 공개 등 워크트리 외부에 영향을 미치는 조작, 계획에 문제가 있는 경우의 4가지입니다.
그 외의 판단은 기록에 남아 마지막에 목록으로 보고됩니다.
subagent-driven-development는 구현 계획을 태스크별로 새로운 서브 에이전트에 맡기고, 각 태스크의 리뷰와 마지막 전체 리뷰를 거치면서 진행하는 스킬입니다.
진척 상황은 기록 파일에 남기 때문에, 긴 작업이라도 이어서 재개할 수 있습니다.
계획과 태스크 분리가 되어 있고, 사양에서의 이탈을 일찍 발견하고 싶은 개발에 적합합니다.
설치 전후에는 cccskills 페이지에서 배포처와 관련 스킬을 확인하세요.
이 글은 cccskills의 읽을거리 「Claude Code의 구현 계획을 서브 에이전트에 분담하여 리뷰하기」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 subagent-driven-development 페이지에 있습니다.