MateClaw 2.3.0이 불변 JSON 검수로 장기 작업 완료 판정을 바꾼다

MateClaw 2.3.0 정식 버전이 2026년 9월 20일 공개됐다. 이번 릴리스의 중심에는 여러 단계를 오래 수행하는 장기 실행 목표(Persistent Goal)를 어떻게 끝난 것으로 인정할지가 있다. 에이전트가 스스로 완료를 선언하면 그대로 받아들이는 대신, 사용자가 정의한 JSON 검수 규칙을 서버가 적용해 목표 완료 여부를 판정하는 구조다.

구체적으로 Persistent Goal에 사용자 구성 기반의 관리형 JSON 검수가 추가됐다. 에이전트는 산출물을 불변(immutable) 버전으로 발행하고, 서버는 검사 결과를 현재 요구사항과 특정 generation에 묶어 바인딩한다. 현재 시점에서 유효한 바인딩이 모두 통과해야만 목표를 완료 상태로 넘길 수 있다. 요구사항이 바뀌면 이전 generation에 걸린 검사 결과는 더 이상 유효하지 않게 되므로, 오래된 검증 결과가 새 요구사항의 통과 근거로 재사용되지 않는다.

같은 릴리스에는 관찰 모드 실행 증거, Team Worker의 통제된 개입, Skill 문서 및 폴더 업로드도 포함됐다. 실행 과정에서 남는 증거를 확인할 수 있게 하고, 팀 단위 작업자에 대한 개입 지점을 제한적으로 두며, 스킬 정의를 문서와 폴더 단위로 올릴 수 있게 하는 쪽의 변경이다.

배경에는 자율 에이전트 운영에서 반복적으로 드러나는 문제가 있다. 작업이 길어질수록 "완료했다"는 자기 보고만으로는 결과를 신뢰할 근거가 없고, 산출물이 여러 번 갱신되면 어느 시점의 결과가 어느 요구사항에 대응하는지 추적하기 어려워진다. 이번 변경은 완료 판정을 에이전트의 진술이 아니라 검사 결과와 버전의 결합으로 옮기려는 시도로 읽힌다.

개발자 입장에서 달라지는 지점은 완료 조건을 코드와 설정으로 표현할 수 있게 된다는 것이다. 검수 규칙을 JSON으로 선언해 두면 목표 달성 여부가 사람의 확인이 아니라 서버의 검사로 결정되고, 어떤 산출물 버전이 어떤 요구사항 아래에서 통과했는지가 기록으로 남는다. CI에서 테스트 통과를 기준으로 병합을 허용하는 방식과 비교할 만하다.

다만 이번 내용은 릴리스 발표를 통해 알려진 범위다. 검수 규칙으로 표현할 수 있는 조건의 범위, 검사 실패 시 재시도나 롤백 정책, 대규모 작업에서의 처리 비용 같은 운영상 세부는 원문에서 확인되지 않았다. "자기 보고 완료를 끝낸다"는 표현 역시 발표 측의 설명이며, 독립적인 검증 결과가 제시된 것은 아니다. 도입을 검토한다면 실제 워크로드에서 검수 규칙이 어디까지 커버하는지 직접 확인하는 편이 안전하다.