결과 코드만으로 설명되지 않는 선택
여기어때 유저혜택개발팀은 AI 워크스페이스를 공동으로 구성하며 겪은 협업 문제를 기술블로그에 공개했다. 글의 작성자는 같은 가이드와 스킬을 사용해도 팀원별 결과가 달라지고, 설계의 전제와 버린 선택지가 개인의 대화에만 남는 문제를 지적한다. 이는 새로운 제품의 출시나 생산성 실험 결과가 아니라 팀이 일하는 방식을 돌아본 경험과 의견이다.
팀은 스킬과 서브에이전트, 가이드, 작업 히스토리를 한 저장소에 모았다. 개발과 운영, 모니터링·PR 작업을 이 환경에서 시작하고 필요한 문맥을 불러오며, 입력과 사용한 스킬, 작업 내용과 결정 사항을 기록했다고 설명한다. 사람이 중간에 선택하거나 AI를 멈추고 수정한 지점도 남겨 결과와 과정이 연결되도록 했다.
작업 기록을 리뷰하고 합의된 규칙으로 올리다
기술블로그는 올해 4월부터 다섯 달간 공유 저장소에 올라온 히스토리의 44%에 사람의 선택이나 수정 지점이 표시됐다고 밝혔다. 아직 공유하지 않은 기록은 포함되지 않았다는 조건도 덧붙였다. 이 비율은 공개된 작업 기록의 특성에 대한 값으로, 코드 오류율이나 AI가 사람을 대체한 비율로 해석할 수 없다.
코드 리뷰에서는 히스토리 링크를 함께 보고 왜 결과가 달라졌는지 살핀다. 개인 작업 중 판단은 잠정 기록으로 남기고, 팀 검토를 거친 내용을 가이드와 스킬에 반영한다. 작성자는 가이드를 읽어도 규칙이 생략되는 사례가 있어 기계로 검사할 조건과 단계별 통과 요건을 따로 마련해야 한다고 설명한다. 글을 잘 적는 일과 실제 준수 여부를 확인하는 일을 나눈 것이다.
작은 절차와 필요한 문맥을 연결하다
팀은 작업 목적별로 스킬을 나누고 해당 단계에 필요한 가이드만 읽게 했다. 스펙 작성과 개발, 검사·커밋·PR이 이어지고 수정이 필요하면 해당 단계로 돌아가는 구조다. 별도 문맥에서 수행할 평가와 많은 코드 열람은 서브에이전트에 맡기되, 사람이 중간에 판단해야 할 절차는 대화 안에 두었다고 설명한다.
앤트로픽의 문맥 관리 해설도 에이전트에 들어가는 정보를 지시문뿐 아니라 도구와 외부 자료, 대화 이력 전체로 본다. 필요한 정보를 실행 중에 불러오는 방식과 구조화된 기록, 문맥 압축 등을 설명하면서 최소 정보가 무조건 짧은 정보를 뜻하지는 않는다고 강조한다. 이 문서는 팀의 성과를 검증한 자료가 아니라 해당 구성의 기술적 배경을 이해하는 근거다.
기록에는 판단의 이유와 적용 조건이 필요하다
ARCH.B의 관점에서 공동 히스토리의 가치는 대화를 많이 보관하는 데 있지 않다. 어떤 요구를 만족해야 했고 어떤 제약 때문에 선택을 바꿨는지 다른 사람이 읽을 수 있어야 한다. 로그가 길어도 핵심 결정이 묻혀 있다면 리뷰어는 같은 질문을 다시 해야 한다. 작업의 범위와 중요한 선택, 남은 불확실성을 짧게 연결한 기록이 검토의 출발점이 될 수 있다.
잠정 판단과 합의된 규칙을 구분하는 방식도 실용적이다. 한 문제에서 효과가 있던 설정을 곧바로 전 팀의 규칙으로 만들면 당시의 예외 조건이 사라질 수 있다. 가이드에 변경 이유와 적용 범위를 함께 적고 다른 작업에서 어떻게 작동했는지 확인하면, 규칙을 추가하는 과정 자체가 검증된다. 기록은 규칙을 늘리는 장치만이 아니라 불필요해진 규칙을 지울 근거도 된다.
검사의 통과와 제품 판단의 소유권을 나누기
기술블로그는 사람이 도메인 규칙과 만족해야 할 조건을 확정하고 AI가 이를 바탕으로 테스트 코드를 만들게 하는 접근을 제시한다. 구현과 테스트를 같은 도구가 작성할 때 놓칠 수 있는 전제를 검토하기 위한 선택이다. 팀이 이 방식을 적용한다면 검사 결과와 별개로 누락된 업무 조건, 외부 시스템의 계약, 실패 시 처리에 대한 판단이 어디서 이뤄졌는지 남길 필요가 있다.
서브에이전트의 재검토 역시 합의나 책임을 대신하지 않는다. 분리된 문맥은 다른 관점의 검토를 돕지만 원래의 요구가 잘못됐거나 자료가 빠졌다면 같은 오류를 반복할 수 있다. 결과 코드와 근거 기록, 팀에서 수정한 조건을 함께 보존해야 이후 유지보수자가 결정을 이해할 수 있다. 이번 사례가 제시하는 협업 자산은 재사용할 프롬프트뿐 아니라 사람이 결론을 내린 과정이다.
출처
여기어때 기술블로그의 원출처와 본문에 표시한 참고자료를 바탕으로 한국어로 재구성했습니다. ‘ARCH.B 분석’은 자료를 읽고 덧붙인 편집 해석입니다.
AI 시대 당신의 팀은 안녕하신가요 (새 창)
