Claude Code Tools Deep Dive #2 — EnterPlanMode: Why an Empty Schema Is a Design Choice

개요

Claude Code Tools의 EnterPlanMode는 Claude를 기본 "생각하며 작성" 워크플로우에서 명시적인 계획 수립 및 솔루션 설계 워크플로우로 전환하는 기능으로, AI와 사용자 간의 정렬을 강화하고 방향 오류를 방지합니다.

주요 내용

• EnterPlanMode는 Claude를 계획 모드로 진입시키는 도구로, "생각하며 작성" 모드에서 "읽기 전용 탐색 및 솔루션 설계" 기반의 계획 모드로 전환합니다.
• 이 도구는 AI와 사용자 간의 정렬을 보장하며, 작업 방향이 잘못되는 것을 방지하고, 사용자 승인 전에는 파일 수정이 불가능하도록 합니다.
• EnterPlanMode 활성화 시, Claude는 Edit, Write, NotebookEdit 등의 도구를 사용할 수 없으며, Read, Glob, Grep, Agent, AskUserQuestion, ExitPlanMode 등 읽기 전용 도구만 사용할 수 있습니다.
• EnterPlanMode는 사용자에게 전체적인 계획을 제시하고 명시적인 의사결정 경계를 생성하며, 추적 가능한 계획 결과물을 생성합니다.
• EnterPlanMode 사용은 사소하지 않은 구현 작업, 여러 파일에 영향을 미치는 변경, 모호한 요구사항, 또는 사용자 정의를 기반으로 한 구현에 권장됩니다.
• 반면, 한 줄 수정, 명확히 명시된 단일 기능 추가, 이미 상세한 지침이 제공된 경우, 또는 구현으로 이어지지 않는 순수 연구/탐색 작업에는 EnterPlanMode 사용이 권장되지 않습니다.
• EnterPlanMode의 설계는 "Enter"와 "Exit"라는 이름 자체에 핵심 의미를 부여하고, 도구 수준 설명에 상세한 제약 조건과 사용 지침을 포함하며, 필드 설명 및 스키마 유효성 검사 레이어는 비워두는 특징을 가집니다.
• 비어 있는 스키마는 도구의 의미가 "상태로 전환"하는 것일 때, 매개변수화하는 것이 의미를 약화시킬 수 있다는 디자인 원칙을 보여줍니다.
• EnterPlanMode, AskUserQuestion, ExitPlanMode는 협력하여 불확실한 부분을 명확히 하고, 계획을 수립하며, 사용자 승인을 받는 완전한 의사결정 파이프라인을 형성합니다.

시사점

EnterPlanMode는 AI 기반 개발 워크플로우에서 계획 단계의 중요성을 강조하며, 명확한 사용자 합의와 추적 가능한 산출물을 통해 코드 개발의 정확성과 효율성을 높이는 데 기여합니다.