Claude Code Compound Engineering

Compound Engineering 플러그인은 특화된 에이전트, 슬래시 커맨드, 스킬, 그리고 계획 → 작업 → 리뷰 → 복합 사이클을 위한 구조화된 워크플로로 Claude Code를 확장합니다.

설치

단계	명령어
Claude Code 설치	claude.ai/code 설정 안내를 따르세요
플러그인 클론	`git clone https://github.com/anthropics/claude-code-plugins`
Claude Code에 추가	Claude Code 설정에서 플러그인 경로 추가
확인	Claude Code에서 `/help`를 실행하여 사용 가능한 명령어 확인

핵심 워크플로 사이클

단계	슬래시 커맨드	설명
계획	`/plan`	기능 설명을 구조화된 구현 계획으로 변환
작업	`/lfg`	완전 자율 엔지니어링 — 다중 에이전트 조정으로 계획 실행
리뷰	`/review-pr`	전문화된 병렬 에이전트를 사용한 종합 PR 리뷰
복합	`/compound`	해결된 문제를 문서화하여 조직 지식 구축

슬래시 커맨드

계획 및 아키텍처

명령어	설명
`/plan`	파일 수준의 세부 사항이 포함된 구조화된 구현 계획 생성
`/brainstorm`	계획 전 요구 사항 및 접근 방식 탐색
`/deepen-plan`	병렬 리서치 에이전트로 깊이와 모범 사례를 위한 계획 강화
`/plan_review`	여러 전문 에이전트가 병렬로 계획을 검토

개발 및 실행

명령어	설명
`/lfg`	완전 자율 엔지니어링 워크플로 — 계획, 구현, 테스트, 리뷰
`/resolve_parallel`	병렬 처리로 모든 TODO 주석 해결
`/resolve_pr_parallel`	병렬 처리로 모든 PR 코멘트 해결
`/resolve_todo_parallel`	병렬 처리로 모든 대기 CLI todo 해결

리뷰 및 품질

명령어	설명
`/review-pr`	전문 에이전트(코드, 보안, 성능)를 사용한 종합 PR 리뷰
`/code-review`	계획 및 표준에 대한 특정 코드 변경 검토
`/test-browser`	현재 PR 또는 브랜치에 영향받은 페이지에서 브라우저 테스트 실행
`/reproduce-bug`	로그, 콘솔, 스크린샷을 사용하여 버그 재현 및 조사

문서화 및 지식

명령어	설명
`/compound`	해결된 문제를 조직 지식으로 문서화
`/changelog`	메인에 병합된 최근 변경사항에 대한 체인지로그 작성
`/deploy-docs`	GitHub Pages를 위한 문서 검증 및 준비
`/release-docs`	현재 컴포넌트로 문서 사이트 빌드 및 업데이트

유틸리티

명령어	설명
`/generate_command`	새로운 사용자 정의 슬래시 커맨드 생성
`/triage`	CLI todo 시스템을 위한 발견 항목 분류 및 카테고리화
`/feature-video`	기능 워크스루 비디오를 녹화하여 PR 설명에 추가
`/agent-native-audit`	종합적인 에이전트 네이티브 아키텍처 검토 실행

전문 에이전트

코드 리뷰 에이전트

에이전트	목적
`code-reviewer`	버그, 로직 오류, 보안, 코드 품질 검토
`code-simplifier`	기능 유지하면서 코드를 명확하게 간소화
`silent-failure-hunter`	사일런트 실패 및 부적절한 오류 처리 식별
`comment-analyzer`	주석의 정확성 및 유지보수성 분석
`pr-test-analyzer`	테스트 커버리지 품질 및 완전성 검토
`type-design-analyzer`	타입 설계 및 불변성에 대한 전문 분석
`code-simplicity-reviewer`	YAGNI 준수 및 최소 복잡성을 위한 최종 검토

아키텍처 및 보안 에이전트

