LeanX

에이전틱 엔지니어링 — 클로드 코드 심화

스킬·서브에이전트·에이전트 팀·훅·커스텀 MCP를 엮어, 코드를 '짜는' 사람에서 AI를 '설계하고 오케스트레이션하는' 사람으로 — 1인이 팀급 생산성을 내는 심화 과정입니다.

에이전틱 엔지니어란 무엇인가

에이전틱 엔지니어는 코드를 직접 타이핑하는 사람이 아니라 AI 에이전트를 설계하고 오케스트레이션하는 사람이며, 스킬·서브에이전트·에이전트팀·훅·커스텀MCP 다섯 부품을 엮어 1인이 팀급 생산성을 내는 사람입니다. 약 9분.

컨텍스트 경제학: 스킬 vs MCP vs 서브에이전트

스킬은 안 쓸 때 이름·설명만 올려 두어 가장 가볍고, MCP는 Claude Code가 기본으로 켜 둔 도구 검색(tool search) 덕분에 필요한 도구 설명만 그때 불러오지만 이를 끄면 연결된 서버의 도구 설명이 모두 미리 올라와 무거워지며, 서브에이전트는 정의만 상주하고 실행은 별도 컨텍스트에서 돌아 메인을 더럽히지 않으므로, '언제 공간을 아끼고 싶은지'를 기준으로 골라야 합니다. 약 11분.

스킬 저작 심화: description이 8할

스킬은 클로드가 description을 읽고 스스로 사용 여부를 판단하므로, 추상적인 한 줄이 아니라 핵심 기능 첫 문장과 사용자가 실제로 말할 트리거 표현을 담은 description을 쓰는 것이 스킬 품질의 8할을 결정합니다. 약 11분.

서브에이전트 4패턴과 위임 판단

서브에이전트는 격리·병렬·체인·재귀 네 패턴으로 쓰며, '작업이 독립적인가'와 '컨텍스트 오염이 우려되는가' 두 질문으로 위임 여부를 판단하고, 병렬 토큰을 아끼기 위해 서브에이전트 모델은 Opus 대신 Sonnet·Haiku를 기본으로 두는 것이 효율적입니다. 약 11분.

에이전트 팀: 서브에이전트를 넘어

서브에이전트는 메인하고만 소통하지만, 에이전트 팀은 리더가 조율·분배하고 팀원끼리 직접 메시지를 주고받으며 각자 독립 컨텍스트로 협업하므로, 실제 개발팀처럼 여러 담당이 동시에 일하고 필요할 때 소통해야 하는 큰 작업에 적합합니다. 약 9분.

훅 자동화 파이프라인

훅은 PreToolUse에서 도구 실행을 검증·차단하고, 실행 후 PostToolUse에서 포맷·타입체크를 돌리며, Notification으로 대기 알림을, Stop으로 세션 종료 정리를 자동화하는 이벤트 파이프라인으로, 완료 알림을 Slack 같은 외부 채널과 엮으면 긴 작업의 끝을 놓치지 않을 수 있습니다. 약 10분.

커스텀 MCP로 교차 검증 & 시간 자동화

한 모델이 세운 플랜을 커스텀 MCP를 통해 다른 모델에게 리뷰시키면 사각지대를 줄이는 교차검증 효과를 얻을 수 있고, 이 과정을 스킬로 자동화하며, 이벤트에 반응하는 훅과 달리 /loop·스케줄은 '5분마다'처럼 시간을 기준으로 반복한다는 점에서 서로를 보완합니다. 약 11분.

캡스톤: 1인 개발자 풀 파이프라인

음성 피드백 전달부터 플랜 모드 설계, 커스텀 MCP 교차 리뷰, 서브에이전트 병렬 구현, 완료 훅 알림, 코드리뷰 플러그인, 커스텀 스킬 리포트 생성까지 8단계로 엮으면, 혼자서도 반나절짜리 작업을 30분으로 줄이는 에이전틱 엔지니어의 풀 파이프라인이 완성됩니다. 약 12분.