---
trigger: model_decision, subagent_delegation
description: 모델 등급별 역할 분담 및 서브에이전트 활용 규칙
---

# 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 등)에 결합해야 합니다.
