Expert Configurations: How Top Practitioners Use Claude Code

Superpowers(npx skills add superpowers)는 Jesse Storimer가 만든 오픈소스 플러그인으로, 아무것도 하지 않고 코드를 쓰려는 Claude를 멈추고 방법론을 따르게 강제한다.

핵심 스킬들:

핵심 메커니즘: Claude가 '뭔가를 만들려 한다'고 감지되면 자동으로 brainstorming → writing-plans → TDD/구현 흐름을 거친다. 코드를 바로 쓰는 게 아니라, 먼저 '당신이 진짜 원하는 게 뭔지' 소크라테스식으로 파악한다.

Token 효율성: 스킬은 호출될 때만 로드된다. 사용하지 않을 때의 오버헤드는 거의 없다.

커뮤니티에서 검증된 '첫날 설정' 목록:

{
  "model": "claude-opus-4-7",
  "env": {
    "ANTHROPIC_MODEL": "claude-opus-4-7"
  },
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(npm run typecheck)"
    ],
    "deny": [
      "Bash(git push --force *)",
      "Bash(rm -rf *)",
      "Read(.env)",
      "Read(.env.local)",
      "Read(.env.production)"
    ]
  },
  "hooks": {
    "PostToolUse": [{
      "matcher": "Write|Edit",
      "hooks": [{ "type": "command",
        "command": "jq -r '.tool_input.file_path // empty' | { read -r f; [ -n \"f\" ] && npx prettier --write \"f\" --ignore-unknown; } 2>/dev/null || true",
        "async": true }]
    }]
  }
}

9가지 변경사항 설명:

1. 모델 명시적 설정 (기본값에 의존하지 않음)
2. env에도 모델 설정 (일부 도구가 env에서 읽음)
3. 읽기 전용 git 명령 allowlist
4. 테스트/린트 자동 승인
5. force push deny
6. rm -rf deny
7. .env 파일 읽기 deny
8. PostToolUse 포맷터 훅
9. 포맷터 async 실행 (메인 흐름 비차단)

최고의 팀 CLAUDE.md는 한 번 쓰고 잊어버리는 문서가 아니다 — 팀의 AI 협업 경험이 누적되는 살아있는 문서다.

규칙 1: 실수가 생기면 즉시 추가하라 Claude가 잘못된 행동을 했다 → CLAUDE.md에 규칙 추가 → 다음 번에는 반복 안 함. 이 피드백 루프가 시간이 지날수록 팀의 Claude를 점점 강력하게 만든다.

규칙 2: 모든 팀원이 기여자 CLAUDE.md를 git에 커밋하고 PR 리뷰 대상에 포함시켜라. 한 사람의 파일이 아닌 팀의 집단 지식.

규칙 3: 중요한 것을 먼저 Claude는 파일을 위에서 아래로 읽으며 초반 내용에 더 집중한다. Do NOT 목록을 두 번째 섹션에 배치하라.

규칙 4: 코드 스니펫 대신 파일 참조 src/utils/validators.ts:1-30 형태로 참조. 스니펫은 코드가 변경되면 stale해진다.

커뮤니티 검증된 Do NOT 패턴:

## Do NOT
- Use `any` type — always fix the actual type error
- Use default exports — all exports must be named
- Modify `schema.prisma` directly — ask me first
- Leave `console.log` in production code
- Refactor code unrelated to the current task
- Create new DB migrations without confirmation
- Push to main without PR review

6개월 이상 Claude Code를 집중 사용한 개발자들에게서 공통적으로 나타나는 패턴:

패턴 1: 주간 CLAUDE.md 리뷰 매주 금요일, 그 주에 Claude가 반복적으로 잘못한 것을 CLAUDE.md에 추가한다. 처음에는 비어있던 Do NOT 목록이 몇 개월 후에는 팀의 가장 가치 있는 규칙 모음이 된다.

패턴 2: 복잡도 기반 모드 선택

• 1파일 버그 수정: Normal mode, 바로 시작
• 3-5파일 기능 추가: Plan mode, 계획 확인 후 구현
• 아키텍처 변경: Ultraplan + 멀티에이전트 검증

패턴 3: 스킬 라이브러리 구축 처음 6개월 동안 반복적으로 하는 작업(PR 생성, 릴리즈 노트, 마이그레이션 계획 등)을 하나씩 스킬로 만든다. 6개월 후에는 30분 걸리던 PR 작업이 5분이 된다.

패턴 4: 세션 시작 루틴 매 세션 시작에 !git log --oneline -5와 !git status를 자동 주입하는 SessionStart 훅을 설정한다. Claude가 항상 현재 상태를 파악하고 시작한다.

{
  "hooks": {
    "SessionStart": [{
      "matcher": "*",
      "hooks": [{
        "type": "command",
        "command": "echo '## 현재 상태'; git log --oneline -5 2>/dev/null; echo '---'; git status 2>/dev/null",
        "async": false
      }]
    }]
  }
}