로컬 AI 에이전트 환경이 복잡해질수록 문제는 “설정이 부족한가”가 아니라 “어떤 설정이 어디에 있어야 하는가”가 된다. CLAUDE.md, AGENTS.md, rules, skills, subagents, hooks, MCP, output-styles가 모두 같은 역할을 하려고 하면 컨텍스트는 비대해지고 지시는 충돌한다. 결국 에이전트는 더 많은 정보를 읽지만 더 덜 명확하게 행동한다.
이 프롬프트는 에이전트 운영을 하나의 설정 파일 문제가 아니라 레이어 설계 문제로 본다. 항상 읽혀야 할 원칙은 짧게 유지하고, 반복 절차는 skill로, 응답 형식은 output-style로, 자동 실행은 hook으로, 외부 권한은 MCP와 permission으로 분리해야 한다. 에이전트 설정도 제품 코드처럼 리팩터링과 감사가 필요하다.
근거
원문은 CLAUDE.md, rules, skills, agents, output-styles, MCP, settings/permissions를 각각 별도 감사 대상으로 두고, 중복·충돌·토큰 낭비·권한 과다를 점검하라고 요구한다.
CLAUDE.md, 스킬, rules, output-style의 역할이 잘 분리되어 있는지
연결된 생각
- 20260703-agent-settings-layer-separation — 설정 레이어 분리 원칙의 구조화된 개념.
- 20260603-harness-is-the-new-source-code — 자연어 설정과 스킬이 에이전트 harness의 실질적 소스코드라는 관점.
- 20260528-free-resources-destroy-the-excuse-of-not-knowing-where-to-start — Claude Code, MCP, Skills, Routines를 학습해 환경을 직접 설계할 수 있다는 흐름과 연결된다.