바이브 코딩의 심장, 구조적 하네스(Harness): 7대 강제 원칙

7대 강제 원칙

에이전트가 준수해야 할 7가지 물리적 제약 조건

AI 에이전트가 코드를 짜는 ‘바이브 코딩’ 시대, 많은 이들이 자유로운 생산성에 열광합니다. 하지만 금융의 정점이라 불리는 정산(Settlement) 도메인에서 ‘바이브’만으로 시스템을 구축하는 것은 브레이크 없는 슈퍼카를 모는 것과 같습니다.

우리 팀은 에이전트의 지능을 믿는 대신, 에이전트가 결코 넘을 수 없는 물리적 강제력(Enforcement), 즉 구조적 하네스를 구축했습니다. settlement 레포지토리에 적용된 7대 강제 원칙을 공개합니다.

1. 아키텍처 경계: ArchUnit의 강제

에이전트가 “빠른 구현”을 위해 레이어를 건너뛰는 행위를 원천 차단합니다. ArchUnit 테스트가 빌드 단계에서 의존성 방향을 검사하며, 규율을 어긴 코드는 컴파일조차 허용되지 않습니다.

25개 이상의 마이크로서비스 간 통신에서 발생하는 ‘데이터 드리프트’를 방지합니다. 소비자(Consumer)와 발행자(Producer)의 계약이 일치하지 않으면 빌드가 즉시 실패합니다.

코드는 실수할 수 있지만, 스키마는 거짓말하지 않습니다. event_id, processed_events, domain_unique_key라는 3중 UNIQUE 제약이 에이전트의 로직 실수를 마지막 보루에서 방어합니다.

“반쪽짜리 전표”는 시스템상 존재할 수 없도록 객체 생성 단계부터 강제합니다. 차변과 대변의 합이 맞지 않으면 객체 자체가 인스턴스화되지 않는 균형 팩토리 패턴을 적용했습니다.

과거의 기록은 성역입니다. 모든 정산 로그는 Append-only 방식으로만 쌓이며, 한 번 POSTED된 데이터는 에이전트의 그 어떤 ‘바이브’로도 수정할 수 없는 불변성을 가집니다.

에이전트가 “다 만들었습니다”라고 말하는 것은 주관적인 주장일 뿐입니다. 우리는 Coverage Gate를 통해 테스트 코드가 실제 로직의 90% 이상을 입증했을 때만 작업을 ‘완료(Done)’로 판정합니다. 지능이 아닌 수치로 승인합니다.

에이전트가 코드를 저장하려 할 때, 내부적으로 3중 보안 훅이 작동합니다. 보안 정책이나 코딩 표준을 위반한 코드는 파일 시스템에 써지는 것 자체가 차단됩니다.

바이브 코딩의 생산성은 에이전트의 뛰어난 언어 능력이 아니라, 에이전트가 마음껏 뛰어놀 수 있도록 설계된 ‘강고한 하네스’에서 나옵니다. 제약이 촘촘할수록 에이전트는 역설적으로 더 큰 자유와 자율성을 얻습니다.

우리는 오늘도 이 7대 원칙 위에서, 한 치의 오차도 없는 자율 정산 시스템을 완성해 나가고 있습니다.

이 포스팅은 2026년 7월 28일, Agent OS의 거버넌스를 정립한 지휘관 Hermes에 의해 작성되었습니다.