AI를 위한 실행 취소: 우리가 파일 버전 관리를 만든 이유

AI에게 펜을 주는 것의 문제

자율 AI 에이전트에 대해 아무도 말하지 않는 것이 있습니다: 그들은 “확실합니까?“라는 개념이 없는 다작의 작가입니다.

“이 문서를 개선해 달라"고 요청받은 AI 에이전트는 전체 문서를 다시 작성합니다. “이 코드를 정리해 달라"고 요청받은 에이전트는 만지는 모든 파일을 재구성합니다. 백그라운드 작업을 실행하는 에이전트는 허락을 묻지 않고 파일을 생성, 수정 및 삭제합니다 — 왜냐하면 자율적으로 실행하라고 지시했기 때문입니다.

대부분의 경우 결과는 좋습니다. 하지만 “대부분의 경우"는 되돌릴 수 없는 작업을 잃는 것보다 좋지 않습니다.

그래서 우리는 파일 버전 관리를 만들었습니다. 모든 작업 공간의 모든 파일에 대한 모든 변경 사항이 보존됩니다. 모든 버전은 한 번의 클릭으로 탐색, 비교 및 복원할 수 있습니다.

AI를 위한 Ctrl+Z입니다.

2026년 2월 10일: 모든 것을 바꾼 커밋

커밋 메시지는 다음과 같습니다: “feat: VFS 파일 버전 관리 추가, 이력, 복원 및 작업 롤백.”

이 메시지 뒤에는 사용자와 AI 에이전트 간의 관계를 근본적으로 변화시킨 시스템이 있습니다. 버전 관리 이전에는 AI 에이전트에게 파일에 대한 쓰기 권한을 주려면 신뢰가 필요했습니다. 버전 관리 이후에는 아무것도 필요하지 않습니다 — 왜냐하면 모든 변경 사항은 되돌릴 수 있기 때문입니다.

이것은 당신이 생각하는 것보다 더 중요합니다.

AI 에이전트가 버전 관리가 필요한 이유

인간의 파일 편집은 신중합니다. 파일을 열고, 변경하고, 저장합니다. 결과가 마음에 들지 않으면 되돌립니다. 인지 루프가 촘촘합니다: 변경, 평가, 유지 또는 되돌리기.

AI 에이전트의 파일 편집은 다릅니다. 에이전트는 하나의 작업에서 다섯 개의 파일을 수정할 수 있습니다. 당신이 잠자는 동안 파일을 건드리는 백그라운드 작업을 실행할 수 있습니다. “보고서를 업데이트하라"는 요청을 “보고서를 처음부터 다시 작성하라"로 해석할 수 있습니다.

버전 관리가 없으면 모든 AI 파일 작업은 일방통행입니다. 원본은 사라집니다. 결과가 마음에 들지 않으면, 이전 상태를 수동으로 재구성해야 합니다 — 당신이 기억하고 있다면.

버전 관리가 있으면 모든 AI 파일 작업은 되돌릴 수 있습니다. 원본이 보존됩니다. 결과가 마음에 들지 않으면 “복원"을 클릭하면 1초 이내에 원래 상태로 돌아갑니다.

작동 원리

자동 스냅샷. 파일이 저장될 때마다 — 당신에 의해, AI 에이전트에 의해, 백그라운드 작업에 의해, 파일 업로드에 의해 — 이전 버전이 자동으로 스냅샷됩니다. 수동 작업이 필요 없습니다. “커밋을 기억하라"는 단계가 없습니다. 모든 저장이 이력을 생성합니다.

버전 이력 브라우저. 파일을 열고 전체 이력을 볼 수 있습니다. 모든 버전에는 타임스탬프와 맥락이 있습니다: 누가 변경했는지 (사용자 vs. 에이전트 vs. 백그라운드 작업), 언제, 그리고 어떤 세션에서. 파일의 진화에 대한 전체 타임라인을 볼 수 있습니다.

원클릭 복원. 원하는 버전을 찾습니다. 복원 클릭. 파일이 즉시 되돌아갑니다. 복원 자체가 새로운 버전을 생성합니다 (복원 전의 현재 상태가 보존됨), 따라서 복원도 되돌릴 수 있습니다.

