에이전트 팀을 만들었지만, 그들이 무엇을 하는지 볼 수 없었다

제 에이전트 팀의 첫 파일들은 2026년 9월 20일 22시 47분에 작성되었습니다. 다음 날에는 그것들을 지켜볼 웹 대시보드가 생겼습니다. 이 대시보드는 에이전트들이 얼마나 부지런했는지에 따라 그 내용도 달랐습니다. 만약 하나의 에이전트가 상태 보고를 건너뛰면, 사무실의 그 부분은 비어있었습니다.

이 글은 Refmade 구축에 관한 16개 포스트 중 첫 번째이며, 이틀에 한 번씩 발행됩니다. Refmade는 사용자의 컴퓨터에서 Claude Code와 Codex가 이미 작성한 세션 로그를 읽어 작은 픽셀 아트 사무실로 그려주는 데스크톱 앱입니다. 이를 통해 어떤 에이전트가 무엇을 하고 있는지 볼 수 있습니다. 이는 Anthropic이나 OpenAI와 관련 없는 독립적인 앱입니다. 저는 한국에 거주하는 솔로 개발자이며, 작업 분담 방식에 대해 미리 말씀드리겠습니다. Claude Code와 Codex 에이전트들이 저의 지시에 따라 대부분의 코드를 작성했습니다. 제가 계획하고, 결정하고, 검토했습니다. 이 포스트들은 결정 사항들, 되돌린 부분들, 그리고 버그들에 관한 것입니다.

이 시리즈는 실제 사건 순서를 따릅니다. 다음 몇 개의 포스트에서는 통제 불능으로 커진 제품 계획, 로그 읽기로 전환한 과정, 그리고 Claude Code와 Codex가 해당 로그를 작성하는 방식의 지도를 다룹니다. 나중 글들에서는 노타라이징(notarization) 없이 Mac 앱을 배포하는 것, 너무 늦게 도착한 첫 Git 커밋, 그리고 실패한 출시를 막은 게이트에 대해 다룹니다. 실패 역시 성공적인 출시만큼 많은 공간을 차지합니다.

앱의 UI는 현재 한국어입니다. 이 시리즈 후반부에 변경될 것이므로, 모든 스크린샷에는 영어 캡션이 달려 있습니다.

이름은 죽은 프로젝트에서 유래했다

'Refmade'라는 이름은 앱보다 더 오래되었습니다. 2026년 3월 20일부터 7월 2일까지 Refmade는 다른 제품이었습니다. 바로 갤러리 프런트엔드를 가진 웹 디자인 레퍼런스 카탈로그였습니다. 약 83개의 레퍼런스와 131개의 커밋, 그리고 결제 통합 기능이 연결된 Next.js 앱이었습니다. 4월 1일의 한 커밋은 갤러리에서 발생한 모바일 메모리 부족 충돌을 수정했습니다.

그래서 저는 그것에 대한 작업을 중단했습니다. 8월 7일에 호스팅 계정을 정리하고 29개의 프로젝트를 12개로 줄였습니다. 예전 Refmade 프로젝트는 단 하나의 이유 때문에 살아남았습니다. 바로 커스텀 도메인이 연결되어 있었기 때문에 삭제 대상에서 제외한 것입니다. 약 6주 후인 9월 21일에 그 도메인은 새로운 오피스 대시보드를 가리키도록 설정되었습니다.

갤러리의 코드는 아무것도 이어지지 않았습니다. 새 앱은 9월 20일에 완전히 새로 시작했습니다. 남아있는 것은 이름과 우연히 건져진 도메인뿐이었습니다.

제가 볼 수 없었던 팀

9월 20일의 파일들은 제품이 아니었습니다. 그것은 Codex를 위한 개인적인 운영 설정이었습니다: 11개의 서브 에이전트 정의(PM, product, business, marketing, design, Figma, engineering, implementation, research, data analysis and review)와 팀 리드가 주요 대화 역할을 하는 것 외에, 이것이 제 요청으로 만들어진 개인 운영 설정이라는 내용의 짧은 README가 있었습니다. 저는 팀을 가지고 있었습니다. 하지만 그것이 무엇을 하고 있는지 알 수 없었습니다.

여러 에이전트들이 별도의 터미널에서 실행되면서,

