Claude Code에서 Plugin을 발표했는데, Agent + Workflow(Custome Command)에 Skill (RAG의 Knowledge를 추가하는 것으로 이해하고 있다.)을 지원하는 것이다. 여기서는 동일한 PRD를 기지고 유사한 기능을 수행해보았다. workflow는 [1]의 "/feature-workflow"를 사용하였고, 이를 plugin으로 구현한 [2]의 "/product-design-toolkit:feature-workflow"를 사용하였다.


테스트 케이스

프로젝트: Task Management Dashboard
규모: 40시간 (2주)
복잡도: 중간 (표준 CRUD 애플리케이션)
팀 크기: 1명


핵심 결과

토큰 사용량 비교 (40시간 프로젝트)

단계 Plugin Manual 차이
Planning 50K 20K +150%
Implementation 900K 120K +650%
총합 960K 140K +586%

핵심 발견

  1. Plugin은 Manual 대비 6.9배 토큰 사용
  2. 토큰 낭비의 62%는 중복 컨텍스트 로딩
    • Plugin: PRD 60회 로드 (900K tokens)
    • Manual: PRD 1회 로드 (15K tokens)
  3. Break-even point: 150-200시간 프로젝트

프로젝트 규모별 권장

규모 권장 방식 이유
< 100시간 Manual Plugin 6배 비효율
100-200시간 Hybrid 60% 토큰 절감
200시간+ Plugin 일관성/품질 필요

Plugin은 어디에 써야 할까? : Plugin이 강점을 보이는 시나리오

1. 엔터프라이즈 프로젝트 (1000시간+)

팀: 12명+
규모: 50+ 마이크로서비스
복잡도: 매우 높음

Manual: 3,500K tokens (컨텍스트 관리 불가)
Plugin: 2,700K tokens (23% 절감) ✅

가치:
- 팀 간 일관된 패턴 강제
- 자동화된 품질 게이트
- 컨텍스트 서비스별 분산

2. 반복 작업 자동화 (API 100개 생성)

Manual: 302K tokens
Plugin: 65K tokens (78% 절감) ✅

이유:
- 템플릿 기반 자동 생성
- 초기 설정 후 재사용
- 일관된 코드 품질

3. 레거시 마이그레이션 (100,000 LoC)

Manual: 불가능 (컨텍스트 한계 초과)
Plugin: 가능 ✅

가치:
- Code Explorer: 구조 분석
- Impact Analyzer: 변경 영향도 자동 평가
- Migration Planner: 단계별 계획
- 컨텍스트 분산으로 대규모 처리

Break-even Point

프로젝트 규모 권장 방식 이유
< 100시간 Manual Plugin 6배 비효율
100-200시간 Hybrid 60% 토큰 절감
200시간+ Plugin 일관성/품질 우선

Hybrid 구조:

Planning (Plugin): 50K
Implementation (Manual): 80K  
Critical Review (Plugin): 30K
Final QA (Plugin): 20K
──────────────────────────
총 180K tokens (예산 90% 사용)

핵심 결론

  1. Anthropic 주장에 따르면...
    • 전제: 대규모/복잡한 프로젝트
    • 우리 실험: 중소규모 프로젝트
    • → 결론이 다를 수밖에 없음
  2. 규모가 모든 것을 결정
    • 작은 프로젝트: Manual 압도적 효율
    • 큰 프로젝트: Plugin 필수 도구
  3. 대부분의 실무는 Hybrid가 최적
    • Planning 구조화 (Plugin)
    • Implementation 속도 (Manual)
    • QA 품질 보증 (Plugin)

참고 문서

[1] claude-coade-agents-workflow: https://github.com/omersaraf/claude-code-agents-workflow

[2] claude-dev-agent-toolkit: https://github.com/blcktgr73/claude-dev-agent-toolkit

+ Recent posts