클로드 해커톤 우승자가 알려주는 클로드코드 잘 쓰는 방법

/tdd /refactor-clean /test-coverage

# Skill 구조 예시
~/.claude/skills/
  pmx-guidelines.md      # 프로젝트별 패턴
  coding-standards.md    # 언어 베스트 프랙티스
  tdd-workflow/          # README.md가 있는 다중 파일 스킬
  security-review/       # 체크리스트 기반 스킬

{
  "PreToolUse": [
    {
      "matcher": "tool == \"Bash\" && tool_input.command matches \"(npm|pnpm|yarn|cargo|pytest)\"",
      "hooks": [
        {
          "type": "command",
          "command": "if [ -z \"$TMUX\" ]; then echo '[Hook] Consider tmux for session persistence' >&2; fi"
        }
      ]
    }
  ]
}

/hookify

# Subagent 구조 예시
~/.claude/agents/
  planner.md               # 기능 구현 계획
  architect.md             # 시스템 설계 결정
  tdd-guide.md             # 테스트 주도 개발
  code-reviewer.md         # 품질/보안 검토
  security-reviewer.md     # 취약점 분석
  build-error-resolver.md  # 빌드 오류 해결
  e2e-runner.md            # E2E 테스트
  refactor-cleaner.md      # 불필요한 코드 제거

~/.claude/rules/
  security.md      # 하드코딩된 비밀 금지, 입력 검증
  coding-style.md  # 불변성, 파일 구조
  testing.md       # TDD 워크플로우, 80% 커버리지
  git-workflow.md  # 커밋 포맷, PR 프로세스
  agents.md        # Subagent 위임 시점
  performance.md   # 모델 선택, 컨텍스트 관리

# 마켓플레이스 추가
claude plugin marketplace add https://github.com/mixedbread-ai/mgrep
 
# Claude 열기, /plugins 실행, 새 마켓플레이스 찾기, 설치

# 활성화된 플러그인 예시
typescript-lsp@claude-plugins-official  # TypeScript 인텔리전스
pyright-lsp@claude-plugins-official     # Python 타입 체킹
hookify@claude-plugins-official         # 대화형 Hook 생성
mgrep@Mixedbread-Grep                   # ripgrep보다 나은 검색

git worktree add ../feature-branch feature-branch
# 이제 각 worktree에서 별도의 Claude 인스턴스 실행

tmux new -s dev
# Claude가 여기서 명령어 실행, detach/reattach 가능
tmux attach -t dev

mgrep "function handleSubmit"  # 로컬 검색
mgrep --web "Next.js 15 app router changes"  # 웹 검색

ralph-wiggum@claude-code-plugins       # 루프 자동화
frontend-design@claude-code-plugins    # UI/UX 패턴
commit-commands@claude-code-plugins    # Git 워크플로우
security-guidance@claude-code-plugins  # 보안 체크
pr-review-toolkit@claude-code-plugins  # PR 자동화
typescript-lsp@claude-plugins-official # TS 인텔리전스
hookify@claude-plugins-official        # Hook 생성
code-simplifier@claude-plugins-official
feature-dev@claude-code-plugins
explanatory-output-style@claude-code-plugins
code-review@claude-code-plugins
context7@claude-plugins-official       # 라이브 문서
pyright-lsp@claude-plugins-official    # Python 타입
mgrep@Mixedbread-Grep                  # 향상된 검색

{
  "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] },
  "firecrawl": { "command": "npx", "args": ["-y", "firecrawl-mcp"] },
  "supabase": {
    "command": "npx",
    "args": ["-y", "@supabase/mcp-server-supabase@latest", "--project-ref=YOUR_REF"]
  },
  "memory": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-memory"] },
  "sequential-thinking": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
  },
  "vercel": { "type": "http", "url": "https://mcp.vercel.com" },
  "railway": { "command": "npx", "args": ["-y", "@railway/mcp-server"] },
  "cloudflare-docs": { "type": "http", "url": "https://docs.mcp.cloudflare.com/mcp" },
  "clickhouse": { "type": "http", "url": "https://mcp.clickhouse.cloud/mcp" },
  "magic": { "command": "npx", "args": ["-y", "@magicuidesign/mcp@latest"] }
}

# ~/.claude.json의 projects.[path].disabledMcpServers에
disabledMcpServers: [
  "playwright",
  "cloudflare-workers-builds",
  "cloudflare-workers-bindings",
  "cloudflare-observability",
  "cloudflare-docs",
  "clickhouse",
  "AbletonMCP",
  "context7",
  "magic"
]

{
  "PreToolUse": [
    // 장시간 실행 명령어에 tmux 리마인더
    { "matcher": "npm|pnpm|yarn|cargo|pytest", "hooks": ["tmux reminder"] },
    // 불필요한 .md 파일 생성 차단
    { "matcher": "Write && .md file", "hooks": ["block unless README/CLAUDE"] },
    // git push 전 검토
    { "matcher": "git push", "hooks": ["open editor for review"] }
  ],
  "PostToolUse": [
    // Prettier로 JS/TS 자동 포맷
    { "matcher": "Edit && .ts/.tsx/.js/.jsx", "hooks": ["prettier --write"] },
    // 편집 후 TypeScript 체크
    { "matcher": "Edit && .ts/.tsx", "hooks": ["tsc --noEmit"] },
    // console.log 경고
    { "matcher": "Edit", "hooks": ["grep console.log warning"] }
  ],
  "Stop": [
    // 세션 종료 전 console.log 감사
    { "matcher": "*", "hooks": ["check modified files for console.log"] }
  ]
}

~/.claude/rules/
  security.md      # 필수 보안 체크
  coding-style.md  # 불변성, 파일 크기 제한
  testing.md       # TDD, 80% 커버리지
  git-workflow.md  # Conventional commits
  agents.md        # Subagent 위임 규칙
  patterns.md      # API 응답 포맷
  performance.md   # 모델 선택 (Haiku vs Sonnet vs Opus)
  hooks.md         # Hook 문서

~/.claude/agents/
  planner.md           # 기능 분해
  architect.md         # 시스템 설계
  tdd-guide.md         # 테스트 우선 작성
  code-reviewer.md     # 품질 검토
  security-reviewer.md # 취약점 스캔
  build-error-resolver.md
  e2e-runner.md        # Playwright 테스트
  refactor-cleaner.md  # 불필요한 코드 제거
  doc-updater.md       # 문서 동기화 유지