Claude Code를 활용한 자율 운영 비즈니스 에이전트의 CLAUDE.md 구조화 가이드

실용적 조언

CLAUDE.md에 현재 작동하는 도구와 고장 난 도구의 목록을 관리하여 에이전트의 시행착오를 줄여라.
모든 기술 실행 끝에 LEARNINGS.md를 업데이트하게 하여 프롬프트를 지속적으로 개선하라.
단순한 데이터 수집이나 감사 작업은 Claude 3 Haiku 같은 저비용 모델의 하위 에이전트에게 위임하라.

섹션별 상세

CLAUDE.md를 에이전트의 정체성, 미션, 기술 레지스트리, 제품 카탈로그를 포함하는 부트 파일로 정의했다. 세션 시작 시 에이전트가 별도의 브리핑 없이 자신의 역할과 현재 상태(정상 작동 도구, 고장 난 부분 등)를 즉시 파악하도록 설계됐다. 이를 통해 인간의 개입 없이도 일관된 의사결정 계층을 유지하며 업무를 시작한다.

14개의 개별 기술을 슬래시 명령어(/)와 매핑하고, 각 기술의 실행 로직과 자가 채점 루브릭을 별도의 SKILL.md 파일로 관리한다. 예를 들어 /ditl은 일일 블로그 포스트를 작성하고, /ops는 운영 대시보드를 업데이트하는 등 결정론적이면서도 유연한 실행이 가능하다. 각 기술 실행 후에는 LEARNINGS.md를 업데이트하여 에이전트가 스스로 성능을 개선하는 기반을 마련한다.

메인 에이전트가 복잡한 결정을 내리고, 기계적인 작업은 Haiku 모델 기반의 하위 에이전트에게 위임하는 오케스트레이터 패턴을 적용했다. 사이트 동기화(Sonnet), 콘텐츠 감사(Haiku), 분석 데이터 수집(Haiku) 등 역할별로 에이전트를 분리하여 비용 효율성을 높였다. 창의적 작업은 메인 컨텍스트에서 처리하고 단순 반복 작업은 저비용 모델로 분산하는 것이 핵심이다.

별도의 벡터 DB나 외부 메모리 서비스 없이 마크다운 및 JSON 파일만으로 세션 간 연속성을 유지한다. kaizen-log.md에 세션별 학습 내용을 기록하고, 다음 세션 시작 시 최근 기록을 읽어들여 기억을 복원하는 방식이다. 이는 외부 시스템 의존도를 낮추면서도 인간이 에이전트의 기억을 직접 읽고 수정할 수 있는 가독성과 감사 가능성을 제공한다.

용어 해설

CLAUDE.md 설정 파일(CLAUDE.md): — Claude Code 에이전트의 행동 지침, 프로젝트 맥락, 코딩 스타일 등을 정의하는 특수 설정 파일이다. 에이전트가 세션을 시작할 때 이 파일을 읽어 프로젝트의 규칙과 현재 상태를 파악하는 '부트 파일' 역할을 수행한다.
자율 에이전트(Autonomous Agent): — 인간의 지속적인 개입 없이 설정된 목표를 달성하기 위해 스스로 계획을 세우고 도구를 사용하며 작업을 수행하는 AI 시스템이다. 본문에서는 비즈니스 운영 전반을 담당하는 에이전트 아키텍처를 다룬다.
오케스트레이터 패턴(Orchestrator Pattern): — 메인 AI 모델이 전체적인 계획과 의사결정을 담당하고, 구체적이고 단순한 작업은 하위 에이전트나 도구에게 위임하여 처리하는 설계 방식이다. 복잡한 워크플로를 효율적으로 관리하고 비용을 절감하는 데 유리하다.
컨텍스트 윈도우(Context Window): — AI 모델이 한 번에 처리할 수 있는 텍스트 데이터의 총량이다. 대화가 길어지면 초기 정보가 유실될 수 있으므로, 본문에서는 중요한 정보를 대화 기록이 아닌 파일에 직접 기록하여 영구 저장하는 방식을 제안한다.

언급된 도구

Claude Code추천

자율 비즈니스 운영 에이전트의 핵심 엔진

Claude 3.5 Sonnet중립

복잡한 의사결정 및 창의적 작업 수행

Claude 3 Haiku추천

단순 반복 작업 및 하위 에이전트 구동