CCJK와 팀 협업: 공유 AI 워크플로우

여러 개발자가 AI 어시스턴트를 사용할 때 일관성이 중요해집니다. CCJK는 팀 협업을 위한 강력한 기능을 제공하여 모든 사람이 동일한 패턴과 사례를 따르도록 보장합니다.

팀 구성 설정

프로젝트 수준 구성

리포지토리에 공유 구성을 생성하세요:

hljs yaml
# .claude/config.yaml
version: "1.0"
team: "your-team-name"

# 공유 모델 설정
model:
  default: claude-sonnet-4-20250514
  fallback: claude-haiku

# 프로젝트 컨텍스트
context:
  description: |
    다음으로 구축된 전자상거래 플랫폼:
    - Next.js 14 (App Router)
    - TypeScript (strict 모드)
    - PostgreSQL + Prisma
    - 캐싱을 위한 Redis
    - Tailwind CSS

  conventions:
    - 훅과 함께 함수형 컴포넌트 사용
    - Airbnb 스타일 가이드 준수
    - 모든 비즈니스 로직에 테스트 작성
    - Conventional commits 사용

# 공유 무시 패턴
ignore:
  - node_modules/
  - .next/
  - coverage/
  - "*.log"
  - .env*

팀 권한

팀원이 수행할 수 있는 작업을 정의하세요:

hljs yaml
# .claude/permissions.yaml
roles:
  developer:
    read: ["src/**", "tests/**", "docs/**"]
    write: ["src/**", "tests/**"]
    execute: ["npm test", "npm run lint", "npm run build"]

  senior:
    extends: developer
    write: ["src/**", "tests/**", "config/**"]
    execute: ["npm run migrate", "npm run deploy:staging"]

  lead:
    extends: senior
    write: ["**"]
    execute: ["**"]

# 팀원의 기본 역할
default_role: developer

공유 스킬 라이브러리

팀 스킬 생성

팀별 스킬 라이브러리를 구축하세요:

hljs yaml
# .claude/skills/team/create-feature.yaml
name: create-feature
description: 팀 규칙에 따라 새 기능 생성
version: 1.0.0
author: Team Lead

parameters:
  - name: name
    description: 기능 이름 (kebab-case)
    required: true
    pattern: "^[a-z][a-z0-9-]*$"

  - name: type
    description: 기능 유형
    default: page
    options: [page, component, api, service]

prompt: |
  팀 규칙에 따라 "{{name}}"이라는 {{type}} 기능을 생성하세요:

  프로젝트 구조:
  - 페이지는 src/app/에
  - 컴포넌트는 src/components/에
  - API 라우트는 src/app/api/에
  - 서비스는 src/services/에

  요구 사항:
  - strict 타입의 TypeScript
  - 단위 테스트 포함
  - Storybook 스토리 추가 (컴포넌트의 경우)
  - 코드베이스의 기존 패턴 준수

  일관성을 위해 유사한 기존 기능을 참조하세요.

스킬 카테고리

목적별로 스킬을 구성하세요:

.claude/skills/
├── team/
│   ├── create-feature.yaml
│   ├── create-api-endpoint.yaml
│   └── create-component.yaml
├── review/
│   ├── code-review.yaml
│   ├── security-review.yaml
│   └── performance-review.yaml
├── docs/
│   ├── api-docs.yaml
│   ├── component-docs.yaml
│   └── readme-update.yaml
└── testing/
    ├── unit-test.yaml
    ├── integration-test.yaml
    └── e2e-test.yaml

새 팀원 온보딩

자동화된 설정

온보딩 스킬을 생성하세요:

hljs yaml
# .claude/skills/team/onboard.yaml
name: onboard
description: 새 팀원을 위한 개발 환경 설정

