CLAUSE.md 규칙에서 Citadel을 통한 인프라 시행으로 전환

규칙 누적의 문제점

Claude가 지시를 무시했을 때, 본능적으로 CLAUDE.md에 더 많은 규칙을 추가하게 되었습니다. 처음 45줄에서 시작해 3개월 동안 190줄로 늘어났지만, 준수도는 오히려 악화되었습니다. 100줄 이후의 지시사항들은 규칙이 아닌 제안으로 취급되기 시작했습니다. 포렌식 감사 결과 40%의 중복이 발견되었습니다—같은 내용을 다른 말로 표현한 규칙들, 서로 모순되는 규칙들, 그리고 구식 규칙들이 있었습니다. 123줄로 다듬자마자 준수도가 즉시 개선되었습니다.

인프라 전환

진정한 해결책은 CLAUDE.md를 (프로젝트 규약, 기술 스택, 주요 우선순위 같은) 오리엔테이션을 위한 접수 지점으로 인식하고, 모든 규칙의 영구적인 저장소로 보지 않는 것이었습니다. 그 외 모든 것은 필요할 때만 로드되어야 합니다. 핵심 전환점: 시행을 지침에서 환경으로 옮기는 것이었습니다.

예를 들어, Claude가 일관성 없이 따르던 "파일 편집 후 항상 타입체크를 실행하라"는 규칙 대신, 라이프사이클 훅 스크립트가 모든 파일 저장 시 자동으로 실행됩니다. 이렇게 하면 에이전트의 선택과 관계없이 타입체크가 이루어지며, 20번의 편집 후가 아니라 즉시 오류를 발견할 수 있습니다. 이로 인해 리뷰 시간이 극적으로 단축되어 타입 오류를 쫓는 대신 의도와 설계에 집중할 수 있게 되었습니다.

진행 체계

저자는 다섯 단계의 진행 체계를 설명합니다:

• 레벨 1: 원시 프롬프팅 (지속되는 것이 없어 같은 실수가 반복됨)
• 레벨 2: CLAUDE.md (규칙이 도움이 되지만 약 100줄에서 한계에 부딪힘)
• 레벨 3: 스킬 (요청 시 로드되는 모듈식 전문 지식, 비활성 시 토큰 사용 제로)
• 레벨 4: 훅 (환경이 품질을 시행하며, 지시사항이 아님)
• 레벨 5: 오케스트레이션 (병렬 에이전트, 지속적 캠페인, 조율된 웨이브)

대부분의 프로젝트는 레벨 2나 3에서도 충분합니다. 중요한 통찰: CLAUDE.md가 작동을 멈출 때, 해결책은 더 많은 규칙이 아니라 시행을 인프라로 옮기는 것입니다.

구체적 구현

저자는 세 가지 핵심 시스템을 구현했습니다:

• 스킬: 특정 도메인에 대한 패턴, 제약 조건, 예시를 인코딩하는 마크다운 파일입니다. 에이전트는 현재 작업에 관련된 스킬만 로드하여 관련 없는 컨텍스트에 토큰을 낭비하지 않습니다.
• 캠페인 파일: 무엇이 구축되었는지, 어떤 결정이 내려졌는지, 무엇이 남아있는지 추적하는 구조화된 문서입니다. 이는 세션을 넘어 지속되어 매일 반복되는 설명을 제거합니다.
• 자동화된 훅: 모든 편집 시 타입체크, 세션 종료 시 안티패턴 스캐닝, 같은 문제에서 3번 연속 실패 시 에이전트를 종료하는 서킷 브레이커, 그리고 Claude가 컨텍스트를 압축하기 전 상태를 저장하는 압축 보호 기능입니다.

Citadel: 오픈소스 시스템

전체 시스템은 Citadel이라고 불리며, https://github.com/SethGammon/Citadel에서 오픈소스로 공개되었습니다. 여기에는 스킬 시스템, 훅, 캠페인 지속성, 그리고 작업을 적절한 오케스트레이션 레벨로 자동으로 라우팅하는 /do 명령어가 포함되어 있습니다. 668K 라인의 코드베이스에서 198개 에이전트를 대상으로 한 27개의 문서화된 실패 사례에서 구축되었으며, 모든 규칙은 무언가가 고장 난 것에서 비롯됩니다.