AI 요약
2026년 2월 23일, Claude Code의 창시자인 Anthropic의 스태프 엔지니어 Boris Cherny가 공개한 'CLAUDE.md' 활용 규격이 IT 업계에서 화제가 되고 있습니다. CLAUDE.md는 프로젝트 루트에 배치되어 Claude가 세션 시작 시 자동으로 읽어 들이는 설정 파일로, 팀의 규칙과 작업 방식 등을 정의하는 AI의 '외부 메모리' 역할을 수행합니다. 이 가이드는 AI가 독자적으로 판단하여 코드를 망가뜨리는 것을 방지하기 위해 3단계 이상의 작업 시 반드시 계획부터 수립하는 'Plan 모드' 진입을 강조합니다. 또한, 메인 컨텍스트 윈도우의 부하를 줄이기 위해 리서치나 분석은 서브 에이전트에게 위임하고, 발생한 실수는 별도의 문서에 기록하여 지속적으로 개선하는 체계적인 AI 협업 워크플로우를 제시하고 있습니다.
핵심 인사이트
- 제작자 및 날짜: Claude Code의 생みの親인 Anthropic 스태프 엔지니어 Boris Cherny가 2026년 2월 23일 공유한 가이드라인임.
- Plan 모드 의무화: 3단계 이상의 프로세스나 아키텍처 결정이 필요한 태스크는 반드시 구현 전 'Plan 모드'를 거쳐야 함.
- 서브 에이전트 전략: 컨텍스트 윈도우를 깨끗하게 유지하기 위해 리서치, 조사, 병렬 분석에는 독립된 서브 에이전트를 적극 활용함.
- 자기 개선 루프: 사용자의 수정 사항이 발생하면 즉시
tasks/lessons.md에 기록하여 AI가 동일한 실수를 반복하지 않도록 규칙을 갱신함.
주요 디테일
- Plan 모드 진입법: Claude Code에서 Shift+Tab을 2회 입력하여 진입하며, 구현 전 상세 사양(Specs)을 작성해 모호성을 제거함.
- 서브 에이전트 할당: 1개의 서브 에이전트당 1개의 태스크만 할당하는 원칙을 고수하여 실행의 신뢰성을 높임.
- 특화 에이전트 예시: 'code-simplifier'(코드 단순화), 'verify-app'(E2E 테스트) 등 목적에 특화된 에이전트를 정의하여 사용함.
- 검증 기준: 태스크 완료 전 "스태프 엔지니어가 이 코드를 승인할 것인가?"를 자문하며 테스트 실행과 로그 확인을 거쳐야 함.
- 지침의 연속성: Claude는 세션을 넘어 학습하지 않으므로, CLAUDE.md에서 lessons.md 파일을 참조하게 하여 지식을 유지함.
향후 전망
- AI 워크플로우의 표준화: CLAUDE.md와 같은 설정 파일을 통한 AI 제어 방식이 복잡한 소프트웨어 개발 프로젝트의 표준 관행으로 자리 잡을 것으로 예상됨.
- 에이전트 오케스트레이션 발전: 단일 모델의 처리 한계를 극복하기 위해 다수의 특화 에이전트를 관리하는 '워크플로우 설계(Workflow Orchestration)' 기술이 더욱 중요해질 것임.