‘코딩 에이전트’는 정확하면서도 한편으로는 오해를 부르는 이름입니다. Claude Code와 Codex는 레포지토리에서 작업하도록 만들어졌고, 실제로 그 용도로 가장 잘 알려져 있습니다. 하지만 이들이 실제로 쥐고 있는 것은 여러분 머신의 터미널입니다. 파일, 스크립트, 패키지 관리자, 사용 중인 온갖 도구에서 내보낸 결과물, 그리고 커맨드라인 도구로 충분하지 않을 때 쓸 수 있는 브라우저까지 갖추고 있습니다. 회사 업무의 대부분은 터미널에서 손이 닿는 곳에 있습니다.
핵심은 에이전트가 발표 자료 초안을 만들 수 있느냐가 아닙니다. 에이전트는 할 수 있습니다. 문제는 그 자료가 필요한 사람이 터미널 없이, 여러분의 노트북 없이, 그리고 여러분을 중간 전달자로 거치지 않고 어떻게 에이전트에게 요청하느냐입니다.
코드가 아닌데도 사람들이 에이전트에 요청하는 여섯 가지 작업
회의록을 요약문으로 변환하기. 트랜스크립트를 붙여넣거나 회의록 파일을 드롭하기만 하면 됩니다. 에이전트는 팀에서 이미 사용하는 형식에 맞춰 결정 사항, 담당자, 미해결 질문을 정리해 줍니다. 45분짜리 회의 트랜스크립트가 약 1분 만에 한 페이지 요약문이 됩니다.
개요를 바탕으로 발표 자료 만들기. Markdown 개요에서 회사 템플릿이 적용된 프레젠테이션 파일까지 생성하고, 폴더 내 CSV 파일로부터 차트도 그려냅니다. 슬라이드 12장짜리 주간 발표 자료를 만드는 데 5~6분 정도 걸리며, 대부분은 차트 생성 시간입니다.
디자인 에셋 내보내기. 디자인 도구의 API에서 최신 아이콘을 가져와 세 가지 크기로 내보내고, 최적화한 뒤 사이트 빌드가 읽어가는 폴더에 넣어 둡니다.
캠페인 카피 작성하기. 브리프를 바탕으로 레포지토리에 정리된 브랜드 보이스를 반영해 제목 5개와 본문 3가지 베리에이션을 작성하고 글자 수 제한까지 확인합니다.
주간 운영 보고서 추출하기. 공유 폴더에 있는 CRM 익스포트 데이터를 기반으로 파이프라인 변동 현황 테이블을 만듭니다. 지난주와 동일한 쿼리를 사용하므로 수치도 딱 맞아떨어집니다. 쿼리가 작성된 이후에는 1분도 채 걸리지 않으며, 첫 주만 쿼리를 작성하는 데 씁니다.
스크린샷을 버그 리포트로 변환하기. 오류가 발생한 화면 캡처만으로 재현 가능한 이슈와 관련 파일 경로를 생성합니다. 에이전트가 해당 화면을 구현한 코드를 직접 읽을 수 있기 때문입니다.
이 중 어느 것도 새로운 도구를 필요로 하지 않습니다. 누군가의 요청과, 그 답변을 전달받을 공간만 있으면 됩니다.
코딩 에이전트는 파일, 익스포트 데이터 및 API, 템플릿, 스크립트, 브라우저에 접근할 수 있습니다. 대부분의 사무 업무는 이 다섯 가지 영역 안에 있습니다.
룸이 요청할 수 있는 사람의 범위를 바꾸는 이유
발표 자료를 원하는 사람은 에이전트를 직접 돌리는 사람인 경우가 거의 없습니다. 하지만 룸에서는 그 점이 더 이상 문제 되지 않습니다.
- 아무것도 설치할 필요가 없습니다. 브라우저나 휴대전화에서 룸을 열고 에이전트를 멘션하기만 하면 됩니다.
- 작업 과정을 직접 확인합니다. 각 도구 호출이 룸으로 스트리밍되므로, "지금 작업 중인가요?"라고 따로 물어보지 않아도 바로 알 수 있습니다.
- 결과물을 바로 받습니다. 에이전트가 생성한 파일과 이미지는 룸의 결과물 영역에 표시되어 바로 다운로드할 수 있습니다. 에이전트가 작업 디렉터리 외부에서 생성한 이미지라도 그대로 표시됩니다.
- 제어권은 여전히 여러분에게 있습니다. 상대방의 요청은 여러분이 설정한 권한 모드에 따라 여러분의 머신에서 실행되며, 비용이 발생하거나 크리덴셜에 접근하는 작업은 일시 정지되어 여러분의 승인을 기다립니다.
일반적인 코딩보다 여기서는 첨부 파일이 훨씬 중요합니다. 엔지니어가 아닌 팀원이 원하는 바를 설명할 때 스크린샷만큼 흔하고 편한 방법은 없습니다. 룸은 이미지와 파일을 에이전트를 위한 퍼스트 클래스 입력값으로 다룹니다.
시나리오 표
먼저 설정해야 할 것들
업무 유형별로 에이전트를 하나씩 둡니다. notes는 트랜스크립트와 템플릿이 있는 폴더를, assets는 디자인 익스포트 폴더를, reports는 CRM 덤프 폴더를 가리키게 하세요. 디렉터리 범위를 좁게 유지할수록 에이전트는 집중하고 승인 요청 빈도는 줄어듭니다.
사내 스타일 문서를 폴더에 넣어 두세요. 톤앤매너를 다룬 짧은 STYLE.md, 슬라이드 템플릿, 지난주 보고서에 쓴 SQL 등이 해당됩니다. 에이전트는 눈앞에 있는 것을 읽습니다. 읽어야 할 올바른 자료를 제공하세요.
직급이 아니라 업무에 따라 권한 모드를 선택하세요. 보고서와 요약 작업은 에이전트의 작업 디렉터리에 코드가 없으므로 코드에 위험을 주지 않고 편집 모드로 실행할 수 있습니다. 다만 무언가를 전송하거나 결제하거나 로그인하는 작업은 누구의 요청이든 상관없이 일시 정지되어야 합니다.
처음에는 모호하게 요청해도 괜찮습니다. 엔지니어가 아닌 팀원의 첫 요청은 모호할 수밖에 없습니다. 에이전트가 룸에서 명확히 하기 위한 질문을 던지면, 두 번째 요청은 훨씬 구체화될 것입니다. 이 방식이 장황한 가이드 문서를 읽게 하는 것보다 빠릅니다.
자주 묻는 질문
팀원도 각자의 구독이 필요한가요? 아닙니다. 에이전트는 소유자의 구독을 이용해 소유자의 머신에서 실행됩니다. 룸은 팀원이 그 에이전트에 접근하는 통로입니다.
에이전트가 이미 결제 중인 유료 도구를 사용할 수 있나요? 해당 도구에 커맨드라인 인터페이스나 API가 있고, 소유자의 머신에 크리덴셜이 있다면 가능합니다. 해당 크리덴셜을 사용할 때는 요청자가 아니라 소유자에게 승인 요청이 전달됩니다.
소규모 팀에만 적합한가요? 서로를 신뢰하는 소규모 그룹을 위해 설계되었습니다. 창업 팀, 가족, 클라이언트와 에이전시 등이 대표적입니다. 룸은 그 기본 단위이며, 필요한 만큼 얼마든지 만들 수 있습니다.
가장 뛰어난 에이전트가 오직 여러분의 말만 듣고 있다면, 룸을 만들어 나머지 팀원들이 어떤 질문과 요청을 던지는지 확인해 보세요.
게시일 · 수정일