Claude Code 플러그인 (Plugin)

개인 지침을 팀에 배포할 때 생기는 문제

내가 만든 Skill을 팀원에게 파일로 보내면 각자 사본을 갖게 됩니다. 이후 기준을 고쳤을 때 누가 새 파일을 받았는지, 어느 작업이 옛 기준으로 실행됐는지 확인하기 어려워집니다.

플러그인은 이런 도구를 묶어 이름과 버전을 관리하는 수단입니다. Claude Code 공식 플러그인 문서는 Skill·에이전트·훅·MCP 서버 등을 패키지로 배포하는 구성을 설명합니다.

무엇을 묶을 수 있는가

이 목록은 대표 구성입니다. 실제 지원 범위는 사용 중인 버전의 공식 문서를 확인해야 합니다. 훅이 있다고 모든 동작이 차단되는 것도 아닙니다. 이벤트 종류와 반환 방식에 따라 알림·검사·차단 여부가 달라집니다.

배포와 실제 적용을 구분한다

설치·업데이트 문서에 따르면 갱신 동작은 마켓플레이스와 업데이트 설정 등의 영향을 받습니다. ‘원본 한 번 수정으로 즉시 전원 반영’은 보장되는 동작이 아닙니다.

문제가 있는 버전을 고쳐도 이미 생성된 결과물까지 자동으로 되돌아가지는 않습니다. 영향받은 작업을 찾아 재검토할 필요가 있습니다.

회사 지식과 실행 절차를 나눈다

BOAZ가 위키와 Skill을 함께 운영하면서 다루는 문제는 ‘어디의 기준이 바뀌었는가’입니다. 프로그램의 적용 대상이 바뀌었다면 지식을, 자료를 정리하는 순서가 잘못됐다면 Skill을 수정해야 합니다.

회사 사실과 관계는 LLM 위키나 다른 관리 원천에 두고, 플러그인의 절차가 그 원천을 참조하도록 만들 수 있습니다. 패키지는 배포 단위이지 모든 회사 지식이 자동으로 동기화되는 장치는 아닙니다.

팀에 배포하기 전 확인할 것

실제 업무에서 다른 입력으로 재실행해 보고, 기대 결과와 예외를 확인합니다. 갱신 담당자, 버전 확인 방법, 실패했을 때 되돌릴 경로도 정합니다. 조직에 배포할 때 필요한 것은 패키지 파일 하나보다 그 기준을 유지할 운영 방식입니다.

이렇게 배포와 갱신을 함께 관리할 때 개인의 지침이 AI 자산으로 이어질 수 있습니다.