팀 도입 워크플로

개인이 잘 쓰는 것과 팀이 잘 쓰는 것은 완전히 다른 문제입니다. 후자는 공유 자산을 만드는 일입니다.

1단계 — 공통 기반 만들기 (1주)

가장 먼저 저장소에 커밋할 것들입니다.

CLAUDE.md                  ← 프로젝트 지침
.claude/settings.json      ← 권한 규칙 (금지 명령 포함)
.claude/commands/          ← 표준 슬래시 명령어
.claude/skills/            ← 사내 절차

이 단계의 목표는 "팀원 누구나 클론하면 같은 환경" 입니다.

2단계 — 검증 자동화 (2주)

에이전트가 자율적으로 일하려면 스스로 확인할 수단이 필요합니다.

npm run typecheck   # 타입 오류
npm run test        # 동작
npm run lint        # 스타일

세 명령이 한 줄로 돌아가지 않는다면 그것부터 고치세요. 이게 없으면 나머지 투자는 효과가 절반입니다.

3단계 — 안전 경계 설정 (1주)

자율 실행 범위를 넓히려면 사고 가능성을 먼저 없애야 합니다.

{
  "permissions": {
    "deny": [
      "Bash(rm -rf:*)",
      "Bash(git push --force:*)",
      "Read(./.env*)"
    ]
  }
}

훅으로 강제하면 더 확실합니다. 규칙이 있으면 팀원들이 더 과감하게 씁니다. 제약이 자유를 만듭니다.

4단계 — 지식 순환 만들기 (지속)

가장 중요하고 가장 자주 빠뜨리는 단계입니다.

• 주간 공유 — "이번 주에 잘 먹힌 지시" 5분 공유
• Skill 기여 — 같은 작업을 세 번 반복한 사람이 Skill로 만듦
• 지침 갱신 — 반복되는 리뷰 지적을 CLAUDE.md에 반영

이 순환이 없으면 3개월 뒤 설정 파일이 낡아 아무도 안 봅니다.

도입 시 흔한 실패

측정할 것

사용량이 아니라 결과를 봐야 합니다.

• PR 리드 타임 (작성 → 머지)
• 리뷰 왕복 횟수
• 버그 재발률
• 신규 인력 온보딩 기간

비개발 직군까지 넓히기

문서 정리, 데이터 변환, 리포트 생성처럼 파일을 다루는 일이면 코드가 아니어도 됩니다. 다만 진입 장벽이 다릅니다.

• 터미널 대신 데스크톱 앱으로 시작
• Git 대신 폴더 백업으로 되돌리기
• 첫 과제는 "결과를 즉시 눈으로 확인할 수 있는 일"

정리

팀 도입의 본질은 도구 배포가 아니라 암묵지를 공유 자산으로 바꾸는 작업입니다. 설정 파일과 Skill은 그 결과물입니다.

다음 레슨

Claude Cowork 기본 이해하기