🤖 03. 운영스택

Claude Code를 팀에서 오래 쓰면, 성능 차이는 모델보다 운영 스택에서 갈립니다. 특히 Skills(작업 표준화) → Memory(맥락 유지) → Teams(병렬 협업) 순서로 올려야 재작업률이 줄어듭니다.

flowchart LR
  A[Skills: 출력 표준화] --> B[Memory: 맥락 누적]
  B --> C[Subagents/Teams: 병렬화]
  C --> D[운영 지표 개선]

🧠 칠판 치트시트

• Skills 없이 Teams를 먼저 열면 출력 품질 편차가 커진다
• Memory 없이 장기 작업을 돌리면 같은 설명을 반복한다
• Teams는 마지막 단계에서 켜야 비용 대비 효율이 난다

1) Skills: 먼저 표준을 고정한다

공식 문서 기준으로 Skills는 반복 작업을 재사용 가능한 실행 단위로 만드는 방법입니다.
참고: https://code.claude.com/docs/en/skills

실무에서는 아래 3개부터 고정하면 효과가 빠릅니다.

• PR 리뷰 포맷
• 배포 체크리스트 포맷
• 장애 보고 포맷

바로 쓰는 예시 (skill 호출형 프롬프트)

/review-pr
PR #142를 정확성/성능/보안/운영성 4축으로 점검하고,
즉시 수정 3개와 보류 2개를 분리해줘.

2) Memory: 세션이 바뀌어도 팀 규칙을 유지한다

Claude Code 공식 Memory 문서에서 핵심은 두 가지입니다.

• CLAUDE.md: 사람이 쓰는 고정 운영 규칙
• Auto memory: Claude가 작업 중 학습해 누적하는 메모

참고: https://code.claude.com/docs/en/memory

최소 권장 구조

repo/
├─ CLAUDE.md
└─ .claude/
   └─ rules/
      ├─ code-style.md
      └─ release-checklist.md

CLAUDE.md 샘플

# 팀 운영 규칙
- PR 본문에 영향 범위/롤백 계획 필수
- 테스트 미통과 상태에서 merge 금지
- 장애 보고는 원인/영향/복구/재발방지 4항목 고정

메모리 스코프를 구분하면 충돌이 줄어든다

공식 문서 기준으로 CLAUDE.md는 위치별로 우선순위가 다릅니다.

• 조직 공통: /etc/claude-code/CLAUDE.md(Linux/WSL)
• 프로젝트 공통: ./CLAUDE.md 또는 ./.claude/CLAUDE.md
• 개인 전역: ~/.claude/CLAUDE.md
• 개인 프로젝트 로컬: ./CLAUDE.local.md

또한 auto memory는 ~/.claude/projects/<project>/memory/에 저장되고, MEMORY.md의 앞 200줄이 세션 시작 시 로드됩니다.

.claude/rules로 파일별 규칙 분리

큰 저장소에서는 조건부 규칙이 효율적입니다.

---
paths:
  - "src/api/**/*.ts"
---
 
# API 규칙
- 모든 엔드포인트는 입력 검증 필수
- 표준 에러 포맷 준수

3) 병렬화: Subagents 먼저, Agent Teams는 그다음

공식 문서 기준으로,

• Subagents: 단일 세션 안에서 역할 분리 (비용/복잡도 낮음)
• Agent Teams: 독립 세션 다중 협업 (유연하지만 비용/조율비용 큼)

참고:

• https://code.claude.com/docs/en/sub-agents
• https://code.claude.com/docs/en/agent-teams

Agent Teams 활성화 예시

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

4) 도입 순서가 중요한 이유 (실전 사례)

사례 A: Teams부터 시작한 팀 (실패)

처음부터 팀 병렬화를 켰다가, 포맷/규칙이 제각각이라 리드가 결과를 다시 정리하느라 시간이 더 들었습니다.

사례 B: Skills→Memory 후 Teams 도입 (성공)

기본 출력 템플릿과 CLAUDE.md를 먼저 고정하고 병렬화를 붙이자, 결과 통합 속도가 빨라지고 재작업률이 줄었습니다.

5) 20분 도입 루틴

1. 7분: 자주 반복되는 산출물 2개를 Skills 후보로 선정
2. 6분: CLAUDE.md에 운영 규칙 5줄만 고정
3. 7분: Subagent 1개를 만들어 작은 병렬 작업 테스트

완료 기준:

• 같은 작업을 다시 시켰을 때 출력 포맷이 유지된다
• 세션이 바뀌어도 팀 규칙이 유지된다

운영 체크리스트

• Skills 2개 이상을 실제 작업에 재사용 중인가?
• CLAUDE.md가 200줄 이내 핵심 규칙 중심인가?
• Subagents와 Agent Teams 사용 기준을 팀이 합의했는가?

다음 읽기

• 🤖 04. 팀협업
• 🤖 05. GitHub
• 🤖 08. 비용운영

생성형 AI 활용 고지

이 문서는 Claude Code 공식 문서를 바탕으로 생성형 AI를 활용해 정리했으며, 최종 공개 전 사람이 검토·보정했습니다.