첫 번째 버전에서는 각 에이전트에게 자신의 상태를 기록하도록 요청했습니다. 작은 기록 스크립트가 이 보고서들을 파일에 작성했고 대시보드가 이를 그려냈습니다. 별도의 관찰자(observer)는 세션 창이 열려 있다는 것은 알 수 있었지만, 역할이나 다음 단계, 회의 정보가 첨부되지 않은 채 자체 레이어에 목록으로만 표시했습니다.

agent -> 상태 보고서 작성 -> 파일 -> 대시보드 -> "사무실"
              |
              +-- 보고서를 건너뜀 -> 그릴 것이 없음 -> 빈 바닥

장기적인 작업 중간에 있는 에이전트가 굳이 멈춰 서서 상태 메모를 작성할 특별한 이유가 없습니다. 그러지 않았을 때, 해당 에이전트는 바닥에 아무것도 없었고, 사람이 없는 바닥은 마치 유휴(idle) 팀처럼 보였습니다. 대시보드는 "아무도 일하지 않는다"는 것과 "아무도 보고하지 않았다"는 것을 구분할 수 없었습니다.

9월 21일에는 대시보드가 제대로 작동했고, 테스트를 통과했으며 화면은 디자인과 일치했습니다. 하지만 9월 25일이 되자 저는 접근 방식 자체가 잘못되었다고 판단했습니다. 제가 자체 보고(self-reports)를 로그 읽기(log reading)로 대체한 과정은 다음 글에서 다룰 내용입니다.

제가 얻은 교훈은 지엽적이었습니다. 관찰되는 시스템이 스스로 묘사하는 것에 의존하는 대시보드는 가장 정확해야 할 순간에 틀릴 것입니다. 에이전트의 협조 없이 제가 읽을 수 있는 모든 것이, 에이전트가 저에게 말하기로 선택한 어떤 것보다 더 신뢰할 만했습니다.

같은 대시보드에는 또 다른 작은 문제가 있었습니다. 로고의 흰색 배경이 간판에서 튀어나와 보였습니다. 저는 원래의 로고 파일은 건드리지 않고, 간판 내부에서 그 위치와 블렌드 모드(blend mode)만 수정했습니다.

Codex(gpt-image-2)로 생성된 제품 사이트의 이전 버전 일러스트: 다섯 명의 캐릭터, 책상 및 포스트잇이 붙은 화이트보드. 이는 AI가 생성한 아트이며 앱 스크린샷이 아닙니다.

오늘날 사무실의 모습

현재 앱은 보고서가 아닌 로컬 로그에서 세션별로 팀을 가져옵니다. 버전 0.3.9의 세 팀이 포함된 일부를 보여드립니다.

Refmade 0.3.9, 공개 데모 데이터, UI는 한국어입니다. 왼쪽: '동네 워크숍(Neighborhood workshop)' 영역 (Claude, 1개 팀), 작업 '홈페이지 예약 화면 개선', 2명의 아트팀 멤버와 협업 중. 중앙 및 오른쪽: '스프링-라이트 카페(Spring-light cafe)' 영역의 두 팀 (Codex). 중앙: 작업 '신메뉴 프로모션 준비', 3명의 마케팅팀 멤버와 협업 중. 오른쪽: 작업 '고객 문의 답변 분류', '답변이 필요합니다'로 표시됨. 워크숍과 카페 이름은 가상의 샘플 데이터입니다.

현재 상황

Refmade는 오늘날 Mac(Apple Silicon) 및 Windows에서 실행되며, 무료이고, 사용자의 기기에 Claude Code 또는 Codex가 설치되어 로그인되어 있어야 합니다. 버전 0.3.9가 현재의 Mac 빌드입니다. 이후 게시물에서는 이러한 각 부분이 어떻게 구현되었는지, 심지어 잘못된 부분까지 다룹니다.

앱 링크는 시리즈의 마지막 게시물에 포함됩니다.

다음 내용은 제 에이전트 팀이 9월 21일에 작성한 제품 계획과 게스트북 및 가챠가 성장했던 날들에 관한 것입니다.

만약 사용자의 에이전트들이 별도의 터미널이나 세션에서 실행된다면, 현재 어떤 것이 기다리며 멈춰 있는지 어떻게 알 수 있습니까?