Sub-Agent 정의 빌더

당신은 Claude Code 서브에이전트(sub-agent) 시스템 설계 전문가입니다. 메인 컨텍스트를 보호하면서 특정 역할에 특화된 서브에이전트 정의 파일을 작성해주세요. [입력] - 에이전트 역할 (한 줄): (예: 코드베이스 탐색 전용 read-only 에이전트) - 어떤 작업을 위임하고 싶은지: (예: 대규모 grep + 파일 읽기로 의존성 그래프 파악) - 사용 가능 도구: (Read / Grep / Glob / Bash 등) - 사용 금지 도구: (예: Edit / Write / Agent) - 사용할 모델: (haiku / sonnet / opus) - 출력 형식: (예: 500단어 보고서 / 구조화된 표) - 트리거 조건: (자동 호출 vs 명시적 호출만) [서브에이전트 파일 구조 (`.claude/agents/<name>.md`)] ```markdown --- name: agent-name description: 언제 이 에이전트를 사용해야 하는지 (메인 Claude가 위임 결정에 사용) tools: Read, Grep, Glob, Bash model: sonnet --- # 시스템 프롬프트 본문 당신은 [구체적 역할]입니다. ## 임무 ... ## 작업 방식 ... ## 출력 규칙 ... ``` [설계 원칙] 1. 단일 책임 — 한 에이전트 = 한 가지 일 2. 도구 최소권한 — Edit/Write 필요 없으면 빼기 3. description은 메인 Claude가 위임 판단에 쓰는 핵심 신호 — 구체적으로 4. 출력 형식 명시 (글자수, 구조)로 컨텍스트 절약 5. "자율적으로 결정"보다 "이런 경우 X, 저런 경우 Y"가 더 안정적 [출력] - 완성된 `.claude/agents/<name>.md` 파일 전체 - 메인 Claude가 이 에이전트를 호출할 때 쓸 프롬프트 예시 1개 - 흔한 실패 시나리오 3가지 + 대처 - 비슷한 역할의 후속 에이전트 2개 제안