대부분의 코딩 에이전트 가드레일(guardrails)은 산문 형태입니다: diff를 작게 유지할 것, 표준 라이브러리(standard library)를 선호할 것, 의존성(dependency)을 가볍게 추가하지 말 것 등입니다. 좋은 지침들이지만, 이는 오픈 루프(open-loop) 방식의 지침입니다. 에이전트가 편집을 수행하고 나면, 해당 세션에는 이러한 선호 사항들이 준수되었는지 여부를 드러낼 수 있는 방법이 필요합니다.

Ratchet은 이러한 간극을 메우기 위해 만들어진 작은 오픈 소스 프로젝트입니다. 이 프로젝트의 README는 에이전트의 편집 내용을 검사하고, 이를 측정하며, 그 결과를 동일한 세션으로 다시 보고하는 훅(hooks)을 설명합니다. 이 프로젝트는 advise, guard, strict, off의 네 가지 모드를 문서화하고 있으며, guard가 기본값입니다. 설명에 따르면, strict 처리는 certain 등급으로 판정된 결과에만 적용되며, 호스트(host)가 반환된 결정을 존중하는지에 달려 있습니다.

무엇을 가시화하려고 하는가

문서화된 탐지기(detector) 세트는 의도적으로 실용적입니다: 새로운 매니페스트 의존성(manifest dependencies), 중복되어 보이는 심볼(symbols), 인자만 전달하는 래퍼(wrappers), 플랫폼이 이미 제공하는 기능의 구현, 단일 구현 추상화(single-implementation abstractions), 그리고 새로운 파일, 의존성 및 순 추가된 라인(net added lines)에 대한 예산 등이 포함됩니다.

이는 에이전트 지원 작업(agent-assisted work)을 위한 유용한 프레임워크입니다. 비용은 대개 명백하게 잘못된 결정 하나로 발생하는 것이 아닙니다. 긴 세션에 걸쳐 검토하기 어려운 작은 추가 사항들이 축적되는 것이 문제입니다: 또 다른 패키지, 또 다른 패스스루(pass-through) 컴포넌트, 다른 이름으로 이미 존재하는 또 다른 헬퍼(helper) 함수 등 말입니다.

공개 저장소는 hooks/ 아래에 가드 훅(guard hook), 변경 사항 읽기 코드, 탐지 코드를 분리해 두었습니다. 패키지 매니페스트는 Node.js 20 이상을 선언하며 node --test를 사용합니다. 이는 소스 관찰 결과일 뿐입니다: 저는 이 프로젝트를 설치, 설정 또는 실행하지 않았습니다.

경계가 중요한 부분입니다

Ratchet의 README는 탐지기를 타입 체커(type checker)가 아닌 정규 표현식(regex) 및 git grep으로 명시적으로 설명합니다. 이는 탐지 결과를 정답 여부에 대한 판결이 아닌, 리뷰 프롬프트(review prompt)로 만듭니다. 또한 이것이 테스트, 보안 리뷰 또는 아키텍처적 판단을 대체해서는 안 된다는 것을 의미합니다.

grep, LSP (Language Server Protocol), 또는 단순히 diff를 읽는 것과의 차이점은 더 깊은 의미론적 이해 (semantic understanding)가 아닙니다. 그것은 이벤트 타이밍 (event timing)과 연속성입니다. 즉, 에이전트의 편집 후에 체크가 실행되며, 프로젝트는 마크(mark) 및 원장(ledger)과 같은 세션 지향적 측정값 (session-oriented measurements)을 기록합니다. 이미 코딩 에이전트를 사용 중인 팀에게 이는 변경 사항이 아직 작을 때 모호한 선호도를 짧은 논의로 전환할 수 있게 해줍니다.

누가 이를 고려해야 할까요?

팀이 이미 에이전트 워크플로우 (agent workflow)를 갖추고 있으며, 에이전트가 생성한 diff에서 의존성 침식 (dependency creep)이나 불필요한 추상화 (unnecessary abstraction)가 반복적으로 발생하는 것을 목격한다면 이러한 종류의 도구를 고려하십시오. 만약 타입 레벨의 확실성 (type-level certainty)이 필요하거나, 휴리스틱 기반의 오탐 (heuristic false positives)을 수용할 수 없거나, 훅 (hook) 설정을 유지 관리하고 싶지 않다면 건너뛰십시오.

저는 이것을 사전 리뷰 단계의 속도 조절 장치 (pre-review speed bump)로 평가합니다. 권고 모드 (advisory mode)로 시작하여, 발견된 내용이 귀하의 저장소 (repository)에 유용한지 검사하고, 기존의 일반적인 테스트 및 리뷰 게이트 (review gates)는 그대로 유지하십시오. 경고를 증거로 취급하지 마십시오.

테스트되지 않음 / 실행되지 않음. 이 기사는 공개 문서와 소스 검사를 기반으로 하며, 독립적인 성능, 정확성 또는 호환성에 대한 주장을 포함하지 않습니다. 추가 읽기: 프로젝트의 README, detector module, guard hook.