Claude Soul

claude-soul

Claude Code 커스텀 설정 백업 (~/.claude 원천 동기화)

빠른 개발보다 안전한 개발을 우선하도록 설계되었습니다.
가드레일로 인해 동작이 일부 제한될 수 있으며, 업무용에 더 적합합니다.
특히 Kotlin + WebFlux 기반 백엔드 개발 환경을 기준으로 설계되었으며, 다른 환경에서 쓸 경우 프롬프트와 rule 구성을 검수 후 사용하는 것을 권장합니다.
사내 정보(도메인·프로젝트 키·사내 전용 스킬·토큰)는 제거하고 예시 값으로 치환했습니다.

철학

- 보안 중심 설계 — 외부 저장소/인프라에 영향을 줄 수 있는 작업은 차단하고 read-only 커맨드만 허용한다.
- 중단 없는 실행 — ask를 지양하고 allow/deny로 즉시 판단해서, 작업이 중단 없이 끝까지 수행되도록 한다.
- 환경이 강제하는 검증 — 사람이 기억해야 지켜지는 규칙보다, 안 지키면 훅/CI가 막는 구조를 우선한다 (rules/09-persona.md R1).
- 가드레일은 플러그인으로 분리 — 실행 로직은 guardrail 플러그인이 관리하고, 이 레포는 개인 정책 policy.json만 들고 있다.
- 시크릿 분리 관리 — 민감 정보는 git-ignored된 settings.local.json에서 관리한다.

구성

rules/*.md는 CLAUDE.md 하단의 @rules/... import로 프롬프트에 로드된다. CLAUDE.md만 깔고 rules/를 빼면 룰이 하나도 적용되지 않는다.

원천 환경에서는 ruler가 ~/.config/ruler/*.md를 합쳐 ~/.claude/CLAUDE.md 단일 파일을 만든다. ruler를 쓰지 않아도 위 import 방식으로 동일하게 동작한다.

Rules

persona 문서가 뭔지: 이 사용자가 코드 리뷰·설계 논의에서 반복적으로 지적하고 거절해 온 것들을 정리한 문서다. "미니멀이 기본", "확장성보다 파괴 용이성", "AI 주장 대신 실행 흔적" 같은 판단 기준을 매번 다시 설명하지 않기 위해 있다.
rules/09-persona.md는 프롬프트에 항상 로드되는 규칙 요약이고, persona/PERSONA-FULL.md는 그 규칙이 어떤 지적에서 나왔는지 담은 원본이다 — 교정·반박 사례, 반복 표현, 안 하는 것 목록, 이상(선언한 규칙) vs 실제(행동으로 드러난 것) 대조. 설치 위치 ~/.claude/persona/PERSONA-FULL.md.

Guardrails

가드레일 차단 로직은 이 레포에 없다. guardrail@lauvsong 플러그인이 담당하고, settings.json에 설치 선언만 들어있다.

주요 차단 대상:

- 외부 Write 작업 — git push, PR 생성 등
- Claude 설정 파일 접근/수정 — self-modification 및 권한 상승 방지
- 시크릿 파일 접근 — .env, *.key, ~/.ssh, ~/.aws 등
- 차단 우회 명령어 — eval, sh -c, base64 -d 등
- 컨텍스트 폭식 명령 — cat/head/tail 원본 덤프, 최상위 grep/find/ls -R (Read·Glob·rtk 사용 유도)

settings.json의 deny 설정으로도 차단할 수 있지만 미동작 버그(#8961)로 쓰지 않는다.

bypassPermissions: true 설정 시 PreToolUse 훅이 비동기로 동작하면서
exit code 2 기반 차단이 정상 적용되지 않는 문제가 있다.
일부 차단 로직이 우회될 수 있으므로 bypassPermissions 옵션은 쓰지 않는 것을 권장한다.
관련 이슈: #20946,…