> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트

> 일을 나눠 맡는 하위 에이전트, 이름 있는 에이전트, 오케스트레이션, 세션끼리 주고받기.

## 하위 에이전트

에이전트는 요청의 일부를 하위 에이전트에게 맡길 수 있습니다. 하위 에이전트는 새로 시작해 맡은 몫을 하고, 최종 답만 돌려줍니다. 여러 개가 함께 돕니다. 하위 에이전트마다 그것을 시작한 단계 아래에 진행 줄이 생기고, 하위 에이전트가 요청한 승인에는 어느 하위 에이전트인지 표시됩니다.

| 종류 | 하는 일 |
| - | - |
| 읽기 | 읽기만 합니다. |
| 수정 | 폴더의 임시 Git worktree에서 일합니다. 끝나면 변경을 폴더에 합치고, 스테이징이나 커밋은 하지 않습니다. 충돌하면 아무것도 쓰지 않고 patch를 남깁니다. Git 저장소여야 합니다. |
| 백그라운드 | 하위 에이전트가 일하는 동안 에이전트는 하던 일을 계속하고, 끝나면 결과가 대화로 돌아옵니다. |

하위 에이전트는 부모보다 많은 일을 할 수 없습니다. 내 [권한 모드](https://docs.archetype.ing/ko/use/approvals.md)와 승인 규칙이 하위 에이전트의 호출에도 그대로 적용됩니다. 하위 에이전트의 질문은 먼저 부모에게 갑니다. 부모가 10분 안에 답하지 않으면 나에게 오고, **확인 필요**에 보입니다.

하위 에이전트는 Archetype 모델, Claude Code, Codex에서 켜져 있습니다. 끄려면 사용자 설정에 `"children": false`를 둡니다.

**토큰맥싱**은 속도가 먼저인 모드입니다. 에이전트가 일을 서로 의존하지 않는 조각으로 나눠 모두 하위 에이전트에게 한꺼번에 맡깁니다. 상태줄이나 `/tokenmaxxing`으로 켭니다.

## 이름 있는 에이전트

기본으로 `general`과 읽기만 하는 `explore`가 있습니다. 마크다운 파일로 더할 수 있고, 에이전트가 이름과 설명을 보고 고릅니다.

```markdown theme={null}
---
name: reviewer
description: 바뀐 파일을 읽고 버그와 빠진 테스트를 찾습니다
mode: inspect        # inspect 또는 edit, 없으면 작업이 정함
tools: [read_file, search_text]   # 없으면 그 모드의 도구 전부
model: gpt-6-luna    # 부모와 같은 제공자의 모델, 없으면 부모 모델
max-turns: 30        # 1~200, 없으면 한도 없음
---

변경을 꼼꼼히 읽고, 문제마다 경로와 줄 번호, 이유를 적어 보고하세요.
```

| 위치 | 적용 범위 |
| - | - |
| `~/.config/archetype/agents/*.md` | 나, 모든 폴더 |
| `.archetype/agents/*.md` | 이 프로젝트 |

내 것은 같은 이름의 기본 에이전트를 바꿉니다. 프로젝트의 것은 새 이름만 더할 수 있고, 기본 에이전트나 내 것과 이름이 같으면 경고와 함께 빠집니다. 그래서 복제한 저장소가 `explore`가 하는 일을 바꾸지 못합니다.

## 오케스트레이션

대화 하나로는 큰 일이면, 세션 하나가 다른 세션들을 이끕니다.

**1. 시작하기**

`/orchestration` 뒤에 원하는 일을 적거나, 폴더의 새 세션 메뉴에서 **오케스트레이션**을 고릅니다.

**2. 계획에 동의하기**

이끄는 세션이 계획을 씁니다. 단계, 단계마다 끝났다고 볼 기준, 맡을 엔진이 들어갑니다. "Start"라고 답하기 전에는 아무것도 시작하지 않습니다. 바꿀 것을 말하면 계획을 다시 씁니다.

**3. 단계 실행**

단계마다 자기 브랜치에서 일하고, 한 번에 3개까지 돕니다. 단계가 끝나면 다른 엔진이 로그인되어 있을 때 그 엔진이 검토합니다. 검토에서 두 번 떨어진 단계는 나를 기다립니다.

**4. 결과 받기**

기본으로 단계마다 pull request가 준비되고 검사를 통과하면 끝납니다. 이끄는 세션이 합칠 순서를 제안합니다.

단계의 질문은 먼저 이끄는 세션에 가고, 내가 정해야 하는 것만 이끄는 세션의 대화로 옵니다. 설정은 `orchestration` 아래에 있고, `"orchestration": false`면 꺼집니다.

## 세션끼리 주고받기

같은 컴퓨터의 대화끼리 메시지를 주고받습니다([A2A](https://a2a-protocol.org/) 프로토콜). 에이전트에게 다른 세션에 물어보라고 하거나, 다른 폴더에서 일을 시작하라고 하면 됩니다.

* 일하는 중인 세션에 보낸 메시지는 지금 요청에 합류하고, 쉬는 세션이면 그 메시지로 새 요청을 시작합니다.
* 받는 세션은 자기 권한으로 일하고, 승인도 그 세션에서 묻습니다.
* 다른 세션에 보내거나 멈추는 일은 `ask` 모드에서 먼저 묻고, `read-only`에서는 거절합니다.
* 에이전트는 내가 시킬 때만 새 세션을 엽니다. 그 밖에는 하위 에이전트로 일을 나눕니다.
* 사람 없이 메시지가 8번 오가면 더 보내지 않습니다.

끄려면 `"a2a": false`를 둡니다. 프로젝트 설정에 두면 그 폴더에서만 꺼집니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.