file-structure
-
Claude Code 서브에이전트의 파일 구성 전체 지도 — 단순 .md부터 플러그인까지IT 2026. 6. 17. 22:00
Claude Code에서 서브에이전트를 만들면 어떤 파일이 어떤 경로에 만들어질까? "마크다운 파일 하나"로 끝나는 단순한 경우도 있고, 네 종류의 파일이 특정 디렉토리 구조로 배치된 플러그인 패키지가 되는 경우도 있다. 이 글은 서브에이전트의 파일 구성 전체 지도를 그린다.두 형태의 갈림길 — 새 도구가 필요한가갈림길은 단순하다. 기존 Claude Code 기본 도구(Read, Edit, Bash, Grep 등)만으로 충분하면 마크다운 파일 하나로 끝난다. 외부 도구가 필요하면 플러그인 패키지로 키운다.단독 에이전트 — 파일 하나의 해부frontmatter가 설정이고 본문이 지시서다. frontmatter가 "이 에이전트를 언제 켜고 어떤 도구를 허용할지"를 정의하고, 시스템 프롬프트가 "켜진 에이전트..