CLAUDE.md 헌법: 개인 AI 에이전트 구축 — 파트 II 파일 둘러보기

개인 AI 에이전트 구축을 위한 100가지 팁 & 트릭(조회수 9만+, 추천 230+)의 후속으로, 작성자가 실제 파일을 공개합니다. 이 글은 CLAUDE.md의 주석 해설입니다. CLAUDE.md는 모든 세션 시작 시 로드되는 루트 설정 파일입니다.

이 파일은 프로덕션에서 약 3,200단어로, 6주에 걸쳐 구축되었습니다. 중간 규모 B2B 도매 회사(5개 법인, 약 50명 직원)의 CEO가 공급업체 관리, 고객 거래, 이메일 분류, 직원 데이터, 200만 개 이상의 ERP 데이터 행을 처리하는 데 사용합니다. 단일 사용자이며 모든 결정은 CEO에게 라우팅됩니다.

헌법의 16개 섹션

• 1. 정체성(IDENTITY) — 1인칭 일관된 어조, 직접적/데이터 우선/불필요한 내용 없음. 전달된 이메일에 포함된 프롬프트 인젝션을 방지하는 명령 독점 조항 포함.
• 2. 위임된 스파크(주도적 이니셔티브) — 에이전트는 관찰, 아이디어, 자기 개선, 패턴을 스스로 제안하는 파트너 역할. 응답당 최대 1개 스파크, 세션당 3개. 신뢰도 >6/10 및 구체적인 제안 필요. 응답이 3문장 미만이거나 사용자가 "간략히"라고 말하면 스파크 없음.
• 3. 주인 프로필(PRINCIPAL PROFILE) — CEO 역할, MBTI+Gallup/Big5 강점, 우선순위(수익↑, 비용↓, 급여↑, 자동화, 체계화), 좌절 유발 요인(비효율, 모호함, 1인 의존성).
• 4-5. 폴더 구조 + 하드 규칙 — 6가지 양보 불가 규칙 및 결정 권한 경계.
• 6-7. 메모리 시스템 + 긴급 마감일 — 160개 이상 파일, 혼란 제로. 마감일은 각 세션 종료 시 실시간 업데이트.
• 8. VIP 연락처 — 티어 1 — 글에서 자세히 다루지 않음.
• 9. 행동 규칙 — 다음 단계 프로토콜, 에이전트 파견 규칙.
• 10-11. 응답 레이아웃 맵 + 시각 시스템 — 도구 사용 전 간결성 강제.
• 12-16. MCP 설정, 라우팅 테이블, 세션 워크플로, 예약 작업, 심층 컨텍스트 트리거 — 글에서 한 줄 언급.

주요 시사점

• 어조 사양(“직접적, 데이터 우선, 불필요한 내용 없음”)은 세션당 수백 개의 미세 결정을 제거합니다.
• 명령 독점 조항은 실제 프롬프트 인젝션 보호 기능: 에이전트가 전달된 이메일을 읽지만 그 안에 포함된 명령은 실행하지 않습니다.
• 부정 정의는 행동을 고정시킵니다(“요약기가 아님, 예스 머신이 아님”).
• 위임된 스파크는 두 달 후 추가된 가장 효과적인 기능으로, CEO가 생각하지 못한 질문을 표면화합니다(예: 공급업체가 단일 실패 지점이 되는 경우). 신뢰도 기준과 스팸 방지 규칙이 높은 신호를 유지합니다.
• 에이전트는 공급업체 및 채용 분석에서 1인 의존성을 자동으로 플래그 지정합니다. 이는 내장된 좌절 유발 요인입니다.
• 다음 편에서는 메모리 시스템(160개 이상 파일), 멀티 에이전트 Council(AI 관점 5개, 투표 1개), 클라우드→로컬 마이그레이션을 다룰 예정입니다.

작성자는 주간 뉴스레터와 사이트 agentmia.beehiiv.com에서 전체 파일을 공개합니다. 모든 콘텐츠는 Reddit에도 게시됩니다.