플랜 우선 워크플로

아니요. Plan Mode는 엄격히 읽기 전용입니다.

• Verdent는 파일을 읽고, 코드를 검색하고, 코드베이스를 분석할 수 있습니다
• Plan Mode 중에는 파일 쓰기, 편집 또는 삭제가 발생하지 않습니다
• 플랜은 Chat View에만 표시됩니다
• 사용자가 명시적으로 승인하고 Agent Mode로 전환한 뒤에만 코드 실행이 시작됩니다

안전 보장: Plan Mode는 실수로 코드를 수정할 수 없습니다. 안전한 탐색과 전략 수립을 위해 설계되었습니다.

네. 점진적 실행을 완전히 지원합니다.

점진적 승인 패턴:

Let's start with Phase 1 first, then we'll review before continuing
Implement steps 1-3, then stop for review
Do the database migration first, I'll review before the API changes

작동 방식:

1. Verdent가 지정된 단계를 실행합니다
2. 검토 체크포인트에서 멈춥니다
3. 사용자가 결과를 검토하고 피드백을 제공합니다
4. 다음 단계로 계속 진행하거나 접근 방식을 조정합니다
5. 완료될 때까지 반복합니다

적합한 경우: 위험이 큰 변경, 익숙하지 않은 패턴, 단계적 롤아웃으로 위험을 줄여야 하는 프로덕션 핵심 코드.

플랜 거부는 완전히 정상이며 예상되는 과정입니다.

• Verdent는 피드백을 바탕으로 새 플랜을 생성합니다
• 이전 플랜 버전은 참조할 수 있도록 채팅 기록에 남습니다
• 코드 변경은 발생하지 않습니다(Plan Mode는 읽기 전용입니다)
• 만족할 때까지 무제한으로 반복할 수 있습니다

일반적인 거부 이유:

• 접근 방식이 너무 복잡하거나 너무 단순함
• 엣지 케이스 또는 오류 처리가 빠짐
• 더 나은 대안 아키텍처가 있음
• 요구 사항을 잘못 이해함

프로 팁: 거부는 프로세스의 일부입니다. 잘못된 전략을 실행하느라 노력을 낭비하는 것보다 플랜을 반복적으로 다듬는 편이 낫습니다.

Input Box에서 즉시 전환할 수 있습니다.

Plan Mode로 들어가기:

• Input Box의 Switch Mode 버튼을 선택합니다
• 드롭다운에서 Plan Mode를 선택합니다
• 또는 "Switch to Plan Mode"라고 말합니다

Plan Mode에서 나가기:

• Input Box의 Switch Mode 버튼을 선택합니다
• 드롭다운에서 Agent Mode를 선택합니다
• 또는 플랜을 검토한 뒤 Start Building을 선택합니다

모드 유지:

• 모드 선택은 현재 세션 안에서 유지됩니다
• 새 세션은 기본 Agent Mode에서 시작합니다
• 언제든지 자유롭게 모드를 전환할 수 있습니다

일반적인 워크플로: Plan Mode → 검토 → Agent Mode → 실행 → 다음 복잡한 기능을 위해 다시 Plan Mode로 돌아가기.

네, plan_rules.md를 사용하면 됩니다.

위치: ~/.verdent/plan_rules.md (전역 구성 디렉터리)

사용자 지정할 수 있는 항목:

• 세부 수준: 상위 수준 개요 vs. 세분화된 단계별 설명
• 플랜 구조: 포함할 섹션(요약, 위험, 의존성, 테스트)
• 포함할 정보: 예상 시간, 파일 경로, 검증 단계
• 형식 선호: 번호 목록, 단계, 분류

plan_rules.md 예시:

# Plan Rules

## Plan Structure
- Start with a brief summary (2-3 sentences)
- Include estimated time for each major step
- List prerequisites before implementation steps
- Identify potential risks and mitigation strategies

## Level of Detail
- Break tasks into subtasks of 15-30 minutes
- Include specific file paths for modifications
- List functions or components to create/modify
- Provide verification steps for each phase

변경 사항은 새 Plan Mode 세션에 즉시 적용됩니다.

아니요, Plan Mode에는 별도의 컨텍스트 관리가 있습니다.

• Plan Mode 컨텍스트: 분석과 전략적 사고에 최적화
• Agent Mode 컨텍스트: 실행과 구현에 최적화
• 장점: 플랜이 탐색 리서치로 실행 컨텍스트를 어지럽히지 않습니다

분리가 중요한 이유:

• Plan Mode는 Agent Mode를 복잡하게 만들지 않고 여러 접근 방식을 탐색할 수 있습니다
• 거부된 플랜 시도는 Agent Mode 컨텍스트를 소비하지 않습니다
• 실행으로 전환할 때 깨끗한 상태에서 시작합니다

컨텍스트 재설정: 모드를 전환하면 새 작업 유형에 맞는 새로운 컨텍스트가 제공됩니다.

명확화 질문은 분해 프로세스의 일부입니다.

질문하는 이유:

• 모호한 요구 사항에 명확화가 필요함
• 여러 유효한 접근 방식이 있음(하나 선택)
• 엣지 케이스나 제약 조건이 아직 지정되지 않음
• 초기 요청만으로 선호를 알기 어려움

응답 방법:

• 대화형 언어로 직접 답합니다
• 도움이 된다면 예시를 제공합니다
• Verdent의 판단을 신뢰한다면 "네가 선택해"라고 말합니다
• 확신이 없으면 되묻습니다

예시 대화:

Verdent: "Should I modify the existing validation or create a new validator?"
You: "Create a new validator - we'll deprecate the old one later"
Verdent: [Updates plan with new validator approach]

프로 팁: 질문은 Verdent가 사용자의 구체적인 요구에 맞춘 정확하고 관련성 높은 플랜을 생성하는 데 도움이 됩니다.