2.8 KiB
2.8 KiB
| trigger | description |
|---|---|
| model_decision, subagent_delegation | 모델 등급별 역할 분담 및 서브에이전트 활용 규칙 |
Tiered Model Workflow & Subagent Delegation Rule
복잡한 시스템 기획과 효율적 실행을 분리하여 리소스를 최적화하고 작업 속도를 향상시키기 위한 모델/서브에이전트 운용 원칙입니다. Kord 프로젝트 내에서 수행되는 모든 에이전트 작업에 이 원칙을 우선 적용합니다.
1. 모델 전환 권고 기준 (Model Switching Guide)
에이전트는 사용자의 요청을 분석한 후, 필요에 따라 사용자의 개입을 요청하여 적절한 모델 등급으로의 변경을 제안해야 합니다. (에이전트 스스로 모델 전환을 직접 수행할 수 없기 때문입니다.)
-
High-Tier Model (예: Gemini 3.1 Pro/Ultra 등) 권장 상황:
- 모노레포 구조 설계 문제 혹은 대규모 아키텍처 변경.
- 심도 깊은 설계 단계 리서치, 다수 파일이 연계된 복잡한 버그 추적.
- → 응답 가이드: "진행하려는 작업은 높은 논리성과 깊은 추론을 요구합니다. 본 기획/설계를 마치기 위해 저를 높은 성능의 Pro/Ultra 모델로 전환해 주시면 더 정교한 계획 수립이 가능합니다."
-
Efficient Model (예: Gemini 3 Flash 등) 권장 상황:
- 이미 수립되고 승인된
implementation_plan.md에 근거한 단순 코드 구현 및 기계적 실행. - 패턴화된 파일 리팩토링, 단순 단위 테스트 실행, 문서 정리 및 색인.
- → 응답 가이드: "계획 수립이 확정되었고, 남은 것은 구현과 반복적인 테스트입니다. 효율성과 응답 속도 향상을 위해 실행 모델(Flash)로 전환하셔도 무방합니다."
- 이미 수립되고 승인된
2. 서브에이전트 위임 (Subagent Delegation)
복잡한 작업을 모두 메인 에이전트가 단일 프롬프트로 처리하려 하지 말고, 특화된 작업은 적절히 쪼개 병렬 혹은 서브 Task로 위임합니다.
- 작업의 분할 (Task Decomposition):
- 실행 단계(Phase 2) 돌입 시, 작업을 독립적인 단위로 쪼개어 Task 목록화합니다.
- 브라우저 서브에이전트 (
browser_subagent) 활용 필수 상황:- 대시보드의 특정 UI가 의도대로 렌더링되는지 눈으로 확인이 필요한 경우 (예: Next.js 로컬 구동 결과 확인).
- 웹 페이지를 통한 로그인, OAuth, 동적인 요소 추출이나 브라우저 기반 에러 로그 확인이 필요한 경우.
- 에이전트는 해당 작업을 서브에이전트용 특화 프롬프트(Task)로 명확히 분리하여
browser_subagent툴에 인가하고, 이후 반환된 DOM 상태나 스크린샷 결과를 메인 작업의 컨텍스트(Walkthrough 등)에 결합해야 합니다.