steps:
  - name: "환경 확인"
    prompt: |
      개발 환경을 확인하세요:
      - Node.js 18+ 설치됨
      - npm 또는 pnpm 사용 가능
      - Git 구성됨
      - 필요한 VS Code 확장 프로그램

  - name: "프로젝트 설정"
    commands:
      - "npm install"
      - "cp .env.example .env.local"
      - "npm run db:setup"

  - name: "코드베이스 투어"
    prompt: |
      코드베이스 투어를 제공하세요:
      - 프로젝트 구조 개요
      - 주요 디렉토리와 그 목적
      - 중요한 구성 파일
      - 개발 워크플로우

  - name: "첫 번째 작업"
    prompt: |
      새 팀원을 위한 좋은 첫 작업을 제안하세요:
      - 작고 잘 정의된 것
      - 코드베이스의 여러 부분을 다루는 것
      - 명확한 수락 기준이 있는 것

지식 베이스

팀 지식 베이스를 생성하세요:

hljs yaml
# .claude/knowledge/architecture.yaml
topic: architecture
content: |
  ## 시스템 아키텍처

  ### 프론트엔드
  - App Router를 사용하는 Next.js 14
  - 데이터 가져오기를 위한 React Server Components
  - 상호작용을 위한 클라이언트 컴포넌트
  - 스타일링을 위한 Tailwind CSS

  ### 백엔드
  - Next.js의 API 라우트
  - 데이터베이스 액세스를 위한 Prisma ORM
  - 세션 및 캐시를 위한 Redis
  - BullMQ를 사용한 백그라운드 작업

  ### 인프라
  - 프론트엔드 호스팅을 위한 Vercel
  - PostgreSQL을 위한 AWS RDS
  - Redis를 위한 AWS ElastiCache
  - CDN을 위한 CloudFlare

코드 리뷰 워크플로우

표준화된 리뷰

일관된 리뷰 프로세스를 생성하세요:

hljs yaml
# .claude/skills/review/pr-review.yaml
name: pr-review
description: 팀 표준에 따른 포괄적인 PR 리뷰

checklist:
  code_quality:
    - "TypeScript 모범 사례 준수"
    - "정당화 없는 any 타입 없음"
    - "적절한 오류 처리"
    - "console.log 문 없음"

  testing:
    - "새 함수에 대한 단위 테스트"
    - "API 변경에 대한 통합 테스트"
    - "테스트 커버리지 유지 또는 개선"

  security:
    - "하드코딩된 비밀 없음"
    - "입력 유효성 검사 존재"
    - "SQL 인젝션 방지"
    - "XSS 방지"

  documentation:
    - "공개 함수에 JSDoc"
    - "필요한 경우 README 업데이트"
    - "엔드포인트에 대한 API 문서 업데이트"

  performance:
    - "N+1 쿼리 없음"
    - "적절한 캐싱"
    - "번들 크기 영향 고려"

output_format: |
  ## PR 리뷰: {{pr_title}}

  ### 요약
  {{summary}}

  ### 체크리스트 결과
  {{checklist_results}}

  ### 발견된 문제
  {{issues}}

  ### 제안 사항
  {{suggestions}}

  ### 승인 상태
  {{status}}

리뷰 할당

hljs yaml
# .claude/workflows/review-assignment.yaml
name: review-assignment
trigger: pr_opened

rules:
  - condition: "files.any(f => f.path.startsWith('src/api/'))"
    reviewers: ["backend-team"]

  - condition: "files.any(f => f.path.startsWith('src/components/'))"
    reviewers: ["frontend-team"]

  - condition: "files.any(f => f.path.includes('security'))"
    reviewers: ["security-team"]
    required: true

공유 프롬프트 및 템플릿

프롬프트 라이브러리

hljs yaml
# .claude/prompts/debugging.yaml
name: debug-production-issue
description: 프로덕션 디버깅에 대한 체계적 접근

