# Plan Rules (/ko/docs/verdent-for-vscode/core-features/plan-rules)

> 역할과 전문 배경에 맞춰 확인 질문과 플랜이 표시되는 방식을 사용자화합니다



Plan Rules는 Verdent이 요구사항, 확인 질문, 구현 플랜을 제시하는 방식을 개인화하여 **Plan** 단계를 지원합니다. 기본 제공되는 역할 기반 템플릿을 출발점으로 사용하거나, 사고방식과 작업 습관에 맞는 완전한 사용자 정의 규칙을 만들 수 있습니다.

### 배울 내용 [#배울-내용]

* Plan Rules가 플랜 표시 방식을 사용자화하는 방법
* 기본 제공 역할 템플릿(Frontend, Test, Product Manager)
* 사용자 정의 플랜 규칙 만들기
* 플랜 규칙이 적용되는 시점

***

## Plan Rules로 사용자화할 수 있는 항목 [#plan-rules로-사용자화할-수-있는-항목]

Plan Rules는 Verdent이 Plan Mode에서 플랜을 제시하는 방식을 제어합니다.

<Tabs>
  <Tab title="표시 형식">
    * **요약-상세-요약** - 앞부분에는 핵심 요약, 중간에는 상세 단계, 끝부분에는 영향 요약을 제공합니다
    * **다이어그램 우선** - 시각적 표현을 먼저 보여주고, 텍스트로 보조 설명을 제공합니다
    * **표 형식 vs 서술 형식** - 빠르게 훑어볼 수 있는 데이터에는 구조화된 표를, 맥락 설명에는 문장을 사용합니다
    * **섹션 순서** - 어떤 섹션을 먼저 표시할지 사용자화하고 계층 구조를 정의합니다

    <Tip>
      빠른 이해가 중요한 이해관계자 리뷰에는 요약-상세-요약을 사용합니다. 구현에 들어가기 전에 아키텍처 이해가 중요한 경우에는 다이어그램 우선을 사용합니다.
    </Tip>
  </Tab>

  <Tab title="콘텐츠 깊이">
    * **상위 수준 전략** - 기술 세부사항은 최소화하고 "무엇"과 "왜"에 집중합니다
    * **상세 기술 설명** - 구현 세부사항, 코드 패턴, 아키텍처 결정을 포함합니다
    * **코드 예시** - 코드 표시 여부를 제어합니다(포함/제외, 전체 vs 일부, diff 형식)
    * **테스트 콘텐츠** - QA 워크플로에는 기본 포함하고, PM 중심 플랜에서는 생략합니다

    <Tip>
      콘텐츠 깊이를 대상 독자에 맞춥니다. 팀 간 협업에는 상위 수준 전략을 사용하고, 혼자 구현하거나 시니어 개발자와 함께 구현할 때는 상세 기술 설명을 사용합니다.
    </Tip>
  </Tab>

  <Tab title="시각 요소">
    * **Mermaid 다이어그램** - 플로차트, 시퀀스 다이어그램, 상태 머신(자동 생성 또는 명시적 생성)
    * **DOM 계층 트리** - 트리 스타일 폴더 형식의 컴포넌트 구조
    * **와이어프레임** - UI 목업과 레이아웃 스케치
    * **스타일 표** - 컴포넌트별로 정리된, 병합 셀을 포함한 CSS 사양

    <Tip>
      요청하면 플랜 콘텐츠에서 Mermaid 다이어그램이 자동 생성됩니다. 기본적으로 원하는 특정 다이어그램 유형이 있다면 플랜 규칙에서 명시적으로 요청합니다.
    </Tip>
  </Tab>

  <Tab title="기본 동작">
    * **기본 생략** - 테스트, 스타일, 하위 호환성(플랜 길이를 줄입니다)
    * **필수 요소** - 수용 기준, 엣지 케이스, KPI(프로덕션 준비 상태를 보장합니다)
    * **확인 질문 선호도** - 여러 차례 확인 vs 한 번의 확인 vs 확인 없음

    <Tip>
      플랜을 간결하게 유지하려면 먼저 생략 항목부터 설정한 뒤, 실제로 필요한 항목에만 필수 요소를 추가합니다. 특정 플랜 세션에서는 언제든지 생략된 콘텐츠를 요청할 수 있습니다.
    </Tip>
  </Tab>

  <Tab title="역할별">
    * **Frontend** - 다이어그램, DOM 트리, 스타일 표를 포함한 시각적 아키텍처를 제공하며, 테스트는 기본적으로 생략합니다
    * **QA/Test** - 커버리지 매트릭스, 경계값 분석, 추적성을 포함한 테스트 케이스 표를 제공합니다
    * **Product Manager** - 비즈니스 요구사항만 다루며, 다이어그램/와이어프레임을 포함하고 코드 스니펫은 제외합니다

    <Tip>
      역할 템플릿으로 시작한 뒤 사용자화합니다. 대부분의 개발자는 Frontend 또는 QA 템플릿을 기반으로 사용하고, 자신의 워크플로에 맞게 특정 섹션을 조정합니다.
    </Tip>
  </Tab>
