AI 에이전트는 결정을 내리는 속도가 빠르다. 그리고 그 결정을 기록하는 속도는 사실상 제로에 가깝다. package.json에 의존성 하나 추가하고, 빌드 스크립트를 살짝 손보고, 설정 파일 구조를 바꾸는 일은 각각 보면 합리적이다. 하지만 아무것도 남지 않는다. 6개월 뒤 팀원이 "왜 우리는 Shiki 대신 rehype-highlight를 쓰고 있죠?"라고 물었을 때, 그 답은 더 이상 존재하지 않는 대화 스레드 안에 묻혀 있다. 이게 바로 AI 시대의 새로운 기술 부채 형태다—코드 부채가 아니라 결정 부채(Decision Debt).
문제의 핵심은 AI 에이전트가 나쁘거나 부주의한 게 아니라는 데 있다. 에이전트는 현재 컨텍스트에서 최선을 다할 뿐이다. 지난 세션에서 팀이 내린 아키텍처 결정을 에이전트가 자동으로 체크할 이유도, 그럴 수단도 기본적으로 없다. ADR(Architecture Decision Records)이라는 좋은 포맷이 있어도 "써야 한다는 걸 기억하는 일"이 제일 어렵다는 건 인간도 마찬가지지만, AI는 아예 그 인식 자체가 없다. docs/decisions/에 아무리 잘 정리된 결정 문서가 쌓여 있어도, 에이전트는 그걸 보지 않고 패키지를 설치한다.
이 문제를 정면 돌파하는 방법이 dev.to에서 공개된 Claude Code 훅 기반 아키텍처 게이트 패턴이다. 아이디어는 단순하다. 에이전트가 파일을 수정하기 전에 반드시 아키텍처 리뷰를 거치도록 라이프사이클 훅으로 강제하는 것이다. Claude Code는 UserPromptSubmit, PreToolUse, PostToolUse, Stop 네 시점에 셸 스크립트를 끼워 넣을 수 있는데, 이 훅들을 조합해 '감지→차단→리뷰→해제→초기화'의 5단계 게이트를 구성한다.
구조를 좀 더 들여다보면 실용성이 보인다. 게이트는 페일-클로즈드(fail-closed) 방식으로 작동한다. 훅 입력 파싱이 실패하면 기본값은 차단이다. CSS, 이미지, 락파일처럼 아키텍처와 무관한 파일은 화이트리스트로 제외되고, 나머지 편집은 유효한 세션 마커가 없으면 전부 막힌다. 마커는 단순한 파일이 아니라 TTL(기본 600초)과 슬라이딩 윈도우, 그리고 docs/decisions/ 전체 콘텐츠 해시를 결합한 3중 검증을 통과해야 살아남는다. 결정 문서가 리뷰 이후 변경됐다면 마커는 즉시 무효화되고 재검토가 요구된다. 이 정도면 "귀찮아서 그냥 통과시키는" 거버넌스가 아니라 실제로 이빨 있는 가드레일이다.
리뷰어 역할을 맡는 아키텍트 에이전트(.claude/agents/architect.md)는 읽기 전용 권한으로 다섯 가지를 순서대로 확인한다. 기존 결정과의 충돌 여부, 컨펌 기준 위반, 새 결정 문서화 필요성(처음 두 가지가 PASS/FAIL을 결정한다), 그리고 MADR 4.0 형식 준수와 결정 staleness가 자문 항목으로 따라붙는다. "버전 범프는 패스, 새 ORM 도입은 플래그"처럼 실용적 판단 기준도 에이전트에게 명시적으로 주어진다. 40줄 이하 셸 스크립트 다섯 개로 이 전체 흐름이 돌아간다는 점이 인상적이다. 복잡한 플랫폼 의존 없이, 어떤 에이전트 시스템이든 라이프사이클 이벤트를 노출한다면 동일한 패턴을 적용할 수 있다.
그렇다면 이 거버넌스 레이어를 어떤 도구 위에 얹는 게 효과적일까. 2026년 현재 AI 코딩 어시스턴트 판도를 솔직하게 정리한 리뷰(dev.to)를 보면, 단일 도구 충성보다 역할 기반 조합이 실제로 가장 빠른 팀을 만든다는 결론이 나온다. Claude Code는 터미널 네이티브 에이전트로서 멀티파일 리팩토링과 복잡한 피처 구현에 강하지만 토큰 소모가 크고 명확한 컨텍스트를 요구한다. Cursor는 에디터 레벨의 프로젝트 인덱싱과 그린필드 프로토타이핑에서 빛난다. Copilot은 배경 자동완성으로 조용히 일한다. Amazon Q는 AWS 인프라 전용으로 남겨두면 된다. 각 도구가 경쟁하는 게 아니라 서로 다른 문제를 푼다는 관점이 중요하다.
여기에 Google Stitch의 등장을 겹쳐 보면 그림이 더 입체적으로 완성된다. 구글이 Stitch를 '바이브 디자인' 플랫폼으로 업그레이드하면서, 이제 자연어 한 마디로 UI가 생성되고 인터랙티브 프로토타입이 만들어지고 MCP를 통해 코드로 변환되는 흐름이 현실이 됐다. 피그마 주가가 8% 빠진 건 시장이 이 변화를 진지하게 받아들인다는 신호다. 디자인→코드→아키텍처라는 프론트엔드 워크플로우 전 구간에서 AI가 실질적인 의사결정자로 올라서고 있다.
그리고 바로 그 지점이 문제다. Stitch가 DESIGN.md로 디자인 규칙을 공유하고, Claude Code가 docs/decisions/의 ADR을 참조하는 건 모두 같은 방향을 가리킨다. AI에게 컨텍스트를 주입하는 구조를 인간이 설계해야 한다. 에이전트가 스스로 아키텍처를 존중하길 기대하는 건 사실상 희망 고문이다. 훅으로 게이트를 걸고, 결정 문서를 강제로 읽히고, 리뷰 없이는 커밋이 안 되는 파이프라인을 만드는 것—이게 지금 프론트엔드 아키텍트가 해야 할 가장 중요한 작업이다. 도구가 좋아질수록 거버넌스 설계의 가치는 오히려 높아진다.
앞으로의 방향은 명확해 보인다. 훅 패턴은 Claude Code에만 국한되지 않는다. Cursor의 Rules 시스템, GitHub Copilot의 커스텀 인스트럭션, 그리고 MCP 프로토콜이 성숙할수록 이 '아키텍처 인식 에이전트' 패턴은 더 많은 도구로 이식될 것이다. 디자인 에이전트, 코딩 에이전트, 인프라 에이전트가 각자 독립적으로 달리는 세상에서 이 모든 에이전트가 공통의 결정 레지스트리를 바라보게 만드는 것—그게 다음 단계 거버넌스의 모습이다. 주도권은 더 많은 코드를 쓰는 쪽이 아니라, 에이전트가 따라야 할 불변 조건을 가장 잘 정의하는 쪽에 있다.