심층 계획 명령

/deep-planning은 Cline을 코드 한 줄도 작성하기 전에 코드베이스를 조사하고, 명확한 질문을 하고, 포괄적인 구현 계획을 세우는 세심한 설계자로 변모시킵니다.

/deep-planning을 사용하면 Cline은 선임 개발자가 복잡한 기능에 접근하는 방식을 반영하는 4단계 프로세스를 따릅니다. 철저한 조사, 요구 사항 논의 및 명확화, 상세 계획, 진행 상황 추적을 통한 구조화된 작업 생성.

4단계 프로세스

1단계: 자동 조사

Cline은 코드베이스를 조용히 탐색하여 구조, 패턴 및 제약 조건을 이해하는 탐정이 됩니다. 소스 파일을 검사하고, 가져오기 패턴을 분석하고, 클래스 계층을 발견하고, 기술 부채 마커를 식별합니다. 주석도, 설명도 없이 오직 집중적인 연구만 합니다.

이 단계에서 Cline은 다음과 같은 명령을 실행합니다.

• 코드베이스 전체에서 모든 클래스 및 함수 정의 찾기
• 가져오기 패턴을 분석하여 종속성 이해
• 프로젝트 구조 및 파일 구성 발견
• TODO 및 기술 부채 식별

2단계: 논의 및 질문

Cline이 코드베이스를 이해하면 구현을 형성할 목표 질문을 합니다. 이는 일반적인 질문이 아니라 프로젝트 및 구축 중인 기능에 특정한 질문입니다.

질문은 다음을 다룰 수 있습니다.

• 모호한 요구 사항 명확화
• 동등하게 유효한 구현 접근 방식 중에서 선택
• 시스템 동작에 대한 가정 확인
• 기술적 결정에 대한 선호도 이해

3단계: 구현 계획 문서

Cline은 구현 청사진 역할을 하는 구조화된 마크다운 문서(implementation_plan.md)를 생성합니다. 이는 모호한 개요가 아니라 정확한 파일 경로, 함수 시그니처 및 구현 순서가 포함된 상세 사양입니다.

계획에는 8가지 포괄적인 섹션이 포함됩니다.

• 개요: 목표 및 상위 수준 접근 방식
• 유형: 완전한 유형 정의 및 데이터 구조
• 파일: 생성, 수정 또는 삭제할 정확한 파일
• 함수: 시그니처가 있는 새롭고 수정된 함수
• 클래스: 클래스 수정 및 상속 세부 정보
• 종속성: 패키지 요구 사항 및 버전
• 테스트: 유효성 검사 전략 및 테스트 요구 사항
• 구현 순서: 단계별 실행 순서

4단계: 구현 작업 생성

Cline은 계획 문서를 참조하고 추적 가능한 구현 단계를 포함하는 새 작업을 생성합니다. 이 작업에는 계획의 각 섹션을 읽는 특정 명령이 포함되어 있어 구현 에이전트(사용자 또는 실행 모드의 Caret)가 청사진을 효율적으로 탐색할 수 있도록 합니다.

tip

심층 계획은 포커스 체인과 아름답게 작동합니다. 구현 단계는 실시간 진행 상황 추적과 함께 자동으로 할 일 목록이 되어 복잡한 프로젝트를 체계적으로 유지하고 추적합니다.

심층 계획 사용

/deep-planning 뒤에 기능 설명을 입력하여 심층 계획 세션을 시작합니다.

/deep-planning JWT 토큰 및 역할 기반 액세스 제어를 통한 사용자 인증 추가

Cline은 즉시 조사를 시작합니다. 코드베이스를 이해하기 위해 파일을 읽고 명령을 실행하는 것을 볼 수 있습니다. 충분한 컨텍스트를 수집하면 계획을 생성하기 전에 논의에 참여할 것입니다.

예시 워크플로

다음은 실제 기능에 /deep-planning을 사용하는 방법입니다.

info

info

/deep-planning API 응답을 위한 캐싱 계층 구현을 입력합니다.

info

Cline은 코드베이스를 탐색하여 다음을 검사합니다.

• 현재 API 구조 및 엔드포인트
• 기존 데이터 흐름 패턴
• 데이터베이스 쿼리 및 성능 병목 현상
• 구성 및 환경 설정

info

Cline은 저에게 다음을 묻습니다.

