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

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

Workbook 100 XP 18 min

실무 워크북

지금 팀에서 문서로만 지켜지고 있는 규칙과 반복 절차를 모아, 다른 팀원이 그대로 설치하고 운영할 수 있는 확장 스택 설계서를 작성하세요.

작성 내용 자동 저장

결정적 규칙 인벤토리

CLAUDE.md나 팀 위키에 반드시 지켜야 한다고 적힌 규칙을 모두 나열하고, 각각 규칙으로 표현 가능한지, 어느 이벤트에서 검사해야 하는지, 차단이 필요한지 로깅이면 충분한지를 정리하세요.

차단 훅 설계

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

MCP 인벤토리와 예산

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

헤드리스 실행 경로

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

플러그인 패키징과 배포

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

완성도 점검 기준

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