# 에이전트 협업

에이전트가 함께 검토, 작성, 구현, 관리하도록 하는 방법을 선택합니다.

## 필요한 도움의 종류 선택

먼저 프로젝트에서 작업을 시작하십시오. 변경 사항에 대한 다른 의견이 필요할 수도 있고, 비교할 여러 초안이나 기능의 일부를 병렬로 구현할 워커가 필요할 수도 있습니다.

각 튜토리얼에는 예제 구성과 조정할 수 있는 프롬프트가 있습니다. 검토, 작성, 병렬 구현에서는 한 에이전트가 협업자를 시작합니다. Facade 패턴에서는 관리자가 이미 실행 중인 에이전트의 진행 상황을 확인합니다.

## 협업 패턴 선택

- [한 에이전트가 작성하고, 다른 에이전트가 반복 검토합니다.](https://facadecode.com/ko/docs/collaboration/implement-review/)
  두 번째 에이전트가 변경 사항을 검토하고 발견한 내용을 보고한 뒤 수정 사항까지 확인하게 합니다. 이 예제에서는 Claude Code가 코드를 작성하고 Codex가 검토합니다.

- [여러 에이전트가 초안을 작성한 뒤 서로 검토합니다.](https://facadecode.com/ko/docs/collaboration/cross-review-writing/)
  여러 에이전트가 같은 브리프를 바탕으로 글을 작성하고, 서로의 초안을 검토한 뒤 피드백을 반영해 수정하게 합니다.

- [SOTA 모델로 계획하고, 더 저렴한 워커로 병렬 구현합니다.](https://facadecode.com/ko/docs/collaboration/parallel-worktrees/)
  최첨단(SOTA) 모델로 복잡한 작업을 계획합니다. 워커는 더 저렴한 모델을 사용해 병렬 worktree에서 계획을 구현합니다. 조정자는 통합된 변경 사항을 검토하고 테스트를 실행합니다.

- [Facade 패턴: 한 에이전트에게 팀 관리를 맡깁니다.](https://facadecode.com/ko/docs/collaboration/phone-led-team/)
  한 에이전트가 기능별 에이전트의 진행 상황을 확인하며 각 에이전트의 질문을 사용자에게 전달하게 합니다. 자리에서 벗어날 때는 휴대폰으로 그 관리자와 계속 대화하십시오.

## 프로젝트에 예제 적용

문서의 구성을 따른 다음 프롬프트의 작업 부분을 실제 작업으로 바꿔 보내십시오. 예를 들어 파일을 편집하지 않고 검토하라는 식으로 역할을 규정하는 지시는 그대로 유지합니다. 계정에서 사용할 수 있는 CLI와 모델을 선택하십시오.

조합을 [에이전트 설정](https://facadecode.com/ko/docs/settings/)의 이름 있는 항목으로 저장할 수도 있습니다. 기본 유형은 다른 모델 제공자를 사용해도 CLI 통합을 유지합니다.

## 에이전트가 협업하는 방식

Facade는 지원되는 에이전트에 다른 에이전트를 찾고, 협업자를 시작하고, 메시지를 주고받고, 서로의 터미널을 읽을 수 있는 도구를 제공합니다. 조정자는 결과를 모으고 질문을 사용자에게 전달할 수 있습니다.

메시지가 전달되었다는 것은 요청이 상대 에이전트에 도착했다는 뜻입니다. 결과를 알려면 답장을 기다리십시오. 협업자와 직접 대화하려면 Facade 패널에서 해당 터미널을 여십시오.

`type: "custom"`을 사용하는 프로그램은 터미널 입력은 가능하지만 이러한 협업 도구는 받지 않습니다.

## 작업에 필요한 프로젝트 환경 사용

에이전트는 검토를 위해 프로젝트 폴더를 공유하거나, 독립적인 변경을 위해 별도의 Git worktree에서 작업할 수 있습니다. 병렬 구현 튜토리얼에서는 워커가 변경 사항을 어떻게 반환해 통합 검토와 테스트를 거치는지 설명합니다.

다른 머신의 도구와 파일을 사용하려면 [원격 머신에서 에이전트 실행](https://facadecode.com/ko/docs/remote-ssh/)을 따르십시오. 책상에서 벗어나 Claude Code 에이전트를 계속 지휘하려면 [휴대폰에서 이어서 작업](https://facadecode.com/ko/docs/remote-control/)을 참조하십시오.

## 설계 참고

이 워크플로는 DeepSeek의 Super Agent 연구 프로토타입에 있는 역할 분리와 인수인계를 Facade의 에이전트 도구에 맞게 적용한 것입니다.

[DeepSeek의 역할 및 커뮤니케이션 설계 ↗](https://github.com/deepseek-ai/dsh-superagent-prototype/blob/main/docs/004-prompts.md)