클라이언트와 에이전트 공유하기

클라이언트와 에이전트를 공유한다는 것은 에이전트, 코드, 자격 증명을 내 머신에 안전하게 유지한 채, 외부인에게 프로젝트 에이전트에게 질문하고 작업 과정을 지켜보며 결과물을 전달받을 수 있는 룸을 제공하는 것을 의미합니다. 잘 구축된 공유 환경은 기본적으로 읽기 전용이며, 기한이 정해져 있고, 클릭 한 번으로 권한을 취소할 수 있습니다. 잘못 구축된 공유 환경은 계정 공유에 불과합니다.

주간 미팅보다 더 자주 "진행 상황을 보고 싶어" 하는 클라이언트가 있는 에이전시, 프리랜서, 그리고 모든 분께 권장하는 설정입니다.

구조

클라이언트 한 명, 룸 하나, 에이전트 하나, 디렉터리 하나.

• 디렉터리 하나. ~/clients/acme에는 해당 클라이언트의 프로젝트만 들어갑니다. 여기에 고정된 에이전트는 ~/clients/beta나 회사 폴더, 보안 키를 볼 수 없습니다.
• 에이전트 하나. 아무도 헷갈리지 않도록 클라이언트의 이름을 따서 지정합니다: acme.
• 룸 하나. 클라이언트와 본인만 참여합니다. 다른 룸은 클라이언트에게 보이지 않습니다.
• 에이전트의 Plan 모드. 질문에 대한 답변을 제공하되, 사용자가 결정하기 전까지는 디스크의 어떤 내용도 변경되지 않습니다.

클라이언트는 룸을 보고, 룸은 하나의 디렉터리만 보며, 머신의 다른 모든 요소에는 접근할 수 없습니다.

클라이언트가 할 수 있는 일

• 질문하기: "이번 주에 무엇이 바뀌었나요", "내보내기가 왜 1분씩 걸리나요", "현재 디자인 토큰을 보여주세요".
• 타임라인에서 에이전트의 작업 지켜보기: 읽은 파일, 실행한 명령어, 출력 내용의 마지막 부분.
• 아티팩트 전달받기: 요약본, 다이어그램, 내보낸 파일, 미리보기 이미지.
• 파일 첨부하기: 버그 스크린샷, 문구 수정 내역 스프레드시트.

클라이언트가 할 수 없는 일

• 코드 변경(plan 모드인 경우). 특정 단계를 위해 에이전트를 acceptEdits로 전환하더라도 승인 없이는 푸시하거나, 삭제하거나, 비용을 지출하거나, 자격 증명에 접근할 수 없습니다.
• 파일 열람. daemon은 워킹 트리가 아니라 타임라인 이벤트만 업로드합니다. daemon이 업로드하는 항목을 참조하세요.
• 다른 룸, 다른 클라이언트, 또는 내 에이전트 보기.
• 위험한 작업을 직접 승인하기. 해당 작업은 소유자에게 라우팅됩니다.

기간 제한

프로젝트 기간 동안 클라이언트에게 상시 권한을 부여하고, 종료일에 알림을 설정해 두세요. 권한을 취소하거나, 룸에서 제외하거나, daemon을 중지하면 각각 즉시 적용됩니다. 대기 중이던 클라이언트의 요청은 취소되고, 현재 실행 중인 작업은 완료된 뒤 히스토리에 유지됩니다. Invite 링크 자체에도 만료 기한과 최대 사용 횟수를 지정할 수 있습니다.

결과물과 승인

클라이언트가 에이전트에게 "수정 사항을 푸시해 줘"라고 요청하면, 공유 브랜치로 푸시 단계에서 멈추고 승인을 기다립니다. 이것이 올바른 동작 방식입니다. 결과물을 언제 배포할지는 여러분이 결정합니다. Approve하거나, 거부하거나, "읽기 전용으로 계속"으로 응답한 뒤 나중에 직접 배포하세요. 함께 첨부한 메모는 기록의 일부로 남습니다.

기존 방식을 대체하는 점

체크리스트

1. ~/clients/<name> 디렉터리를 만들고 그곳에 프로젝트를 체크아웃합니다.
2. 해당 경로에 고정된 에이전트를 plan 모드로 생성하고, 클라이언트의 이름으로 지정합니다.
3. 룸을 생성하고 에이전트를 추가한 뒤, 만료 기한이 있는 링크로 클라이언트를 초대합니다.
4. 클라이언트의 첫 번째 요청을 Approve합니다. 이후 대기 없이 바로 진행하게 하려면 프로젝트 기간 동안 "항상 허용" 권한을 부여합니다.
5. 자리를 비웠을 때도 룸이 작동하도록 daemon을 서비스로 설치합니다.
6. 프로젝트 종료 시: 권한을 취소하고 멤버를 제거합니다. 히스토리는 소유자에게 그대로 유지됩니다.

자주 묻는 질문

클라이언트도 계정이 필요한가요? 이메일 인증 코드 또는 Google 계정으로 로그인하여 초대를 수락할 수 있습니다. 별도 설치는 필요 없습니다.

두 클라이언트가 에이전트 하나를 공유할 수 있나요? 권장하지 않습니다. 클라이언트마다 디렉터리를 하나씩 두어야 단순한 논리적 격리를 넘어 물리적인 경계가 유지됩니다.

비용은 얼마나 드나요? 요청은 사용자의 구독 요금제에서 실행됩니다. 인원별 사용량이 기록되므로, 클라이언트의 질문에 든 비용을 확인하고 필요한 경우 비용을 청구할 수 있습니다.

클라이언트가 에이전트에 입력한 내 prompt를 볼 수 있나요? 해당 룸에서 일어난 내용만 볼 수 있습니다. 동일한 코드베이스로 진행하는 개인 작업은 다른 에이전트가 연결된 별도의 룸에서 다루어야 합니다.

프로젝트 전용 룸을 만들고 클라이언트가 직접 질문하게 해보세요. 여기서 시작하기.