에이전트	목적
`architecture-strategist`	시스템 설계 결정 및 컴포넌트 경계 평가
`security-sentinel`	보안 감사, 취약점 평가, OWASP 준수
`performance-oracle`	성능, 알고리즘, 병목 현상, 확장성 분석
`agent-native-reviewer`	기능이 사람뿐만 아니라 에이전트도 접근 가능하도록 보장
`pattern-recognition-specialist`	디자인 패턴, 안티패턴, 코드 중복 감지

언어별 리뷰어

에이전트	목적
`kieran-rails-reviewer`	엄격한 Rails 컨벤션 및 품질 검토
`kieran-python-reviewer`	엄격한 Python 컨벤션 및 품질 검토
`kieran-typescript-reviewer`	엄격한 TypeScript 컨벤션 및 품질 검토
`dhh-rails-reviewer`	DHH 관점의 Rails 검토 — 안티패턴 감지
`julik-frontend-races-reviewer`	JS/Stimulus에서의 프론트엔드 레이스 컨디션 감지

데이터 및 배포 에이전트

에이전트	목적
`data-integrity-guardian`	데이터베이스 마이그레이션, 데이터 제약, 참조 무결성
`data-migration-expert`	ID 매핑, 롤백 안전성, 데이터 변환 검증
`deployment-verification-agent`	배포 전후 체크리스트, SQL 검증, 롤백 계획

리서치 에이전트

에이전트	목적
`framework-docs-researcher`	종합적인 프레임워크 문서 및 모범 사례 가져오기
`learnings-researcher`	`docs/solutions/`에서 조직 지식 검색
`best-practices-researcher`	문서 및 OSS에서 외부 모범 사례 수집
`git-history-analyzer`	git 히스토리 및 코드 진화에 대한 고고학적 분석
`repo-research-analyst`	종합적인 저장소 구조 및 패턴 분석

디자인 에이전트

에이전트	목적
`figma-design-sync`	Figma 디자인과 구현 동기화
`design-implementation-reviewer`	UI가 Figma 사양과 일치하는지 검증
`design-iterator`	N회 스크린샷-분석-수정 사이클을 통한 반복적 디자인 개선

스킬

개발 스킬

스킬	트리거
`frontend-design`	높은 디자인 품질로 웹 컴포넌트 구축
`agent-native-architecture`	에이전트가 일급 시민인 앱 설계
`dspy-ruby`	타입 안전하고 구성 가능한 LLM 앱을 위한 Ruby 프레임워크
`andrew-kane-gem-writer`	Andrew Kane 패턴을 따르는 Ruby gem 작성
`dhh-rails-style`	DHH의 37signals 스타일로 Ruby/Rails 코드 작성

워크플로 스킬

스킬	트리거
`brainstorming`	구현 전 의도와 접근 방식 탐색
`git-worktree`	격리된 병렬 개발을 위한 Git worktree 관리
`file-todos`	파일 기반 todo 추적 시스템 관리
`every-style-editor`	Every 스타일 가이드에 맞게 텍스트 검토 및 편집
`compound-docs`	해결된 문제를 분류된 문서로 캡처

도구 통합 스킬

스킬	트리거
`agent-browser`	Vercel의 agent-browser CLI를 사용한 브라우저 자동화
`rclone`	클라우드 스토리지 제공업체 간 파일 업로드 및 동기화
`gemini-imagegen`	Gemini API를 사용한 이미지 생성 및 편집
`xcode-test`	시뮬레이터에서 iOS 앱 빌드 및 테스트
`skill-creator`	효과적인 새 스킬 생성을 위한 가이드

훅

훅	이벤트	목적
`SessionStart`	세션 초기화	컨텍스트 설정, 메모리 로드
`PreToolUse`	도구 실행 전	검증, 위험한 명령어 차단
`PostToolUse`	도구 실행 후	결과 처리, 후속 작업 트리거
`Stop`	에이전트 완료	최종 점검, 정리
`UserPromptSubmit`	사용자 메시지 전송	사용자 입력 전처리

다중 에이전트 리뷰 워크플로

/review-pr 명령어는 여러 전문 에이전트를 병렬로 실행합니다:

