jbarbier/CLAUDE.md

해결하는 문제

이 프로젝트는 Claude Code, Cursor, Gemini CLI와 같은 코드 에이전트를 위한 포괄적이고 주관적인 지침("계약")을 제공합니다. 에이전트가 평범한 행동(테스트를 건너뛰거나, 라이브러리를 임의로 만들거나, 스스로 처리해야 할 작업에 대해 허가를 요청하는 것 등)을 하지 않도록 하기 위해, 에이전트가 어떻게 생각하고, 코드를 작성하며, 소통해야 하는지를 규정하는 일관된 규칙 세트를 설정합니다.

작동 방식

이 프로젝트는 단일 파일인 CLAUDE.md 로 구성되어 있으며, 모든 세션 시작 시 모델의 컨텍스트에 로드됩니다. 이 파일은 에이전트의 기본 동작을 오버라이드하는 시스템 프롬프트 또는 지속적인 계약으로 작동합니다. 다양한 도구 간 호환성을 보장하기 위해 저자는 CLAUDE.md 를 AGENTS.md 또는 GEMINI.md 와 같은 심볼릭 링크로 연결함으로써, 여러 AI 코드 도구에 대해 하나의 단일 진실 소스를 유지하는 것을 제안합니다.

대상 사용자

AI 코드 에이전트를 사용하고 있으며, 엄격한 운영 지침을 제공함으로써 더 높은 품질의, 예측 가능한 출력을 원하는 개발자.

주요 특징

• 다중 도구 호환성: 표준화된 이름 규칙과 심볼릭 링크를 통해 Claude Code, OpenAI Codex CLI, Cursor, Gemini CLI를 지원합니다.
• 코드화된 브랜치 규칙: 여러 에이전트 세션이 동일한 리포지토리에서 충돌하지 않도록 git worktrees 를 관리하는 검증된 쉘 명령어를 포함합니다.
• 다중 에이전트 워크플로우: 고품질 출력을 위한 "팬아웃 + 엄격한 비판" 루프와 반복적 개선을 위한 자체 평가 규칙을 포함합니다.
• 모듈식 설계: 작업 크기, 안전성, 완료 상태 등의 섹션으로 나누어진 지침으로, 사용자는 특정 프로젝트 요구사항과 스택에 따라 삭제하거나 유지할 수 있습니다.
• 검증된 명령어: 지침 내에 포함된 쉘 명령어가 기능적으로 올바른지 확인하기 위한 테스트 스위트가 리포지토리에 포함되어 있습니다.