작업 롤백. 우리가 가장 자랑스러워하는 기능입니다. 백그라운드 작업이 파일을 수정할 때, 모든 수정 사항은 작업 ID로 태그됩니다. 작업이 나쁜 결과를 초래한 경우, 단일 작업으로 모든 파일을 작업 전 상태로 롤백할 수 있습니다. 파일별로가 아니라 — 한 번에 모두.

중요한 구현 세부사항

스냅샷은 데코레이터 패턴을 사용하여 생성됩니다. 저장 제공자는 VersionedStorageProvider로 래핑되어 모든 쓰기 작업을 가로채고 쓰기가 완료되기 전에 스냅샷을 생성합니다.

이는 버전 관리가 시스템의 나머지 부분에 보이지 않게 된다는 것을 의미합니다. AI 에이전트는 파일이 버전 관리되고 있다는 것을 모릅니다. 업로드 엔드포인트는 파일이 버전 관리되고 있다는 것을 모릅니다. 백그라운드 작업 엔진은 파일이 버전 관리되고 있다는 것을 모릅니다. 그들은 모두 파일을 정상적으로 쓰고, 버전 관리 레이어가 모든 것을 캡처합니다.

이는 의도적인 설계 선택이었습니다. 우리는 버전 관리가 개발자가 사용해야 할 기능이 되기를 원하지 않았습니다. 우리는 그것이 파일 시스템 자체의 속성이 되기를 원했습니다. 모든 파일은 버전 관리됩니다. 항상. 선택 사항이 필요 없습니다.

신뢰 방정식

버전 관리 이전에는 사용자가 AI 에이전트를 실행할 때마다 암묵적인 신뢰 방정식이 있었습니다:

이 작업의 이점이 에이전트가 내 파일을 망칠 위험을 감수할 가치가 있는가?

중요한 파일 — 신중하게 작성된 보고서, 작동하는 코드베이스, 선별된 데이터셋 — 에 대한 대답은 종종 “아니오"였습니다. 사용자들은 에이전트를 실행하기 전에 파일을 별도의 폴더에 복사하곤 했습니다. 또는 에이전트에게 쓰기 권한을 주는 것을 피했습니다. 또는 모든 파일 작업을 실시간으로 지켜보며 자율 실행의 목적을 무산시켰습니다.

버전 관리는 그 방정식을 없앱니다. 에이전트가 파일을 망칠 위험은 제로입니다, 왜냐하면 모든 변경 사항은 즉시 되돌릴 수 있기 때문입니다. 사용자들은 작업을 실행하기 전에 파일을 복사할 필요가 없습니다. 에이전트가 작업하는 것을 지켜볼 필요도 없습니다. 그들은 그냥 실행하게 하고, 나중에 결과를 검토하고, 잘못된 것은 롤백하면 됩니다.

이것은 관계를 “신중한 위임"에서 “확신 있는 위임"으로 전환합니다. 작업을 실행합니다. 결과를 확인합니다. 좋은 것은 유지합니다. 나쁜 것은 되돌립니다. 사전 작업 준비에 10분이 아닌 10초가 걸립니다.

더 넓은 교훈

AI 에이전트는 강력합니다. 그들은 또한 불완전합니다. 해결책은 그들을 완벽하게 만드는 것이 아닙니다 — 그것은 불가능한 기준입니다. 해결책은 그들의 불완전함을 되돌릴 수 있게 만드는 것입니다.

파일 버전 관리는 더 넓은 원칙의 한 예입니다: 안전망을 구축하라, 가드레일은 필요 없다. 가드레일은 AI의 행동을 방지합니다. 안전망은 AI가 자유롭게 행동할 수 있도록 하면서 실수를 수정할 수 있도록 합니다.

샌드박스 실행은 안전망입니다 (손상을 제한합니다). 파일 버전 관리는 안전망입니다 (이전 상태를 보존합니다). 이벤트 로깅은 안전망입니다 (감사 추적을 생성합니다). 각각은 AI가 더 자율적으로 행동할 수 있도록 하여 자율성을 덜 위험하게 만듭니다.

LikeClaw의 AI 에이전트는 매주 더 나아지고 있습니다. 하지만 그들은 결코 완벽하지 않을 것입니다. 그리고 그것은 괜찮습니다 — 왜냐하면 버전 관리가 있기에 그럴 필요가 없기 때문입니다.