# 최종 챌린지 · 팀 확장 스택 설계서

> 훅·MCP·스킬·플러그인을 하나의 배포 가능한 스택으로 정리

- Canonical: https://learning.reopt.ai/courses/claude-code-automation/lessons/claude-code-automation-capstone
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/claude-code-automation/lessons/claude-code-automation-capstone

---

[자동화와 확장](/courses/claude-code-automation) 최종 챌린지 9 / 9

# 최종 챌린지 · 팀 확장 스택 설계서

훅·MCP·스킬·플러그인을 하나의 배포 가능한 스택으로 정리
실무 워크북 100 XP 18분

## 실무 워크북

지금 팀에서 문서로만 지켜지고 있는 규칙과 반복 절차를 모아, 다른 팀원이 그대로 설치하고 운영할 수 있는 확장 스택 설계서를 작성하세요.
작성 내용 자동 저장
결정적 규칙 인벤토리 필수
CLAUDE.md나 팀 위키에 반드시 지켜야 한다고 적힌 규칙을 모두 나열하고, 각각 규칙으로 표현 가능한지, 어느 이벤트에서 검사해야 하는지, 차단이 필요한지 로깅이면 충분한지를 정리하세요.

차단 훅 설계 필수
에이전트가 건드리면 안 되는 경로 세 개를 고르고 이를 막는 훅을 설계하세요. 이벤트, matcher와 if의 역할 분담, 종료 코드 2와 deny 결정 중 무엇을 쓸지, stderr에 어떤 피드백을 줄지 적으세요.

MCP 인벤토리와 예산 필수
연결된 서버를 범위·transport·인증 방식·도구 개수로 표로 만들고, ENABLE_TOOL_SEARCH 값과 alwaysLoad 대상을 정하세요. 적용 전후 /context 수치를 함께 기록하세요.

헤드리스 실행 경로 필수
CI에서 claude -p로 도는 작업 하나를 골라 대화형에서만 성립하는 의존을 모두 찾아내고, 각각을 어떤 사전 설정이나 훅으로 대체할지와 실패 시 fallback을 적으세요.

플러그인 패키징과 배포 필수
위 훅·스킬·MCP 설정 중 팀 전체가 써야 할 것을 플러그인 구조로 배치하고, 설치 scope, 마켓플레이스 운영 주체, claude plugin validate를 넣을 CI 단계, 제거 시 영향 범위를 적으세요.

완성도 점검 기준

- 결정성 항상 일어나야 하는 규칙이 프롬프트가 아니라 훅으로 내려가 있다.
- 권한 경계 조이는 일과 푸는 일이 훅과 퍼미션 규칙으로 정확히 나뉘어 있다.
- 예산 관리 컨텍스트 점유와 시작 지연을 수치로 측정하고 운영값으로 통제한다.
- 배포 가능성 다른 팀원이 설치·검증·제거할 수 있고 그 영향 범위가 문서화되어 있다.

설계서의 첫 버전은 규칙 하나와 서버 하나부터 적용하고, 실제로 막힌 사고와 줄어든 컨텍스트를 다음 개정의 근거로 남기세요.
산출물 완성 · 계속

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact