BUILDER_GUIDE.md

Subagent Builder 사용 가이드

subagent-builder 에이전트를 사용해 커스텀 서브에이전트를 만드는 방법입니다.

---

Quick Start

1. 새 서브에이전트 만들기

"subagent-builder를 사용해서 접근성(accessibility)을 검사하는 에이전트를 만들어줘"

Builder가 자동으로:

1. 요구사항 확인 (어떤 프레임워크? 어떤 수준?)
2. 웹에서 베스트 프랙티스 검색
3. 평가 기준 설계
4. accessibility-checker.md 파일 생성

2. 기존 에이전트 수정

"react-principles-reviewer를 Vue 3 Composition API에 맞게 수정해줘"

Builder가 자동으로:

1. 기존 react-principles-reviewer.md 읽기
2. Vue 3 베스트 프랙티스 검색
3. React 패턴을 Vue 패턴으로 변경
4. vue-principles-reviewer.md 생성

3. 팀 규칙 추가

"react-principles-reviewer에 우리 회사 네이밍 규칙을 추가해줘:
- 컴포넌트는 PascalCase
- 훅은 use로 시작
- 상수는 UPPER_SNAKE_CASE"

---

실전 예시

기존 에이전트 목록

에이전트	용도
fundamentals-readability	Toss Fundamentals - 가독성
fundamentals-predictability	Toss Fundamentals - 예측 가능성
fundamentals-cohesion	Toss Fundamentals - 응집도
fundamentals-coupling	Toss Fundamentals - 결합도
react-state-reviewer	React 상태관리 (상태 성질 기반 배치, Context, 전역 상태)
react-principles-reviewer	React 컴포넌트 패턴 (데이터 소유, 부수효과 위치, 데이터 Fetching·비동기 경계, 네이밍, 메모이제이션)
root-cause-reviewer	근본 원인 (증상을 덮는 코드, 에러 처리, 비동기 경쟁, 데드코드)
a11y-reviewer	접근성 (클릭 가능한 div, 폼, 요소 중첩, 아이콘 버튼, 레이블)

커스터마이징 예시

프레임워크 특화:

"react-principles-reviewer를 Next.js App Router에 맞게 수정해줘"
"react-state-reviewer를 Vue 3(Pinia)에 맞게 적용해줘"

도메인 특화:

"root-cause-reviewer에 금융 앱 금액 계산 규칙 추가해줘"
"HIPAA 규정을 확인하는 에이전트 만들어줘"

기능 추가:

"root-cause-reviewer에 자동 수정 기능 추가해줘"
"a11y-reviewer를 웹 리서치 포함 버전으로 업그레이드해줘"

---

자주 쓰는 명령어

# 새 에이전트 생성
"subagent-builder로 [목적]을 검사하는 에이전트 만들어줘"

# 프레임워크 특화
"[에이전트]를 [프레임워크]에 맞게 수정해줘"

# 팀 규칙 추가
"[에이전트]에 우리 팀 규칙 추가해줘: [규칙들]"

# 기능 업그레이드
"[에이전트]에 웹 리서치/자동 수정 기능 추가해줘"

# 검증
"[에이전트] 설정이 올바른지 검증해줘"

---

문제 해결

"에이전트가 원하는 걸 안 찾아요"

"[에이전트]에 [찾고 싶은 패턴]을 감지하는 기준 추가해줘"

"여러 프로젝트에 같은 에이전트를 쓰고 싶어요"

"[기본 에이전트]를 [프로젝트명]에 맞게 복사하고 수정해줘"

"에이전트 구조가 맞는지 모르겠어요"

"[에이전트] 파일이 올바른 포맷인지 검증해줘"

---

참고

상세한 서브에이전트 구조, 모델/도구 선택 가이드, 템플릿은 subagent-builder.md를 참고하세요.