🤖에이전트

Claude Code 다중 에이전트 기능 구현 파이프라인

역할이 분리된 AI 에이전트들이 설계부터 구현, 리뷰, 테스트까지 합의 기반으로 진행하는 자동화 파이프라인

↗ 원본 링크

#다중에이전트#Claude#자동화#파이프라인

프로젝트 개요

feature-skill은 Claude Code를 위한 다중 에이전트 합의 파이프라인입니다. 복잡한 기능 하나를 구현할 때, 여러 AI 에이전트가 각자의 역할을 수행하며 단계별로 합의하면서 진행합니다.

핵심 원칙은 명확합니다:

▸문서가 검증자와 합의되기 전까지 구현 시작 안 함

▸리뷰어가 승인하지 않으면 파이프라인 진행 안 함

▸막히면 사람에게 에스컬레이션

6가지 역할

각 AI 에이전트는 명확한 역할과 권한을 가집니다:

1️⃣ 오케스트레이터

▸전체 제어권 보유

▸요구사항 해석 및 설계/구현 문서 초안 작성

▸최종 테스트 실행

2️⃣ 디자이너

▸검증자가 거부(BLOCK)한 문서만 수정

▸초안 작성은 하지 않음

3️⃣ 검증자

▸읽기 전용 권한

▸"지금 구현하면 안 되는 최소 사유" 판정

▸설계 개선이 아닌 게이트 역할

4️⃣ 워커

▸편집 권한

▸합의된 구현 문서대로만 구현

▸문서 밖 동작은 만들지 않고 사용자에게 되돌림

5️⃣ 리뷰어

▸읽기 전용 권한

▸"지금 verify 가면 안 되는 최소 사유" 판정

▸코드 개선이 아닌 게이트 역할

6️⃣ 수정자

▸리뷰어가 요청한 수정사항만 구현

▸범위 밖 리팩터링 금지

파이프라인 흐름

Phase 0: 요구사항 정리
   ↓
Phase 1: 설계 합의 (검증자 ↔ 디자이너)
   ↓
Phase 1.5: 구현 문서 작성 및 합의
   ↓
Phase 2: 구현 (단위별 직렬 실행)
   ↓
Phase 3: 리뷰 수렴 (리뷰어 → 수정자)
   ↓
Phase 4: 최종 검증 (테스트/린트)
   ↓
완료 또는 사용자 에스컬레이션

핵심 특징

✅ 합의 기반 진행

문서가 검증자를 통과하기 전까지 다음 단계로 넘어가지 않습니다.

✅ 직렬 실행

구현 단위는 병렬로 실행되지 않습니다. Unit N이 완료되어야 N+1이 시작됩니다.

✅ 명확한 권한 분리

각 역할은 읽기 전용 또는 편집 권한을 명확히 구분하여 받습니다.

✅ 사람 중심 에스컬레이션

AI가 결정할 수 없는 부분(DOC_GAP, USER_DECISION)은 사람에게 올라갑니다.

모델 선택

역할별로 다른 모델을 지정할 수 있습니다:

▸`claude*` → Claude CLI 사용

▸`gpt-*`/`o*`/`codex*` → Codex CLI 사용

▸환경변수로 모델과 effort 수준 조정 가능

언제 유용한가?

▸복잡한 기능을 체계적으로 구현하고 싶을 때

▸AI 코드 생성에 품질 게이트를 두고 싶을 때

▸설계-구현-리뷰 프로세스를 자동화하고 싶을 때

▸여러 AI 모델의 장점을 역할별로 활용하고 싶을 때

마치며

이 프로젝트는 "AI가 모든 걸 알아서 한다"가 아니라 "AI들이 각자 역할을 명확히 하고, 사람은 필요한 지점에만 개입한다"는 철학을 보여줍니다. 다중 에이전트 시스템의 실용적인 구현 예시로 참고할 만합니다.