이 접근 방식의 핵심은 AI 에이전트를 전문화하고, 게이트 기반 워크플로우를 통해 작업을 조율하며, 도메인 지식을 명확히 문서화하는 것입니다.
1. 전문화된 에이전트 (Specialized Agents)
하나의 AI가 모든 작업을 수행하는 대신, 각기 다른 역할을 수행하는 전문 에이전트들을 생성합니다. 각 에이전트는 명확한 범위와 제한을 가지며, 이를 통해 예측 가능한 결과를 도출합니다.
-
Analyst: 요구사항 분석 및 영향 범위 식별
-
Test-Writer: 구현 전 테스트 코드 작성
-
Implementer: 테스트를 통과하기 위한 최소한의 프로덕션 코드 작성
-
Validator: 테스트 및 린팅 실행
-
Reviewer: 코딩 패턴 및 표준 준수 여부 검토
-
implementer.md예시처럼, 에이전트는 “무엇을 해야 하는지(DO)”와 “무엇을 하지 말아야 하는지(DON’T)”가 명확히 정의됩니다.
2. 게이트 기반 워크플로우 (Gate-based Workflows)
기존의 선형적인 AI 워크플로우는 한 단계의 실패로 전체 프로세스가 중단될 수 있습니다. 이를 보완하기 위해 게이트 기반의 비선형 워크플로우를 사용합니다.
-
각 게이트는 체크포인트 역할을 하며, 실패 시 다른 접근 방식으로 재시도하거나 내부적으로 루프를 돌며 문제를 해결합니다.
-
scratchpad-protocol.md파일을 통해 에이전트 간 상태를 유지하고 이전 시도에서 학습할 수 있도록 합니다. -
예시로 TDD(Test-Driven Development) 오케스트레이터는 분석, 테스트 작성, 구현, 검증, 리뷰의 단계를 게이트로 나누어 관리합니다.
3. 도메인 지식 (CLAUDE.md 파일)
AI 에이전트가 프로젝트의 코딩 컨벤션과 패턴을 따르도록 하기 위해 CLAUDE.md 파일을 활용합니다.
-
프로젝트 루트, 모델, 컨트롤러 등 각 디렉터리에 해당 도메인의 패턴, 안티패턴, 코딩 표준 등을 구체적으로 명시합니다.
-
예를 들어,
app/controllers/CLAUDE.md에는 컨트롤러의 인증 및 비즈니스 로직 처리 방식에 대한 명확한 지침이 포함됩니다. -
이 파일을 통해 에이전트는 매번 컨벤션을 설명받지 않고도 일관된 품질의 코드를 작성할 수 있습니다.
4. 아키텍처 및 구현 (Architecture and Implementation)
전체 시스템은 .claude/ 폴더 아래 agents/, commands/, protocols/ 디렉터리와 마크다운 파일로 구성됩니다. 복잡한 외부 라이브러리 없이 Claude Code가 읽을 수 있는 단순한 파일 구조를 사용합니다. 이 구조는 명확한 요구사항, 기존 패턴, 잘 정의된 CLAUDE.md 파일, 그리고 범위가 명확한 작업에 가장 효과적입니다.