개념 - 규칙 파일 계층¶
정의¶
규칙 파일 계층은 CLAUDE.md, prompt_plan.md, spec.md, verification.md, rules/ 아래 파일들처럼 세션마다 자동으로 읽히거나 /sync로 정렬되는 문서 집합을 뜻합니다. 이 계층은 작업 기억, 코딩 규범, 보안/검증 규칙을 코드 바깥의 문서 계약으로 유지합니다.
왜 중요한가¶
claude-forge에서 규칙 파일은 단순 참고 문서가 아니라 에이전트, 슬래시 커맨드, 훅이 같은 기준으로 움직이게 만드는 공통 제어면입니다. 명령 체인만 있고 규칙 계층이 약하면 워크플로가 반복될수록 일관성이 깨지고, 반대로 규칙 계층이 살아 있으면 팀 단위 작업에서도 판단 기준이 안정적으로 유지됩니다.
관련 소스¶
관련 개념¶
- 개념 - 검증 우선 워크플로
- 개념 - 슬래시 커맨드 워크플로
- 개념 - 에이전트 개발 환경
- 개념 - 자동화 훅
- 엔티티 - Claude Forge
- 엔티티 - session-wrap
- 비교 - 수동 문서 동기화 vs /sync
- 비교 - 검증 우선 워크플로 vs 속도 우선 워크플로
메모¶
rules/는 코딩 스타일과 워크플로 규칙을 세션 시작부터 자동으로 주입하는 레이어에 가깝습니다./sync가 중요한 이유도 개별 문서를 복사하는 데 있지 않고, 규칙 계층과 프로젝트 문서를 같은 현실로 맞추는 데 있습니다.verification.md처럼 특정 규칙 파일이 워크플로 전체의 완료 기준을 직접 바꾸는 사례가 있습니다.