서브에이전트 전략 가이드

독립된 두뇌를
설계하는 기술

서브에이전트는 독립된 시스템 프롬프트와 독립된 컨텍스트를 가진 별개의 전문가야. 어떻게 설계하고, 교육하고, 위임하느냐가 전부다규.

01 · 왜 서브에이전트인가

서브에이전트의 본질

핵심 특성

메인 에이전트와 다른 독립적인 시스템 프롬프트, 독립된 기억 공간(컨텍스트)를 가진다. 이걸 이해하는 순간 활용법이 달라져.

🧠
독립된 시스템 프롬프트

자기만의 역할 정의와 규칙으로 동작해. 철학, 스타일, 제약이 별도로 세팅된 전문가야.

📦
독립된 컨텍스트

메인 대화 히스토리와 섞이지 않아. 오염 없이 해당 도메인에만 집중할 수 있어.

병렬 실행 가능

독립적인 작업은 동시에 돌릴 수 있어. 이 독립성이 병렬 처리를 가능하게 해.

🎯
좁고 깊은 전문성

"Python 미니멀리스트"처럼 좁게 세팅할수록 결과물 품질이 올라가.

02 · 설계 시작점

두 가지 설계 경로

경로 A
도메인을 아는 경우
지식 보유 시
에이전트 직접 구상
LangGraph 전문가, Python-pro 등 구체적으로 설계
철학 & 스타일 결정
"Python 미니멀하게", "다크네이비 지향"
AI한테 파일 작성 위임
에이전트 파일 자체는 직접 안 써
내 청사진 → AI가 문서로 구현
경로 B
도메인 모르는 경우
지식 없을 시
맥락 총집합 공유
기획, 구조, 상황, 나의 개발 습관 전부
AI와 함께 구상
"어떤 전문 에이전트가 필요할까?"
방향 판단 & 수정
"플로우 에이전트 말고, 도메인 전문가 원해"
AI 제안 → 내가 방향 검증 → AI가 구현

03 · 에이전트 훈련

전문가를 교육하는 3단계

1
역할 정의

이 에이전트는 누구인가? 좁고 명확할수록 전문성이 높아져.

✓ FastAPI + async 전문가 ✓ LangGraph 워크플로우 설계자
2
철학 & 스타일

어떤 가치관으로 일하는지 알려줘. 비기능적 요구사항이 개성을 만들어.

✓ simple is best 철학 ✓ 다크네이비 컬러 팔레트
3
위임 범위 설정

딱 그 에이전트 영역만 맡겨. 경계가 명확할수록 결과가 정확해.

✓ 이 모듈의 타입 설계만 ✓ 이 컴포넌트의 스타일만

04 · 실전 협업 패턴

에이전트와 일하는 5가지 방식

Pattern 01 의견 먼저,
같이 계획

"이거 만들어줘"가 아니라 "이거 어떻게 생각해?"로 시작. 같이 생각하는 과정이 핵심이야.

"에이전트 구조 어때? 도메인 전문이 아니라 플로우처럼 느껴지는데, 어떻게 고칠까?"
Pattern 02 리서치 →
판단 → 실행

이해 → 판단 → 실행 순서를 반드시 지켜. 무작정 "만들어줘"는 방향 오류를 낳아.

조사 → 내 상황에 어떻게 적용? → 실제 파일 작성
Pattern 03 구체적
피드백

결과물 받고 끝이 아니야. 정확히 짚어서 반복 개선해. 구체적일수록 다음 이터레이션이 빨라.

"도구 권한 설명이 부족해. 병렬 실행 예시를 실제 코드로 보여줘."
Pattern 04 목적 항상
공유

"왜 필요한지"가 결과물 품질을 결정해. 한 문장이 톤, 깊이, 방향을 완전히 바꾼다.

"팀 온보딩 문서야. 개발 경험 없는 사람도 읽으니까 쉽게 풀어줘."
Pattern 05 대화 자체가
플랜

Plan 모드 안 써도 돼. 질문 → 의견 → 방향 정하기 → 실행 지시. 이 흐름이 가장 유연한 플래닝이야.

"구조 분석해줘" → "문제점은?" → "어떻게 리팩토링?" → "바로 고쳐줘."

핵심 통찰

딱 디테일만 집어서,
딱 그것만 위임해

서브에이전트의 가치는 독립성에 있어. 그 독립성을 살리려면 경계가 명확해야 해. 모든 걸 다 시키는 에이전트는 아무것도 잘 못하게 된다.

먼저
상황 파악
중요한
계획 설계
핵심은
전략 실행