크래그: 오픈소스 도구가 프로젝트 설정에서 통합 AI 에이전트 규칙을 생성합니다

Crag가 하는 일

Crag는 여러 AI 코딩 에이전트 규칙 파일 간의 구성 드리프트를 해결하는 오픈소스 도구입니다. 프로젝트의 기존 구성을 분석하여 통합된 거버넌스 파일을 생성한 다음, 이를 다양한 AI 에이전트가 필요로 하는 모든 특정 규칙 파일로 컴파일합니다.

해결하는 문제

여러 AI 코딩 에이전트를 사용하는 개발자들은 구성 관리 문제에 직면합니다. 소스에 따르면, 한 개발자가 4개 프로젝트에 걸쳐 12개의 규칙 파일(총 48개 파일)을 유지 관리했으며, 여기에는 다음이 포함됩니다:

• Claude Code용 CLAUDE.md
• Codex용 AGENTS.md
• Cursor용 .cursor/rules/
• Copilot용 copilot-instructions.md
• 규칙을 강제하는 CI 워크플로우

이러한 파일들은 시간이 지나면서 드리프트되어, 린트 규칙이 일치하지 않아 CI가 거부하는 코드를 에이전트들이 작성하는 문제를 일으켰습니다. 이 문제는 "아무도 12개 파일을 모두 읽지 않기 때문에" 눈에 띄지 않았습니다.

Crag의 작동 방식

이 도구에는 두 가지 주요 명령어가 있습니다:

• crag analyze는 CI 워크플로우, package.json, tsconfig, 테스트 구성을 포함한 프로젝트 구성을 읽습니다.
• crag compile --target all은 통합 거버넌스 파일에서 모든 규칙 파일을 생성합니다.

분석 결과 약 80줄의 governance.md 파일이 생성되며, 여기에는 다음이 포함됩니다:

• 게이트
• 아키텍처 지침
• 테스트 프로필
• 코드 스타일 규칙
• 피해야 할 안티패턴
• 프레임워크 컨벤션

출력물은 "자동 생성되었지만, 시니어 엔지니어가 작성한 것처럼 읽힌다"고 설명됩니다.

기술적 세부사항

Crag에는 몇 가지 주목할 만한 기술적 특징이 있습니다:

• LLM이 필요하지 않음
• 네트워크 종속성 없음
• 제로 종속성
• 결정론적 출력
• 플랫폼 간 SHA 검증

사용해 보려면: npx @whitehatd/crag demo (@와 whitehatd 사이의 공백 제거)

소스 및 이용 가능성

이 도구는 오픈소스이며 GitHub에서 이용 가능합니다: https://github.com/WhitehatD/crag.