메뉴
작업을 병렬화할 수 있을 때 적용 — sequential, subagent, team 중 선택; inline vs subagent 결정; foreground vs background 실행. 에이전트를 띄우기 전에, 또는 작업이 파일 3개 이상 또는 독립 서브태스크 2개 이상으로 퍼질 때 사용한다.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
executor(메인 세션 vs subagent vs team), 모델(Opus/Sonnet/Haiku), effort 레벨 중 무엇이 작업에 맞는지 정할 때 적용 — 즉 사소하지 않은 작업을 위임하기 전에. 다운그레이드 엄격 조건(plan 정밀도 + 검증 루프), 에스컬레이션 트리거, blast-radius 오버라이드, subagent 브리핑 기준을 다룬다.
Apply when deciding which executor (main session vs subagent vs team), which model (Opus/Sonnet/Haiku), and what effort level fits a task — i.e. before delegating non-trivial work. Covers strict downgrade conditions (plan precision + verification loop), escalation triggers, blast-radius override, and the subagent briefing standard.
장시간 작업이 백그라운드에서 돌고 사용자가 완료나 진행 상황을 봐야 할 때 적용 — 완료 알림만(기본), Monitor를 통한 이벤트 스트림, ScheduleWakeup을 통한 인터벌 폴링 중 선택. 서브프로세스를 tmux split pane, sentinel 문자열, foreground tail/grep 루프로 감시하고 싶어질 때도 적용 — 그 패턴은 실패했고 post-mortem이 여기 있다. 결정 사다리, 안티패턴, tee 기반 사용자 가시 스트리밍을 다룬다.
웹을 둘러보거나, 페이지 내용을 추출하거나, 데이터를 긁거나, 사이트에서 수치를 가져올 때 적용하세요 — agent-browser(기본 lightpanda, 무겁거나 상호작용이 필요한 페이지는 chrome), 발견용 WebSearch, 차단 본문 회수용 insane-search 스킬 중에서 고릅니다. agent-browser가 차단/빈/동적 콘텐츠를 돌려줘서 다른 엔진으로 재시도하거나 형제 URL을 추측하고 싶어지는 순간에도 적용 — 브라우저 에스컬레이션을 멈추고 검색 기반 도구로 전환하세요. Codex --search는 교차검증 전용 GPT 의존 최후 수단입니다.
Apply when a long-running task runs in the background and the user needs visibility into its completion or progress — choosing between completion-notification-only (default), streamed events via Monitor, and interval polling via ScheduleWakeup. Also apply when tempted to monitor a subprocess via tmux split panes, sentinel strings, or a foreground tail/grep loop — that pattern failed and its post-mortem lives here. Covers the decision ladder, anti-patterns, and tee-based user-visible streaming.
Apply when browsing the web, extracting page content, scraping data, or fetching figures from sites — choosing between agent-browser (lightpanda default, chrome for heavy/interactive pages), WebSearch for discovery, and the insane-search skill for retrieving blocked content. Also apply the moment agent-browser returns blocked/empty/dynamic content and you are tempted to retry with another engine or guess sibling URLs — stop escalating the browser and switch to a search-based tool. Codex --search is the GPT-dependent last resort for cross-provider verification only.
| name | parallel-execution-modes |
| description | 작업을 병렬화할 수 있을 때 적용 — sequential, subagent, team 중 선택; inline vs subagent 결정; foreground vs background 실행. 에이전트를 띄우기 전에, 또는 작업이 파일 3개 이상 또는 독립 서브태스크 2개 이상으로 퍼질 때 사용한다. |
작업을 병렬화할 수 있을 때 전략은 셋으로 갈린다. 워커끼리 통신해야 하는지, 작업이 얼마나 독립적인지를 보고 고른다.
| Mode | 언제 쓰나 | 토큰 비용 | 워커 간 통신 |
|---|---|---|---|
| Sequential | 작업이 서로 의존하거나, 확인할 게 1~2개뿐일 때 | 최저 | 해당 없음 |
| Subagents | 최종 결과만 필요한 독립 작업 | 중간 | 없음 (각자 메인 세션에만 보고) |
| Teams | 워커끼리 조율하거나 발견을 두고 논쟁해야 하는 복잡한 작업 | 최고 | teammate 간 직접 메시징 |
워커가 하나만 필요할 때조차, 인라인(메인 세션)으로 처리할지 subagent로 위임할지의 선택은 중요하다.
다음 중 하나라도 해당하면 subagent에 위임한다:
인라인으로 유지한다:
고른 executor 안에서의 모델 선택(Opus/Sonnet/Haiku)은 model-effort-delegation 스킬을 보라.
두 축이 독립적이며, 순서대로 적용한다:
run_in_background: true를 선호해서 subagent가 도는 동안 메인 세션이 새 사용자 요청을 받을 수 있게 자유롭게 둔다.wall-clock 시간을 미리 추정하는 건 믿을 게 못 된다. 관찰 가능한 fan-out이 더 나은 트리거다. 파일 3개 이상 또는 독립 서브태스크 2개 이상에 걸치는 작업은 장시간 작업 후보다 — 백그라운드(그리고 항목이 독립적이면 동시) subagent를 기본으로 한다.
개수만 보고 판단하지 않게 조심한다(Goodhart): 개수가 아니라 개수 × 항목당 비용이다. 한 줄짜리 편집 3개, 사소한 rename 3개, 답 하나를 위해 읽는 파일 3개 — 모두 인라인에 머문다. 이 proxy는 각 항목이 사소하지 않은 작업을 질 때만 발동한다.
Agent 도구로 띄운다. 각 subagent는 자기만의 context window에서 돌고 호출자에게 결과 하나를 돌려준다. 워커끼리는 서로 보이지 않는다.
적합한 경우:
settings에 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1이 필요하다. teammate들은 task list를 공유하고 서로 직접 메시지를 주고받으며, lead가 끼지 않아도 스스로 조율한다.
적합한 경우:
현실적 한계: