예전에는 VS Code와 IntelliJ를 한 번 익히면 그 사용법이 꽤 오래 자산으로 남았습니다. 최근에는 다릅니다. 저도 여러 코딩 에이전트를 다루는 작업 환경을 Orca에서 Paseo 쪽으로 옮겨 보고 있고, 개인 AI 에이전트는 OpenClaw에서 Hermes 쪽으로 바꾸고 있습니다.

네 제품은 같은 범주의 일대일 대체재가 아닙니다. 모델, 코딩 에이전트, 작업 환경, 개인 에이전트처럼 서로 다른 계층의 선택이 동시에 빠르게 바뀌고 있습니다.

문제는 새 도구의 사용법을 배우는 데 있지 않았습니다. 새 세션을 열 때마다 이미 버린 접근을 다시 설명하고, 건드리면 안 되는 경계를 알려 주고, 어디까지 끝냈는지 처음부터 찾아야 했습니다. 코드는 저장소에 그대로 있는데 프로젝트의 기억은 이전 채팅에 남아 있었습니다.

코드는 남아도 판단은 사라질 수 있습니다

새 에이전트는 파일과 커밋을 읽을 수 있습니다. 하지만 코드만 보고는 왜 A안을 버리고 B안을 택했는지, 어떤 테스트가 간헐적으로 실패했는지, 데이터베이스를 어디까지 건드려도 되는지 알기 어렵습니다. 어제 막힌 접근이 기록되지 않았다면 오늘의 에이전트는 같은 막다른 길을 다시 탐색합니다.

이때 전환 비용은 설치 시간이 아닙니다. 이전 대화가 없으면 다시 만들어야 하는 판단의 양입니다.

저는 새 도구보다 먼저 빈 세션을 엽니다

새 AI 코딩 도구를 기준으로 삼기 전에, 이전 채팅을 전혀 보여 주지 않은 세션으로 인수인계를 시험할 수 있습니다. 새 에이전트에는 저장소와 현재 작업 기록만 줍니다. 그리고 네 가지를 묻습니다.

  1. 이 프로젝트의 현재 목표와 다음 미완료 작업은 무엇인가요?
  2. 이미 시도했다가 버린 접근과 그 이유는 무엇인가요?
  3. 건드리면 안 되는 경계와 사람의 승인이 필요한 일은 무엇인가요?
  4. 완료를 증명할 명령·화면·결과와 실패했을 때 돌아갈 방법은 무엇인가요?

네 질문에 답하지 못한다면 새 도구의 성능부터 비교하지 않겠습니다. 먼저 프로젝트 기억을 고칩니다. 이 테스트는 같은 도구의 새 세션으로도 할 수 있어서, 모델 성능과 인수인계 문제를 분리해 볼 수 있습니다.

기능이 많은 도구로 옮겨도 목표와 경계부터 다시 묻는다면 전환할 때마다 프로젝트는 일부 초기화됩니다.

프로젝트 기억은 지도·진행 기록·증거로 나눕니다

모든 대화 전문을 문서로 옮길 필요는 없습니다. 다음 세션의 판단을 바꾸는 정보만 남기면 됩니다.

첫째는 짧은 지도입니다. 프로젝트가 해결하는 문제, 주요 디렉터리, 실행·테스트 명령, 수정 금지 범위, 세부 문서의 위치를 알려 줍니다. AGENTS.md나 CLAUDE.md 같은 파일은 이 지도로 쓸 수 있지만, 어떤 파일을 자동으로 읽는지는 도구마다 다릅니다.[1][2] 파일 이름 하나를 프로젝트 기억으로 착각하면 안 됩니다.

둘째는 진행 기록입니다. 지금 끝난 일과 남은 일, 결정한 이유, 실패한 접근과 다시 시도하지 말아야 할 조건을 적습니다. 성공 기록만큼 실패 이유가 중요한 까닭은 간단합니다. 새 세션이 같은 비용을 다시 내지 않게 하기 위해서입니다.

셋째는 완료 증거입니다. 테스트 명령과 결과, 확인해야 할 화면, API 응답, 데이터 상태와 복구 절차가 여기에 들어갑니다. 완료했습니다라는 답변은 작업 보고일 뿐 증거는 아닙니다. 다음 사람과 다음 에이전트가 같은 방식으로 결과를 재현할 수 있어야 합니다.

OpenAI의 Harness Engineering 사례에서는 큰 지침 파일 하나에 모든 정보를 넣는 방식이 잘 작동하지 않았습니다. 짧은 안내 파일은 지도로 두고, 구조화된 저장소 문서와 버전 관리되는 작업 계획을 원본으로 삼았습니다.[3] 문서에 적은 규칙 가운데 테스트·린터·CI로 검사할 수 있는 것은 실제 검사로 옮기는 편이 좋습니다. 설명은 잊힐 수 있지만 실패하는 테스트는 다음 도구도 멈춰 세울 수 있습니다.

도구에 들어가기보다 떠날 수 있는지를 봅니다

AI 코딩 도구의 승자는 계속 바뀔 것입니다. 한 도구는 코드 탐색에 강하고, 다른 도구는 원격 운영이나 여러 에이전트 관리에 더 잘 맞을 수 있습니다. 모든 일을 한 제품에 통일할 이유도 없습니다.

그래서 저는 새 기능의 수보다 떠날 때 남는 것을 보겠습니다. 작업 상태를 사람이 읽을 수 있는 파일로 꺼낼 수 있는지, 변경을 diff와 테스트로 재현할 수 있는지, 특정 채팅을 열지 않아도 결정 이유와 다음 일을 찾을 수 있는지가 더 오래가는 기준입니다.

내일 에이전트를 바꿔도 빈 세션이 다음 작업을 집어 들고, 이미 막힌 길을 다시 파지 않으며, 같은 금지 경계를 지키고, 같은 증거로 완료를 판정할 수 있어야 합니다. 그 상태가 되면 도구 교체는 프로젝트 초기화가 아니라 선택지 변경에 그칩니다.

도구의 승자는 바뀌어도 프로젝트까지 매번 처음으로 돌아가서는 안 됩니다.

출처

  • AI 개발 도구
  • AI 코딩
  • 개발 워크플로
  • Orca
  • Paseo
  • OpenClaw
  • Hermes