template: |
  프로덕션 문제가 보고되었습니다:

  **문제**: {{issue_description}}
  **영향**: {{impact_level}}
  **최초 보고**: {{timestamp}}

  이 문제를 디버그하는 데 도움을 주세요:

  1. **정보 수집**
     - 오류 로그 확인
     - 최근 배포 검토
     - 영향받은 사용자/요청 식별

  2. **가설 형성**
     - 가능한 원인 나열
     - 가능성별로 순위 지정

  3. **조사**
     - 각 가설에 대해 확인 방법 설명
     - 진단 쿼리/명령 제안

  4. **수정 제안**
     - 즉각적인 완화
     - 장기 솔루션
     - 예방 조치

응답 템플릿

hljs yaml
# .claude/templates/api-response.yaml
success:
  status: 200
  body:
    success: true
    data: "{{data}}"
    meta:
      timestamp: "{{timestamp}}"
      requestId: "{{requestId}}"

error:
  status: "{{statusCode}}"
  body:
    success: false
    error:
      code: "{{errorCode}}"
      message: "{{userMessage}}"
    meta:
      timestamp: "{{timestamp}}"
      requestId: "{{requestId}}"

메트릭 및 분석

사용 추적

hljs yaml
# .claude/analytics.yaml
tracking:
  enabled: true
  anonymous: true  # 개인 데이터 없음

metrics:
  - skill_usage        # 가장 많이 사용되는 스킬
  - task_completion    # AI 작업의 성공률
  - time_saved         # 예상 시간 절약
  - error_rate         # AI 제안 오류율

reports:
  weekly:
    recipients: ["team-lead@company.com"]
    include: [skill_usage, task_completion]

  monthly:
    recipients: ["engineering@company.com"]
    include: [all]

팀 대시보드

팀 AI 사용 추적:

┌─────────────────────────────────────────────────────────┐
│                  CCJK 팀 대시보드                        │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  이번 주 통계                                            │
│  ─────────────────                                       │
│  완료된 작업: 147개                                      │
│  사용된 스킬: 23개 (고유)                                │
│  절약된 시간: ~18시간                                    │
│  성공률: 94%                                             │
│                                                          │
│  상위 스킬                                               │
│  ──────────                                              │
│  1. /review      - 45회 사용                             │
│  2. /test        - 38회 사용                             │
│  3. /commit      - 32회 사용                             │
│  4. /docs        - 18회 사용                             │
│  5. /refactor    - 14회 사용                             │
│                                                          │
│  팀원                                                    │
│  ────────────                                            │
│  Alice: 42개 작업 | Bob: 38개 작업 | Carol: 35개 작업   │
│                                                          │
└─────────────────────────────────────────────────────────┘

모범 사례

1. 버전 관리 구성

hljs bash
# 리포지토리에 포함
.claude/config.yaml
.claude/skills/**
.claude/prompts/**
.claude/knowledge/**

# 개인 설정 제외
.claude/local.yaml  # .gitignore에 추가

2. 정기적인 스킬 검토

팀 스킬에 대한 월간 검토 일정:

• 스킬이 여전히 관련이 있나요?
• 개선할 수 있나요?
• 채워야 할 공백이 있나요?

3. 문서화

팀의 AI 워크플로우를 문서화하세요:

• 공유 스킬 사용 방법
• 새 스킬을 만들어야 하는 시기
• 검토 및 승인 프로세스

4. 피드백 루프

AI 피드백을 위한 채널을 생성하세요:

• 무엇이 잘 작동하나요?
• 무엇을 개선해야 하나요?
• 새로운 스킬 요청

결론

CCJK와의 팀 협업은 AI 지원의 이점을 배가시킵니다. 구성, 스킬 및 모범 사례를 공유함으로써 개별 생산성 향상을 허용하면서 일관성을 보장합니다.

기본 공유 구성으로 시작한 다음 일반적인 요구 사항을 기반으로 팀의 스킬 라이브러리를 점진적으로 구축하세요.

다음: AI 지원 워크플로우를 자동화하기 위한 CI/CD 통합에 대해 알아보세요.