Claude Code 플러그인: TDD 및 git 추적

클로드 코드 최적화: 39개 에이전트 대신 3개 플러그인으로

클로드 코드를 3,000시간 이상 실무에서 사용해온 개발자가, 기존의 거대한 시스템(39개 에이전트, 38개 스킬, 25개 슬래시 명령어)을 단 세 개의 플러그인으로 완전히 재구성했습니다. 이 전환은 유지보수 부담을 획기적으로 줄였고, 앤트로픽의 급속한 업데이트(예: 컨텍스트 윈도우 100만 토큰 확장)에도 유연하게 대응할 수 있게 해주었습니다. 새로운 접근법은 과도한 설계를 배제하고, 검증된 도구들을 매끄럽게 통합하는 데 초점을 맞춥니다.

기존 ‘오케스트레이터 키트’는 컨텍스트 퇴화 문제를 해결하기 위해 하위 에이전트를 독립된 컨텍스트로 격리했었습니다. 각 하위 에이전트는 자체 컨텍스트에서 실행된 후 결과만 반환함으로써, 메인 세션의 깔끔함을 유지했습니다. 그러나 API 업데이트 빈도 증가, 새로운 에이전트 패턴의 등장, 그리고 컨텍스트 용량의 폭발적 성장(10만 → 90만 토큰 무료 제공)으로 인해 이 아키텍처는 더 이상 전략적으로 타당하지 않게 되었습니다.

거대한 에이전트 시스템의 문제점

39개 에이전트를 유지하려면 매번 클로드 코드 신규 릴리스 후 수작업 업데이트가 필수적이었습니다. 스킬과 슬래시 명령어는 금방 구식이 되었고, 새 기능에 최적화되지 못했습니다. 가장 큰 전환점은 바로 무료 토큰 한도가 10만에서 90만으로 확대된 것입니다: 이제 컨텍스트 격리는 전략적 의미를 잃었습니다.

핵심 단점:

• 패턴 노후화: 2025년 10월에 작성된 에이전트는 2026년 1월 도입된 새 에이전트 도구 API를 전혀 활용하지 못했습니다.
• 수동 검증 비용: 매 업데이트 후 25개 명령어 전체를 테스트하는 데 수 시간이 소요되었습니다.
• 인프라 팽창: 개발팀의 집중력이 기능 개발에서 인프라 생존 관리로 이탈했습니다.

이것이 바로 고전적인 함정입니다: 어제의 해답이 내일의 병목이 되는 순간입니다.

슈퍼파워스: TDD를 철저한 규율로 강제하기

제시 빈센트(Jesse Vincent)의 슈퍼파워스 플러그인은 엄격한 소프트웨어 개발 규율을 클로드 코드 내부에 직접 심었습니다. 즉흥적인 코딩 대신, ‘아이디어 도출 → 계획 수립 → 테스트 주도 개발(TDD) → 코드 리뷰 → 검증’이라는 고정된 순서를 강제합니다.

“JWT 인증 추가” 같은 작업 시:

• 클로드가 brainstorming을 실행: 요구사항을 명확히 하고 구현 방안을 제안합니다.
• writing-plans으로 전환: 작업을 집중력 있는 2–5분 단위 태스크로 분해합니다.
• 필수 TDD 사이클 실행: RED(실패하는 테스트), GREEN(최소 동작 코드), REFACTOR(정리 및 개선).

TDD 규칙은 절대 타협 불가입니다: 실제 프로덕션 코드는 반드시 실패하는 테스트가 해당 기능의 부재를 확인한 후에야 작성됩니다. 이를 통해 모델의 환각(hallucination)이 출시된 로직에 침투하는 것을 근본적으로 차단합니다.

완료 전 검증

verification-before-completion 스킬은 다음 네 가지 단계를 반드시 수행하도록 강제합니다:

• 결과 검증에 사용할 명령어를 명시적으로 정의합니다.
• 캐시가 아닌, 완전히 새로 실행합니다.
• 출력물 일부가 아닌, 전체 출력을 분석합니다.
• 성공 여부를 명시적으로 확인합니다.

