# Plan Mode (/ko/docs/verdent-manager/advanced-features/plan-mode)

> 지능적인 요구사항 명확화로 아이디어를 탄탄한 구현 플랜으로 전환합니다



Plan Mode에서 Verdent는 구조화된 요구사항 명확화를 통해 비공식적인 아이디어를 구현 플랜으로 전환합니다. 협업 대화와 반복적인 개선을 통해 구현을 시작하기 전에 방향을 맞춥니다.

## 배우게 될 내용 [#배우게-될-내용]

* Plan Mode를 사용해야 하는 시점
* 협업 기반 플래닝 워크플로
* 지능적인 요구사항 명확화
* 플랜 생성

***

## Plan Mode가 유용한 경우 [#plan-mode가-유용한-경우]

Plan Mode는 특히 다음 상황에서 유용합니다.

| 시나리오          | 상황                                                                            | Verdent의 도움 방식                                                                                    |
| ------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **불완전한 아이디어** | 아이디어는 있지만 아직 진행 경로를 정하지 못했습니다. 시간이 얼마나 걸릴지, 어디서부터 시작해야 할지 확신이 없습니다.           | 시작하기 전에 모든 것을 완벽히 정리할 필요가 없습니다. 막연한 아이디어를 실행 가능한 플랜으로 바꿀 수 있습니다. 한 문장이나 불완전한 생각만 있어도 시작하기에 충분합니다. |
| **플랜 검증**     | 머릿속에 플랜은 있지만 모든 것을 포괄하는지 확신이 없습니다. 경험과 대략적인 접근 방식은 있지만, 모든 경우를 다 고려했는지 불안합니다. | Verdent가 빠진 부분을 확인하고 플랜을 안정화합니다. “아마 될 것 같다”를 신뢰할 수 있는 결과로 바꿉니다. 빠진 요소를 능동적으로 채우고 리스크를 검증합니다.     |

***

## Plan Mode 워크플로 [#plan-mode-워크플로]

<Steps>
  <Step title="Plan Mode로 전환">
    `Shift+Tab`을 누르면 전환됩니다(macOS: `Cmd+.`, Windows: `Ctrl+.`). 아이디어를 설명합니다. 불완전해도 전혀 괜찮습니다.
  </Step>

  <Step title="능동적인 명확화">
    함께 브레인스토밍하고, 목표를 명확히 하며, 빠진 부분과 리스크를 드러냅니다. Verdent가 문제를 명확하게 표현하도록 도와줍니다.
  </Step>

  <Step title="제어권 유지">
    경직된 워크플로에 막히지 않고 제안을 수락하거나, 수정하거나, 건너뛸 수 있습니다.
  </Step>

  <Step title="실행 가능한 플랜 생성">
    흩어진 아이디어를 워크플로 차트가 포함된 명확하고 구조화된 단계로 정리합니다.
  </Step>

  <Step title="원클릭 실행">
    모든 단계는 표시되며, 일시 중지하거나 편집할 수 있습니다. 전체 과정이 투명하게 공개됩니다.
  </Step>

  <Step title="명확한 전달">
    완료 후 전체 요약과 코드 변경 사항에 대한 명확한 설명을 제공합니다.
  </Step>
</Steps>

***

## 주요 기능 [#주요-기능]

| 기능           | 설명                                     |
| ------------ | -------------------------------------- |
| **모드 선택**    | Plan Mode가 함께 플랜을 정의하고, 방향이 맞춰지면 실행합니다 |
| **대화형 명확화**  | Verdent가 작업의 모호함을 제거하기 위해 적극적으로 질문합니다  |
| **구조화된 플래닝** | 단편적인 생각을 워크플로 차트가 포함된 명확한 플랜으로 정리합니다   |

***

## 지능적인 요구사항 명확화 [#지능적인-요구사항-명확화]

Verdent는 기술 파트너처럼 함께합니다.

