Facade 패턴: 한 에이전트에게 팀 관리를 맡깁니다.

이 패턴을 사용할 때#

여러 에이전트가 기능을 구현하고 있고 진행 상황과 질문을 한곳에서 확인하고 싶을 때 사용하십시오. 모두 로컬에서 실행하거나 일부를 SSH를 통해 원격 머신에서 실행할 수 있습니다. 관리자는 팀의 단일 연락 창구 역할을 하며, 에이전트들이 각자의 작업을 계속하는 동안 업데이트를 취합합니다.

이렇게 역할을 나누면 좋은 점#

• 한 대화에서 여러 기능 확인. 관리자에게 개요를 요청하십시오. 관리자가 기능별 에이전트에게서 업데이트를 모아 각 기능의 상태를 알려 줍니다.
• 주의가 필요한 항목 파악. 관리자가 터미널에서 오류, 할당량 메시지, 답변되지 않은 질문을 확인합니다. 필요하면 해당 에이전트에 자세한 내용을 묻습니다.
• 자리를 비운 동안에도 확인. 휴대폰을 관리자 세션에 연결해 진행 상황을 확인하고, 질문에 답하고, 새 지시를 보낼 수 있습니다.

1. 관리자 시작#

• 진행 상황을 확인할 프로젝트의 편집기를 열어 두십시오. 원격 머신의 에이전트가 있다면 SSH 연결을 유지합니다.
• 기존 Claude Code 에이전트를 관리자로 사용하거나 New Agent로 새로 만드십시오.

이 예제는 Claude Code를 관리자로 사용합니다. 기능별 에이전트는 이미 실행 중이며 각자의 CLI와 모델을 유지합니다.

프로젝트에서 Facade를 열고 New Agent를 클릭한 뒤 관리자로 Claude Code를 선택하십시오. /model opus로 모델을, /effort high로 effort를 설정합니다.

YOLO가 켜져 있으면 관리자는 Facade 홈을 통해 연결된 모든 에이전트에 액세스할 수 있습니다. 이 설정은 CLI 승인 동작도 바꿉니다. 자세한 내용은 승인 및 에이전트 액세스를 참조하십시오.

2. 다른 에이전트의 진행 상황을 확인하도록 요청#

관리자에게 이 프롬프트를 보내십시오:

Facade를 사용해 다른 에이전트의 진행 상황을 확인해 줘.
5분마다 그들의 터미널을 읽고 진행 상황을 확인해 줘. 불분명한 점이 있으면 에이전트에게 직접 물어봐 줘.
에이전트가 오류를 만나거나 막히거나 내 입력이 필요하면 알려 줘.
내가 진행 상황을 물으면 각 기능이 어디까지 진행됐는지 요약해 줘.

3. 팀의 진행 상황을 확인하는 방식#

1. 기능별 에이전트 찾기
2. 주기적으로 진행 상황 확인
3. 질문 및 문제 보고
4. 휴대폰에서 계속

1. 관리자가 기능별 에이전트를 찾아 5분마다 확인 일정을 잡습니다.
2. 확인할 때마다 해당 에이전트의 터미널을 읽습니다. 진행 상황이 불분명하면 관련 에이전트에 묻습니다.
3. 문제를 보고하고 결정이 필요한 질문을 사용자에게 전달합니다.
4. 관리자 세션에서 답하면 관리자가 그 답변을 기능별 에이전트에 전달합니다. 언제든지 전체 진행 보고서를 요청할 수 있습니다.

관리자가 확인 일정이 잡혔음을 알려 줍니다. 관리자 세션을 계속 실행해 두십시오. 관리자가 바쁜 동안 확인이 지연될 수 있습니다.

Claude Code 예약 작업 ↗

4. 휴대폰에서 이어서 작업#

관리자의 Claude Code 세션에서 다음을 실행하십시오:

/remote-control

안내에 따라 세션 링크를 열거나 휴대폰으로 QR 코드를 스캔합니다.

관리자에게 진행 상황을 묻거나, 질문에 답하거나, 업데이트된 요구 사항을 보내십시오. 관리자는 Facade를 통해 기능별 에이전트의 진행 상황을 계속 확인합니다.

관리자가 실행되는 컴퓨터가 절전 상태로 들어가지 않고 온라인 상태를 유지하도록 하고, Claude Code를 실행해 두십시오. 계정 요구 사항과 연결 도움말은 휴대폰에서 이어서 작업을 참조하십시오.

선택 사항: 프로젝트 결정을 위한 PM 또는 테크 리드 추가#

일상적인 결정을 위해 제품 관리자(PM) 또는 테크 리드(TL) 에이전트를 시작하고 Facade에서 고정할 수 있습니다. 프로젝트 방향, 우선순위, 기술 제약, 이전 결정을 해당 에이전트와 논의하십시오. 구현과 디버깅은 기능별 에이전트에 맡겨 이 대화가 결정에 집중하도록 합니다.

둘 다 추가한다면 관리자에게 이들을 어떻게 활용할지 알려 주십시오:

일상적인 제품 관련 질문은 Facade를 통해 @PM에게, 기술 관련 질문은 @TL에게 보내 줘.
우리가 합의한 프로젝트 방향에 따라 결정하게 하고, 그 답을 기능별 에이전트에게 전달해 줘.
합의한 방향을 바꿔야 하는 질문이거나 두 에이전트가 합의하지 못하면 내게 물어봐 줘.

PM 또는 TL 세션이 길어지면 프로젝트 방향, 이전 결정과 그 이유, 미해결 질문을 인수인계할 수 있도록 정리해 달라고 요청하십시오. 정리한 내용을 새 PM 또는 TL에게 전달한 다음 관리자에게 어떤 에이전트에 연락할지 알리십시오.

프로젝트에 적용#

• 확인 간격을 조정하거나, 주의가 필요한 기능에 집중하도록 관리자에게 요청하십시오.
• 기능별 에이전트는 현재 머신에서 계속 작업할 수 있습니다. 관리자가 해당 터미널을 읽고 Facade를 통해 메시지를 보냅니다.
• 프로젝트마다 별도의 관리자를 두십시오. 각 관리자는 해당 프로젝트 에이전트의 진행 상황을 확인하며, 사용자는 각 관리자에게 진행 상황을 묻습니다.

Remote Control을 사용할 때는 Claude Code를 관리자로 유지하십시오. 기능별 에이전트, PM, TL은 다른 CLI와 모델을 사용할 수 있습니다. 저장된 시작 설정과 다른 제공자는 에이전트 설정, 다른 제공자와 함께 사용하는 Claude Code, 다른 제공자와 함께 사용하는 Codex를 참조하십시오.