이 절차가 없으면 클로드는 종종 가정에 기반해 “완료”라고 선언했지, 객관적 증거에 기반한 판단이 아니었습니다.

비즈: 깃 기반 작업 추적 시스템

스티브 예그(Steve Yegge)의 비즈는 작업을 버전 관리된 깃 파일로 저장해, 세션 간 지속성을 보장합니다. 핵심 명령어:

• bd create -t feature "JWT 인증" — 작업 생성 후 자동 커밋
• bd ready — 차단되지 않은 실행 가능한 작업 목록 표시
• bd prime — 세션 시작 시 프로젝트 상태 자동 복원

장점:

• 멀티 터미널 안정성: 독점 락(lock)으로 경쟁 조건(race condition)을 방지합니다.
• 의존성 그래프: 자동 의존성 분석 및 차단 논리 적용
• 깃 히스토리: 모든 의사결정에 대한 완전한 감사 추적 — 컨텍스트 압축으로 인한 정보 손실 제로

이는 산만한 사양 문서와 취약한 plan.json을 완전히 대체해, 탐색을 직관적이고 신뢰성 있게 만듭니다.

템플릿 브리지: 통합 템플릿 통합 및 카탈로그

맞춤형 템플릿 브리지 플러그인은 unified-workflow 스킬을 통해 슈퍼파워스와 비즈를 유기적으로 연결합니다. 워크플로우는 다음과 같습니다:

• 에픽(epic) 생성: bd create -t epic "JWT 인증"
• 아이디어 도출 및 계획 수립 실행
• 의존성 인식 하위 태스크로 분해:

bd create "토큰 테이블 스키마"
bd create "검증 미들웨어"
bd dep add middleware tokens

• bd ready로 준비 상태 대시보드 갱신

template-catalog는 [davila7/claude-code-templates](https://github.com/davila7/claude-code-templates)에서 제공하는 413개 이상의 사전 구축된 에이전트를 26개 카테고리로 정리해 즉시 이용 가능하게 합니다. 원하는 에이전트는 언제든 설치 가능: npx claude-code-templates@latest --agent security/security-auditor --yes. 에이전트는 실행 시마다 새로 가져오며, 사용 후 자동 정리되므로 로컬 저장 공간 부담은 전혀 없습니다.

왜 이것이 중요한가?

• 확장성: 102개 구성 요소 대신 3개 플러그인으로, 유지보수자는 자동 업데이트를 제공하고, 개발자는 수작업 패치에서 벗어납니다.
• TDD 강제: RED-GREEN-REFACTOR를 하드 요구사항으로 설정함으로써, 환각 기반 버그를 근본부터 차단합니다.
• 지속성: 깃 기반 작업 추적은 세션 연속성과 전체 프로젝트 히스토리를 완벽히 보존합니다.
• 유연성: 템플릿은 필요 시 다이나믹하게 로드되므로, 로컬 저장소 팽창이나 버전 불일치가 없습니다.
• 효율성: 집중 영역은 방법론과 결과물에 남고, 인프라 운영은 사라집니다.

접근 방식 비교

| 항목 | 오케스트레이터 키트 | 새 플러그인 스택 |

|------|---------------------|------------------|

| 구성 요소 | 39개 에이전트 + 38개 스킬 + 25개 명령어 | 3개 플러그인 + 2개 스킬 + 1개 명령어 |

| 업데이트 방식 | 수동 | 자동 |

| 컨텍스트 처리 | 하위 에이전트 격리 | 90만 토큰 윈도우 + 깃 지속성 |

| 개발 방법론 | 선택 사항 | 강제 TDD + 검증 |

새 스택은 동일한 문제를 해결하지만, 운영 부담은 훨씬 적고, 클로드 코드의 급속한 혁신과 자연스럽게 동조하며 진화합니다.

— Editorial Team