<Tabs>
  <Tab title="탐색적 대화">
    여러 차례의 대화를 통해 암묵적인 요구사항을 찾아냅니다.

    * 엣지 케이스 식별 및 기술적 제약 발견
    * 구현 전에 모호함을 능동적으로 해소
    * 협업 논의를 통한 반복적인 개선
  </Tab>

  <Tab title="도메인 전문성">
    소프트웨어 엔지니어링 모범 사례를 적용합니다.

    * 최적의 접근 방식, 디자인 패턴, 기술 선택을 제안합니다
    * 충분한 의사결정을 위해 장단점이 포함된 트레이드오프 분석을 제시합니다
    * 업계 표준 솔루션과 프레임워크를 추천합니다
  </Tab>

  <Tab title="편리한 상호작용">
    편리한 명확화 상호작용을 지원합니다.

    * 명확화 옵션 수정
    * 추가 정보와 컨텍스트 제공
    * 명확화 건너뛰기
    * 변경 사항을 롤백하고 다시 제출
  </Tab>
</Tabs>

***

## 명확화 루프 [#명확화-루프]

Plan Mode에서 Verdent는 대화형 설문을 통해 명확화 질문을 제시하여, 구현 전에 요구사항을 함께 확인할 수 있게 합니다.

* **객관식** - 미리 정의된 답변 옵션 중에서 선택합니다
* **사용자 지정 답변** - 선택지가 맞지 않을 때 직접 답변을 작성합니다
* **혼합 방식** - 옵션을 선택하고 사용자 지정 설명을 추가합니다

### 개선 제어 [#개선-제어]

명확화 루프 중 사용할 수 있는 상호작용은 다음과 같습니다.

* **옵션 수정** - 제시된 객관식 옵션을 컨텍스트에 더 잘 맞도록 조정합니다
* **명확화 건너뛰기** - 요구사항이 충분히 명확할 때 Verdent의 최선의 판단으로 진행합니다
* **변경 사항 롤백** - 이전 명확화 상태로 되돌리고 다른 답변을 다시 제출합니다

***

## 플랜 생성 [#플랜-생성]

Verdent는 개발자가 바로 사용할 수 있는 플랜을 생성하며, 여기에는 다음이 포함됩니다.

* 목표, 범위, 성공 기준에 대한 상위 수준 요약
* 컴포넌트 구조와 관계
* 데이터 모델 및 API 계약
* 기술 스택 고려 사항

***

## FAQ [#faq]

<AccordionGroup>
  <Accordion title="Plan Mode로 어떻게 전환하나요?">
    `Shift+Tab`을 누르면 Plan Mode와 Agent Mode 사이를 전환할 수 있습니다(macOS: `Cmd+.`, Windows: `Ctrl+.`). 입력 상자의 Switch Mode 버튼을 선택할 수도 있습니다.
  </Accordion>

  <Accordion title="Agent Mode 대신 Plan Mode를 언제 사용해야 하나요?">
    복잡한 기능, 아키텍처 결정, 또는 구현 전에 접근 방식을 검토하고 싶을 때 Plan Mode를 사용합니다. 단순한 작업에는 Agent Mode를 사용합니다.
  </Accordion>

  <Accordion title="명확화 질문을 건너뛸 수 있나요?">
    네. 요구사항이 충분히 명확할 때 Skip Clarifications 옵션을 사용하면 Verdent의 최선의 판단으로 진행할 수 있습니다.
  </Accordion>

  <Accordion title="내 플랜이 저장되나요?">
    나중에 참고할 수 있도록 Verdent에게 플랜을 markdown 파일로 저장해 달라고 요청합니다.
  </Accordion>

  <Accordion title="실행 전에 플랜을 수정할 수 있나요?">
    Plan Mode에서 Verdent에게 플랜을 수정해 달라고 요청할 수 있습니다. 만족스러우면 Agent Mode로 전환해 실행합니다.
  </Accordion>

  <Accordion title="Plan Mode는 크레딧을 사용하나요?">
    네. Plan Mode 작업은 Agent Mode와 마찬가지로 사용한 모델과 처리된 토큰에 따라 크레딧을 소비합니다.
  </Accordion>
</AccordionGroup>