리포지토리에 코딩 에이전트가 프로덕션에 절대 배포하지 말라고 써 두면서도 실제 배포 명령과 자격 증명은 열어 둘 수 있다. 문장은 의도를 전달하지만 능력을 없애지는 않는다. Tessl의 네 부분 프레임워크가 유용한 이유는 이 안내 역할을 로딩과 집행 방식이 다른 절차·통제와 분리하기 때문이다.
팀 소유 파일을 지속적 컨텍스트, 경로 범위 규칙, 재사용 스킬, 수명주기 훅으로 나눈다. 구체적 예는 보편적인 설정 형식이 아니라 Claude Code를 사용한다. 더 넓은 설계 질문은 무엇을 항상 알고 있어야 하는지, 어떤 절차는 필요할 때만 불러올지, 위험 작업은 어디서 모델 판단 밖의 장치로 막을지다.
네 계층은 같은 정책의 복사본이 아니라 서로 다른 계약이다
CLAUDE.md는 빌드 명령, 디렉터리 관례, 아키텍처 경계, 테스트 기대처럼 여러 작업에 필요한 프로젝트 맥락을 제공한다. 서비스의 패키지 관리자나 추가만 허용하는 마이그레이션 관례가 들어갈 수 있다. 루트 파일은 모든 예외의 상세 설명서보다 개요나 색인으로 쓰는 편이 낫다.
.claude/rules/의 집중된 규칙은 경로 패턴에 따라 지침을 로드할 수 있다. 문서를 수정할 때 API 검증 규칙이 주의를 경쟁할 필요는 없다. 여러 패키지의 핸들러나 마이그레이션을 가로지르는 규칙도 같은 문단을 여러 디렉터리에 복제하지 않고 적용할 수 있다.
재사용 기능은 SKILL.md, 메타데이터, 지침과 지원 스크립트·참고자료를 폴더에 묶어 긴 절차를 담는다. 개요는 릴리스 과정을 가리키고 릴리스 스킬이 순서 있는 검사를 소유할 수 있다. Claude Code는 처음에 스킬의 이름과 설명을 로드하며 관련성이 있거나 명시 호출됐을 때 전체 지침을 컨텍스트에 넣는다.
훅은 설정이나 관련 구성을 통해 수명주기 이벤트에 동작을 연결한다. 도구 실행 전 검사는 제안된 작업을 살피고, 편집 후 검사는 변경 내용을 포맷하거나 검증하며, 완료 검사는 멈추기 전에 증거를 요구할 수 있다. 모델이 기억해야 할 지침을 하나 더 쓰는 것과 다르다.
Tessl의 소유권 논리는 이 지식이 버전 관리되는 리포지토리 자산이 된다는 것이다. 엔지니어는 변경 차이를 보고 관리자를 정하고 검토·되돌리기를 하며 새 세션에도 같은 맥락을 줄 수 있다. 호스팅 모델과 런타임은 여전히 공급자 소유다. 파일을 소유한다고 모든 집행 장치를 소유하는 것은 아니다.
컨텍스트를 정책 데이터베이스로 만들면 비용이 커진다
팀은 명령 선택과 이름 관례가 즉시 좋아져 하나의 지침 파일로 시작하곤 한다. 그러다 보안, 릴리스, 프런트엔드 관례와 개인 예외가 쌓여 모든 세션에 로드된다. 상시 내용은 작업 세부, 소스 코드, 도구 결과와 대화 이력과 경쟁한다. 문장이 많다고 더 잘 따르는 것은 아니다.
인용된 Anthropic 지침은 CLAUDE.md를 200줄 미만으로 유지하고 담당자를 두며 코드처럼 검토하라고 권한다. 의미는 주의와 유지 관리이지 줄 수가 보장하는 준수율이 아니다. 간결한 지침도 오해할 수 있고 제한을 위로 옮겼다고 강제력이 생기지 않는다.
중첩 지침 파일은 에이전트가 트리의 관련 부분에 접근할 때 로드될 수 있다. 경로 범위 규칙은 한 관심사가 여러 디렉터리에 걸치는 경우를 다룬다. 둘 다 불필요한 컨텍스트를 줄이지만 실제 런타임의 로딩·매칭·우선순위를 이해해야 한다.
기능에 따라 분류해야 한다. 프로젝트 사실과 판단이 필요한 관례는 맥락에, 반복 다단계 작업은 스킬에, 금지 행동은 권한·차단 검사·더 강한 시스템 격리에 둔다. 긴 세션, 충돌과 적대적 텍스트는 준수에 영향을 준다. 정책 문장의 존재는 집행률의 증거가 아니다.
훅이 항상 시작돼도 결정까지 결정론적인 것은 아니다
모델은 지속 지침, 범위 규칙과 스킬 절차를 해석한다. 훅은 모델이 체크리스트를 기억할 때까지 기다리지 않고 구성된 이벤트에 런타임이 시작한다는 점이 다르다. PreToolUse 검사는 실행 전 도구 호출을 검사하고 명령이 정책을 어기면 차단 결과를 반환할 수 있다.
그러나 결정 방식은 핸들러가 정한다. 명령 핸들러는 스크립트를 실행하고 프롬프트·에이전트 핸들러는 모델 판단을 사용할 수 있다. 안정적으로 시작되는 훅도 확률적 결론을 낼 수 있다. 소프트웨어가 직접 평가할 수 있는 조건은 다른 모델의 의견보다 명령 기반 검사에 더 적합하다.
생성 파일에 대해서는 지침이 편집하지 않는 이유를 설명하고, 대상 인식 사전 검사가 금지 쓰기를 거절할 수 있다. 배포 스킬은 승인 경로를 설명하고 권한이나 훅은 직접 지름길을 막을 수 있다. 설명과 장벽은 서로 다른 문제를 해결하기 때문에 보완한다.
권한에는 도구·명령 허용과 거부 규칙이 있으며 인용된 Claude Code 제어에서는 일치하는 거부가 허용보다 우선한다. 훅은 더 풍부한 조건을 살필 수 있지만 도구 허용이나 검사 성공이 운영체제 전체 접근을 뜻해서는 안 된다. 중대한 결과에는 제한된 자격 증명, 컨테이너, 보호 브랜치와 읽기 전용 마운트가 여전히 필요하다.
편집 후 자동화도 비례해야 한다. 포매터나 집중 검증은 매번 저렴하게 돌릴 수 있지만 전체 테스트를 매 편집마다 실행하면 작업을 막는다. 큰 검사는 커밋이나 완료에 둘 수 있다. 중지 훅이 유용한 진행 경로 없이 계속 작업만 요구하면, 관문이 비싼 반복 루프로 변한다.
제어 평면도 피해를 줄 수 있는 코드로 검토해야 한다
훅은 실행 가능한 인프라다. 결함 스크립트는 데이터를 유출하고 정상 작업을 막으며 모든 일치 이벤트를 느리게 할 수 있다. 리포지토리 소유는 유지 책임을 주지만 낯선 리포지토리 구성을 신뢰할 수 있게 만들지는 않는다. 작업공간 신뢰, 검토와 격리 실행이 중요하다.
변경 가능성은 또 다른 경계 문제다. 에이전트가 자신을 제약하는 파일도 편집할 수 있으면 일상 변경이 근처 규칙을 약화하거나 검사를 끌 수 있다. 중요한 설정은 스스로 제한을 지킬 의지보다 강한 소유·검토, 보호 브랜치나 읽기 전용 실행을 필요로 한다.
명령 패턴 차단은 같은 효과를 내는 패키지 작업, 간접 스크립트나 다른 도구를 놓칠 수 있다. 테스트는 원래 예만 재생하지 말고 다른 경로로 금지 행동을 시도해야 한다. 정상 작업도 시험해야 한다. 과도한 거부는 예외, 우회나 전체 비활성화를 유도한다.
신뢰할 수 없는 이슈, 문서, 의존성과 생성물에는 프롬프트 인젝션이 있을 수 있다. 모델은 이를 리포지토리 지침과 함께 해석할 수 있다. 결정론적 권한과 격리 실행은 가능한 능력을 제한한다. 산문만으로 그 보안 경계를 만들 수 없다.
스킬은 관리하고 활성화할 때만 절차를 보존한다
스킬은 릴리스, 마이그레이션, 의존성 업그레이드, 인시던트 지식을 한 엔지니어의 채팅 밖에서 검토 가능하게 한다. 저장소 소유 검증기가 결정론적 하위 작업을 맡고 에이전트가 판단을 맡을 수 있다. 검색 가능한 엔지니어링 지식 베이스는 근거 결정과 문서를 보존하고, 스킬은 선택 지식이 절차가 되는 방법을 정한다.
존재가 활성화는 아니다. 설명은 적용 시점을 밝혀야 하고 평가에서는 올바른 절차가 실제로 로드되는지 확인해야 한다. 민감 작업은 명시 호출로 모호함을 줄일 수 있다. 명령과 아키텍처도 변하므로 담당자·예시·검토 주기는 선택적 장식이 아닌 유지 요건이다.
루트, 여러 범위 파일과 다수 스킬에 규칙을 복제하면 서로 다른 권위가 생긴다. 사실마다 주된 위치 하나를 두고 다른 곳에 링크나 짧은 색인을 두면 변경을 검토하기 쉽다. 개인 구성과 조직 관리 설정도 리포지토리 기대와 충돌할 수 있다. 어떤 파일이 로드되고 어떤 규칙·권한이 작업에 작용했는지 보여야 한다.
이식성과 거버넌스는 행동으로 입증해야 한다
다른 코딩 에이전트도 비슷한 지침·워크플로·이벤트 제어 개념을 제공하지만 디렉터리와 의미가 다르다. 재사용 컨텍스트에 대한 Tessl의 제품상 이해관계가 정확한 Claude Code 경로를 이식 표준으로 만들지는 않는다. 공유 Markdown도 트리거·범위·우선순위·차단 동작을 보존해야 의미 있는 이식성이다.
반복 평가는 깨끗한 환경에서 시작해 여러 실행에 같은 작업을 주고 로드된 구성, 도구 결정과 결과를 기록해야 한다. 준수, 올바른 스킬 활성화, 금지 작업 차단과 일반 작업 성공을 확인해야 한다. 설득력 있는 시연 한 번보다 독립적 반복이 중요하다.
세 가지 발전이 프레임워크를 강화할 수 있다. 실용적 지침 평가, 런타임 간 의미가 정확한 기능 형식, 안내·보장된 트리거·실제 거부를 구분하는 인터페이스다. 로그는 허용·거절 이유를 이해하게 해야 한다. 파일 수와 문서 크기는 이 결과를 대체하지 못한다.
유용한 결과물은 설명 가능한 제어 지도다. 다른 엔지니어가 결정을 안내하는 맥락, 필요할 때 등장하는 절차, 중대한 실수를 멈출 외부 경계를 찾을 수 있어야 한다. 팀 소유 파일은 지도를 검토하고 복구하게 한다. 안전한 자율성은 여전히 시험된 집행과 주변 인프라에 달렸다.
출처와 관련 읽기
Tessl 네 계층 프레임워크 · Anthropic 지침 · 프로젝트 메모리와 로딩 · 훅 핸들러 안내 · 도구 권한 · 스킬 구성과 호출 · 관련 읽기: 검색 가능한 엔지니어링 지식 베이스