my-claude-code-setup
무엇인가
Claude Code 프로젝트에 넣는 스타터 설정 묶음으로, 코드베이스 규칙·작업 절차·축적된 결정을 파일 단위로 분리해 에이전트가 매 세션 참조하게 만든다. 규율 대상은 컨텍스트 보존 방식, 도구 사용 순서, 프로젝트별 금지·허용 동작이다.
어떻게 동작하나
핵심은 CLAUDE.md를 단일 문서가 아니라 메모리 뱅크로 운용하는 구조다. CLAUDE.md가 진입점 역할을 하고, CLAUDE-patterns.md·CLAUDE-decisions.md·CLAUDE-troubleshooting.md 같은 보조 파일에 패턴·ADR·트러블슈팅 기록이 누적된다. .claude/settings.json의 훅과 슬래시 명령이 실행 시점을 걸고, `update memory bank` 같은 지시로 에이전트가 해당 파일들을 갱신한다. 2026년 5월 갱신으로 CLAUDE-template-1~3.md 세 가지 변형이 추가되어 이중 메모리 구조와 점진적 공개 방식을 따른다.
무엇과 다른가
프롬프트를 매번 직접 작성하거나 단일 CLAUDE.md 한 장에 규칙을 몰아넣는 방식과 다르다. 규칙을 파일 계층으로 나누고, 세션 중 얻은 결정과 실패 기록을 다시 파일로 되돌리는 순환을 전제로 한다. Cloudflare·ClerkOS·Convex용 보조 참조 문서(CLAUDE-cloudflare.md, CLAUDE-convex.md 등)를 따로 두어 스택별 지식을 분리하는 점도 단일 규칙 파일과 구분된다.
어떻게 쓰나
저장소 파일을 프로젝트 디렉터리로 복사한 뒤 템플릿과 CLAUDE.md를 프로젝트에 맞게 수정한다. macOS가 아니면 .claude/settings.json을 제거한다. 프로젝트 디렉터리에서 Claude Code를 처음 실행하고 /init을 돌리면 에이전트가 코드베이스를 분석해 CLAUDE.md 지시에 따라 메모리 뱅크 파일을 채운다. 기존 사용자는 CLAUDE-migrate-to-new-template.md를 프롬프트로 써서 현재 CLAUDE.md를 새 템플릿으로 옮긴다.
전제와 한계
Claude Code 전용이며 다른 에이전트에는 그대로 적용되지 않는다. 유료 Claude 플랜이 전제이고 ripgrep·fd·jq 설치를 권장한다. .claude/settings.json은 macOS의 Terminal-Notifier에 의존한다. 메모리 뱅크 파일 내용은 /init과 이후 갱신 지시로 채워지므로, 프로젝트 규칙을 자동으로 추론해 주는 장치는 아니다.