┌─────────────────────────────────────────────────┐
│                  /review-pr                      │
├─────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐      │
│  │ Code     │  │ Security │  │ Perf     │      │
│  │ Reviewer │  │ Sentinel │  │ Oracle   │      │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘      │
│       │              │              │            │
│  ┌────┴─────┐  ┌────┴─────┐  ┌────┴─────┐      │
│  │ Silent   │  │ Type     │  │ Pattern  │      │
│  │ Failure  │  │ Design   │  │ Recog.   │      │
│  └────┬─────┘  └────┬─────┘  └────┴─────┘      │
│       └──────────┬───┘──────────────┘            │
│            Consolidated Report                   │
└─────────────────────────────────────────────────┘

일반적인 사용 사례

기능 개발

# 1. 접근 방식 브레인스토밍
/brainstorm

# 2. 구조화된 계획 생성
/plan

# 3. 리서치 에이전트로 심화
/deepen-plan

# 4. 자율적으로 실행
/lfg

# 5. PR 리뷰
/review-pr

# 6. 배운 것을 문서화
/compound

PR 코멘트 해결

# 모든 PR 코멘트를 병렬로 해결
/resolve_pr_parallel

# 또는 코드베이스 전체의 TODO 해결
/resolve_parallel

사용자 정의 명령어 생성

# 새로운 슬래시 커맨드 생성
/generate_command

# 새 스킬 생성
Use the skill-creator skill for guidance

구성

플러그인 구조

compound-engineering/
├── plugin.json          # 플러그인 매니페스트
├── commands/            # 슬래시 커맨드 정의
│   ├── lfg.md
│   ├── plan.md
│   ├── review-pr.md
│   └── ...
├── agents/              # 에이전트 정의
│   ├── code-reviewer.md
│   ├── security-sentinel.md
│   └── ...
├── skills/              # 스킬 정의
│   ├── frontend-design/
│   ├── agent-native-architecture/
│   └── ...
└── hooks/               # 이벤트 훅
    ├── session-start.md
    └── ...

에이전트 구성

에이전트는 YAML 프론트매터가 포함된 마크다운 파일로 정의됩니다:

---
name: "code-reviewer"
description: "Reviews code for bugs, logic errors, and quality"
tools:
  - Glob
  - Grep
  - Read
  - Task
model: sonnet  # or opus, haiku
---

모범 사례

구현에 착수하기 전에 /brainstorm으로 시작 — 엣지 케이스를 조기에 발견
사소하지 않은 모든 것에 /plan 사용 — “간단한” 기능도 구조화된 사고로부터 혜택
병합 전 /review-pr 실행 — 다중 에이전트 리뷰가 단일 패스 리뷰가 놓치는 문제를 포착
/compound로 문서화 — 조직 지식이 실수 반복을 방지
복잡한 기능에 /deepen-plan 사용 — 리서치 에이전트가 문서 및 모범 사례로 깊이를 추가
병렬 해결 활용 — /resolve_parallel이 순차적 수정보다 빠르게 TODO 처리
반복 패턴에 사용자 정의 스킬 생성 — 도메인 지식을 재사용을 위해 캡슐화
빠른 에이전트에 haiku 모델 사용 — 간단한 작업에서 비용 및 지연 시간 최소화

문제 해결

문제	해결 방법
에이전트를 찾을 수 없음	Claude Code 설정에서 플러그인 경로를 확인하고 재시작
명령어가 인식되지 않음	`/help`를 실행하여 사용 가능한 명령어를 나열하고 plugin.json 확인
에이전트가 빈 결과 반환	모델 가용성 확인, opus/sonnet에 API 키가 필요할 수 있음
다중 에이전트 리뷰가 느림	빠른 에이전트에 `haiku` 모델, 중요한 에이전트에 `sonnet` 사용
스킬이 트리거되지 않음	스킬 설명이 프롬프트 표현과 일치하는지 확인
훅이 작동하지 않음	훅 이벤트 유형이 일치하는지 확인 (PreToolUse vs PostToolUse)
계획이 너무 모호함	리서치 에이전트와 함께 `/deepen-plan` 사용하여 더 자세히
리뷰에서 컨텍스트 누락	`/review-pr`에 PR URL 또는 브랜치 이름을 명시적으로 제공