아프니까 개발자다 아프니까 개발자다

지난 글에서 서브에이전트 정의 파일의 frontmatter 8개 필드 중 "핵심 4개"(name·description·tools·model)를 다뤘다. 이번 글은 나머지 "제어 4개"를 파고든다. 핵심 4개가 "이 에이전트를 언제 켜고 무엇을 시킬지"를 정한다면, 제어 4개는 "켜진 에이전트를 어떤 환경에서 어떻게 굴릴지"를 정한다. 평소엔 생략해도 되지만, 한 번 필요해지면 이 필드 없이는 문제를 풀 수 없다.제어 필드 4개가 푸는 4가지 문제네 필드는 각각 권한·기억·공간·시간이라는 서로 다른 축을 다룬다. 하나씩 보면 모두 "기본값으로 두면 안전하지만 답답하고, 바꾸면 강력하지만 조심해야 하는" 트레이드오프를 담고 있다. 어디서 기본값을 깨야 하는지가 이 글의 핵심이다.permissionMode —..

서브에이전트의 모든 것은 마크다운 파일 하나에 담긴다. 이 파일의 윗부분(frontmatter)이 에이전트의 설정이고, 아래 본문이 에이전트의 성격과 행동 규칙이다. Claude Code는 이 파일을 읽고 "언제 이 에이전트를 쓸지", "어떤 도구를 쓸 수 있는지", "어떻게 행동해야 하는지"를 결정한다.파일의 두 구역 — 설정과 지시구분선(---) 위가 설정이고 아래가 지시다. 설정이 맞지 않으면 에이전트가 아예 호출되지 않고, 지시가 나쁘면 호출은 되지만 엉뚱한 결과를 낸다. 두 구역 모두 중요하다.frontmatter 8개 필드 전체 지도▲ 핵심 필드 4개 — 거의 모든 에이전트가 쓰는 필수 설정▲ 제어 필드 4개 — 특수 상황에서만 쓰는 고급 설정description — 자동 위임의 핵심이자 가장..