Claude Code에 11명의 전문 에이전트와 구조화된 다중 에이전트 검토를 제공하는 프레임워크를 만들었습니다
발행: (2026년 3월 14일 오전 04:10 GMT+9)
5 분 소요
원문: Dev.to
Source: Dev.to
문제
오늘날 대부분의 AI‑지원 코딩은 **“바이브 코딩”**이다 — 프롬프트를 주면 AI가 코드를 작성하고, 우리는 그대로 받아들인다. 리뷰가 없고, 독립적인 평가도 없으며, 추론 과정도 캡처되지 않는다.
코드는 동작할 수도 (어쩌면) 있지만, 왜 그렇게 구현됐는지는 아무도 이해하지 못한다.
내가 만든 것
Claude Code용 오픈‑소스 프레임워크 템플릿으로, 체계적인 개발 루프를 강제한다:
Plan → Build → Review → Learn → Ship
11명의 전문 에이전트
| 에이전트 | 역할 |
|---|---|
| Architecture Consultant | 구조 정렬, 컴포넌트 경계 |
| Security Specialist | 취약점, 인증 패턴, 위협 모델링 |
| QA Specialist | 테스트 커버리지, 엣지 케이스, 신뢰성 |
| Performance Analyst | 지연 시간, 확장성, 자원 효율성 |
| UX Evaluator | 인터랙션 흐름, 접근성, 플랫폼 관례 |
| Independent Perspective | 반그룹싱크, 숨겨진 가정, 고려되지 않은 대안 |
| … + 5 more | 문서, 교육, 프로젝트 분석, 라인리지 추적, 촉진 등 |
16개의 슬래시 명령
/plan– 사양 기반 기능 계획/build_module– 중간 빌드 체크포인트 리뷰와 함께 빌드/review– 다중 에이전트 전문 코드 리뷰/deliberate– 구조화된 다중 에이전트 토론/ship– 품질 게이트가 포함된 전체 릴리스 워크플로우/walkthrough– 가이드형 코드 설명/quiz– 이해도 평가- …그리고 탐색, 분석, 회고, 지식 관리 등을 위한 9가지 명령 추가.
가장 중시하는 원칙
코드를 작성하는 에이전트가 절대 유일한 리뷰어가 되지 않는다.
모든 변경 사항은 생성에 참여하지 않은 전문가들의 독립적인 평가를 받는다. 이 단일 규칙이 같은 모델이 자신의 작업을 승인하는 “AI 에코 챔버”를 방지한다.
교육 게이트
코드를 이해하기 전까지는 병합되지 않는다:
Walkthrough → Quiz → Explain‑back → Merge
AI는 단순히 코드를 만들어 주는 것이 아니라, 왜 그렇게 만들었는지 가르쳐준다.
4계층 캡처 스택
모든 결정, 트레이드‑오프, 토론이 기록된다:
- 불변 로그 – 토론당 봉인된 이벤트 파일
- SQLite 인덱스 – 쿼리 가능한 메트릭 및 관계
- 큐레이션 메모리 – 인간이 승인한 패턴과 교훈
- 옵션 벡터 – 코퍼스가 커질 때 사용
대상 사용자
- 개발자: AI‑지원 개발에 더 큰 엄격함을 원하는 사람 — AI를 줄이는 것이 아니라 똑똑한 AI 협업을 추구하는 사람.
- 코드 학습자: AI가 빌드하면서 가르쳐 주길 원하는 사람 — 모든 결정이 설명되고, 모든 트레이드‑오프가 문서화된다.
사용해 보기
- Framework Presentation – 인터랙티브 개요
- How‑To Guide – 시작하기
- GitHub Repo – 템플릿 클론
AI‑Native Agentic Development Framework — 11명의 전문 에이전트, 구조화된 다중 에이전트 리뷰, 자동화된 품질 게이트를 갖춘 Claude Code 템플릿.
Apache 2.0 라이선스. 피드백 및 기여 환영합니다.