단일 설정 파일로 12개 도구의 린트 규칙을 동기화하는 crag

Context

CI 워크플로우, pre-commit hook, AI 도구 설정 파일 등 다수의 설정 파일에 린트 규칙이 분산된 구조. 규칙 변경 시 모든 파일을 수동으로 수정해야 하는 비효율 발생. 설정 파일 간의 불일치로 인한 관리 포인트 증가 및 동기화 누락 문제.

Technical Solution

• 약 20줄 규모의 단일 governance.md 파일을 진실의 원천(Source of Truth)으로 정의하는 설계
• 하나의 소스 파일로부터 GitHub Actions, Husky, AI 에이전트 설정 등 12개의 하위 파일로 원자적 컴파일을 수행하는 방식
• 네트워크 통신이나 LLM 의존성 없이 로컬 프로세스만으로 작동하는 읽기 전용 컴파일 구조
• 입력값이 동일할 경우 바이트 단위로 일치하는 결과를 생성하는 결정론적(Deterministic) 출력 메커니즘
• CI 푸시마다 SHA 검증을 통해 설정 파일의 무결성을 보장하는 파이프라인 전략

Impact

• 약 500ms 이내에 12개 타겟 파이프라인 생성 완료
• Ubuntu, macOS, Windows 및 Node 18/20/22 환경에서 512개 테스트 통과
• 101개 OSS 저장소에서 4,400회 호출 시 크래시 0건 기록
• ship-ready governance 벤치마크에서 40/40 Grade A 달성

Key Takeaway

반복되는 설정 파편화를 제거하기 위해 단일 진실 공급원(Single Source of Truth)을 구축하고 이를 하위 설정으로 전파하는 컴파일러 패턴의 효율성 확인.