조직 전체에 AI 개발 규칙 공유

Source: Dev.to

중앙 집중식 규칙이 점진적 공개와 컨텍스트 인식 규칙 로딩을 통해 74.4 % 토큰 절감과 일관된 AI 동작을 달성한 방법.

AI 규칙 거버넌스 문제

팀의 모든 개발자는 개인 AI 규칙 파일을 보관하는 경향이 있습니다:

• 하나의 CLAUDE.md는 “항상 테스트를 작성하라”고 적혀 있습니다.
• 또 다른 파일은 “TypeScript strict mode를 사용하라”고 고집합니다.
• 세 번째는 지난 프로젝트에서 작동했던 것을 그대로 복사합니다.

AI 코딩 어시스턴트(Claude Code, Cursor, GitHub Copilot, Gemini)는 프로젝트와 사람마다 일관되지 않은 지시를 받게 됩니다. 그 결과는 다음과 같습니다:

• 부족한 지식 공유 – 모범 사례가 개인의 머리와 개인 설정 파일에만 존재합니다.
• 복사‑붙여넣기 혼란 – 규칙이 Slack을 통해 공유되고 즉시 변질됩니다.
• 온보딩 마찰 – 새로운 개발자는 “우리 팀은 AI를 어떻게 사용하는가”를 파악하는 데 며칠을 소비합니다.
• 토큰 낭비 – 현재 컨텍스트에 필요한 일부 규칙만 필요함에도 모든 규칙을 로드합니다.

대규모(수백 명의 개발자) 환경에서는 AI 도구가 받는 지시를 감사하기 어렵고, 보안 규칙을 일관되게 적용하거나 AI 개발 표준 준수를 측정하기가 힘듭니다.

진실의 단일 출처: 중앙 집중식 규칙

핵심 통찰은 간단합니다: 관련 있을 때만 로드되는, 단일 버전 관리된 AI 개발 규칙 저장소. 이는 모델을 과부하시키고 토큰을 낭비하는 것을 방지합니다.

점진적 공개

1. 컨텍스트 감지 – 프로젝트에서 언어 마커(package.json, pyproject.toml, go.mod)를 스캔합니다.
2. 키워드 매칭 – 프롬프트에서 작업‑특정 용어(예: test, security, refactor)를 분석합니다.
3. 배너 표시 – 현재 작업에 적용되는 규칙을 보여줍니다.
4. 규칙 적용 – AI는 관련 코딩 표준만 따릅니다.

4차원 규칙 구조 (MECE)

각 규칙은 정확히 하나의 차원에만 존재하므로 중복 없음과 일반 시나리오에 대한 완전한 커버리지를 보장합니다.

자동 감지 및 로드

설치 스크립트가 저장소를 검사하고 적절한 규칙 세트를 로드합니다.

# Language detection
pyproject.toml   → Load Python rules
package.json     → Load JavaScript/TypeScript rules
go.mod           → Load Go rules

# Framework detection
"fastapi" in dependencies   → Load FastAPI rules
"react"   in dependencies   → Load React rules

# Cloud detection
vercel.json                 → Load Vercel rules

측정된 영향

다양한 작업에 걸쳐 관련 규칙 파일만 로드함으로써 토큰 사용량이 크게 감소했으며 일관된 AI 동작을 제공했습니다.

설치

설치는 단일 명령으로 이루어지며 멱등성(idempotent)입니다 (여러 번 실행해도 안전합니다).

# Global installation (all projects)
curl -fsSL https://raw.githubusercontent.com/paulduvall/centralized-rules/main/install-hooks.sh | bash

# Project‑specific installation
curl -fsSL https://raw.githubusercontent.com/paulduvall/centralized-rules/main/install-hooks.sh | bash -s -- --local

시작하기

이 저장소는 MIT 라이선스 하에 오픈 소스입니다:

github.com/PaulDuvall/centralized-rules

별표를 눌러 주시고, 사용해 보시며, 변경 사항을 자유롭게 제안해 주세요.