</Tabs>

***

## 역할 기반 플랜 템플릿 [#역할-기반-플랜-템플릿]

Verdent은 플랜 구조, 콘텐츠 깊이, 표시 스타일을 자동으로 조정하는 전문 역할 템플릿을 제공합니다.

<Tabs>
  <Tab title="Frontend">
    **초점:** 시각적 구조를 갖춘 기술 구현 플랜

    **주요 특징:**

    * 플랜 수립 전 포괄적인 코드베이스 조사
    * 상호작용 흐름을 위한 Mermaid 플로차트와 상태 다이어그램
    * 트리 스타일 폴더 형식의 DOM 계층 구조
    * CSS 속성을 위한 병합 셀 포함 스타일 표
    * **생략:** 기본적으로 테스트 콘텐츠와 스타일을 생략합니다(요청한 경우 제외)
    * **제공:** 여러 옵션 없이 확정적인 솔루션을 제공합니다

    **적합한 대상:** 시각적 아키텍처와 명확한 구현 경로가 필요한 프론트엔드 개발자
  </Tab>

  <Tab title="Test">
    **초점:** 포괄적인 테스트 케이스 생성과 품질 보증

    **주요 특징:**

    * 목표 지향 테스트 설계(비즈니스 로직, 보안, 안정성)
    * 9개 열 Markdown 표로 구성된 구조화된 테스트 케이스
    * 동등 분할, 경계값, 핵심 파라미터
    * 전체 커버리지: 정상, 대안, 예외, 엣지 케이스
    * 자동화 지원을 고려한 실행 가능성 중심
    * 요구사항 항목까지의 추적성

    **적합한 대상:** 체계적인 테스트 커버리지가 필요한 QA 엔지니어와 테스트 자동화 전문가
  </Tab>

  <Tab title="Product Manager (PM)">
    **초점:** 비즈니스 관점의 제품 요구사항

    **주요 특징:**

    * **코드 스니펫이나 기술 구현 없음**
    * **어떻게**가 아니라 **무엇**과 **왜**에 집중합니다
    * 시퀀스 다이어그램, 플로차트, 와이어프레임
    * 우선순위와 Before/After 비교가 포함된 요구사항 목록
    * 처리 전략이 포함된 엣지 케이스
    * KPI와 이벤트 추적이 포함된 데이터 사양

    **적합한 대상:** 기술적 잡음 없이 비즈니스 요구사항을 정의하는 Product Manager
  </Tab>
</Tabs>

***

## 사용자 정의 플랜 규칙 [#사용자-정의-플랜-규칙]

다음을 정의하여 개인화된 플랜 규칙을 만듭니다.

**규칙 구성 요소:**

* **표시 스타일** - 요약-상세-요약, 다이어그램 우선, 표 형식
* **콘텐츠 깊이** - 상위 수준 개요 vs 상세 구현
* **생략 항목** - 기본적으로 제외할 항목(테스트, 스타일, 하위 호환성)
* **필수 요소** - 반드시 포함할 섹션(다이어그램, 수용 기준, 데이터 사양)
* **상호작용 선호도** - 확인 질문 방식, 확인 요구사항

<Tip>
  Plan Mode에서 입력 상자의 **Plan Rules** 버튼을 선택하면 플랜 규칙에 빠르게 접근하고 수정할 수 있습니다.
</Tip>

**규칙 적용:**

* 모든 Plan Mode 세션에 적용됩니다
* 워크스페이스 세션 전반에 유지됩니다
* 인라인 지시문으로 재정의할 수 있습니다
* 사용자 정의 서브에이전트와 함께 작동합니다

**자세히 알아보기:** Markdown 형식으로 사용자 정의 플랜 규칙을 정의하려면 워크스페이스에서 `Plan.md`을 만들거나 편집합니다.

***

## 함께 보기 [#함께-보기]

<CardGroup cols="3">
  <Card title="Professional Plan" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    아이디어를 구현 플랜으로 전환합니다
  </Card>

  <Card title="Clarification Loop" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    상호작용 방식의 요구사항 정제
  </Card>
</CardGroup>