• "Redis 또는 인메모리 캐싱을 사용해야 할까요?"
• "사용자 데이터에 허용되는 캐시 만료 기간은 얼마인가요?"
• "캐시 무효화 웹훅이 필요한가요?"

info

Cline은 다음을 포함하는 implementation_plan.md를 생성합니다.

• 캐시 서비스 클래스 사양
• Redis 연결 구성
• 캐싱 논리가 포함된 수정된 API 엔드포인트
• 캐시 키 생성 전략
• 다양한 데이터 유형에 대한 TTL 구성

info

Cline은 다음을 포함하는 새 작업을 생성합니다.

• 구현 계획 참조
• 특정 섹션을 읽는 명령
• 각 구현 단계에 대한 추적 가능한 할 일 항목
• 실행을 위해 실행 모드로 전환 요청

계획/실행 모드와의 통합

심층 계획은 계획/실행 모드와 원활하게 작동하도록 설계되었습니다.

• 조사 및 계획 단계에 계획 모드에서 /deep-planning 사용
• 생성된 작업은 구현을 위해 실행 모드로 전환하도록 요청
• 포커스 체인은 구현 단계를 통해 진행 상황을 자동으로 추적합니다.

이러한 분리는 계획이 아키텍처에 집중하고 구현이 실행에 집중하도록 보장합니다.

모범 사례

심층 계획 사용 시기

다음과 같은 경우 /deep-planning을 사용하십시오.

• 코드베이스의 여러 부분에 영향을 미치는 기능
• 신중한 조정이 필요한 아키텍처 변경
• 외부 서비스와의 복잡한 통합
• 체계적인 실행이 필요한 리팩토링 작업
• 일반적으로 화이트보드에 시간을 할애하는 모든 기능

조사 최대한 활용

Cline이 조사를 철저히 완료하도록 하십시오. 계획의 품질은 코드베이스를 얼마나 잘 이해하는지에 직접적으로 관련됩니다. 검사해야 할 특정 영역이 있는 경우 초기 요청에 언급하십시오.

계획 검토

구현을 시작하기 전에 항상 implementation_plan.md를 검토하십시오. 계획은 포괄적이지만 변경할 수 없습니다. 필요한 경우 직접 편집할 수 있습니다. 당신과 Caret 간의 협업 문서라고 생각하십시오.

진행 상황 추적

포커스 체인이 활성화되면 구현 진행 상황이 작업 헤더에 표시됩니다. Cline이 계획을 진행함에 따라 각 완료된 단계가 자동으로 체크되어 복잡한 구현에 대한 실시간 가시성을 제공합니다.

영감

저는 일반적으로 설계 문서가 필요한 것을 구축하려고 할 때마다 /deep-planning을 사용합니다. 워크플로의 최근 예시:

• 인증 시스템 마이그레이션: 심층 계획은 모든 엔드포인트를 매핑하고 모든 인증 접점을 식별하며 변경 사항을 방지하는 마이그레이션 계획을 생성했습니다.

• 실시간 기능 추가: 계획은 WebSocket 통합, 이벤트 처리, 상태 동기화 및 연결 끊김에 대한 대체 메커니즘을 다루었습니다.

• 데이터베이스 스키마 리팩토링: Cline은 영향을 받는 모든 쿼리를 식별하고 마이그레이션 스크립트를 생성하며 가동 중지 시간을 최소화하기 위해 롤아웃을 계획했습니다.

• API 버전 관리 구현: 계획은 경로 변경, 하위 호환성 계층, 사용 중단 알림 및 클라이언트 마이그레이션 경로를 자세히 설명했습니다.

/deep-planning의 힘은 구현 전에 신중한 아키텍처를 강제한다는 것입니다. 이는 코드를 작성하기 전에 선임 개발자가 접근 방식을 검토하는 것과 같지만, 그 개발자는 전체 코드베이스에 대한 완벽한 지식을 가지고 있습니다.

note

심층 계획은 강력한 추론 기능을 가진 모델이 필요합니다. GPT-5, Claude 4, Gemini 2.5 또는 Grok 4와 같은 최신 세대 모델에서 가장 잘 작동합니다. 작은 모델은 필요한 포괄적인 분석에 어려움을 겪을 수 있습니다.

광범위한 계획이 필요하지 않은 간단한 작업의 경우 컨텍스트와 함께 집중된 작업을 생성하기 위해 /newtask를 사용하거나, 진행 경로가 명확하면 즉시 구현으로 넘어가는 것을 고려하십시오.