# Regras de plano (/pt/docs/verdent-for-vscode/core-features/plan-rules)

> Personalize como as clarificações e os planos são apresentados com base no seu papel e formação profissional



Plan Rules apoia a fase **Plan** ao personalizar como o Verdent apresenta requisitos, clarificações e planos de implementação. Use os modelos integrados baseados em papéis como ponto de partida ou crie regras totalmente personalizadas que combinem com seu estilo de pensamento e hábitos de trabalho.

### O que você vai aprender [#o-que-você-vai-aprender]

* Como o Plan Rules personaliza a apresentação dos planos
* Modelos de papéis integrados (Frontend, Test, Product Manager)
* Como criar regras de plano personalizadas
* Quando as regras de plano são aplicadas

***

## O que o Plan Rules pode personalizar [#o-que-o-plan-rules-pode-personalizar]

O Plan Rules controla como o Verdent apresenta os planos no Plan Mode:

<Tabs>
  <Tab title="Formato de apresentação">
    * **Resumo-detalhe-resumo** - Resumo executivo no início, etapas detalhadas no meio, resumo de impacto no final
    * **Diagrama primeiro** - A representação visual lidera, o texto fornece detalhes de apoio
    * **Tabular vs. narrativo** - Tabelas estruturadas para dados fáceis de escanear, prosa para explicações contextuais
    * **Ordenação de seções** - Personalize quais seções aparecem primeiro e defina a hierarquia

    <Tip>
      Use resumo-detalhe-resumo para revisões com stakeholders, onde a compreensão rápida é importante. Use diagrama primeiro quando o entendimento arquitetural for crítico antes de mergulhar na implementação.
    </Tip>
  </Tab>

  <Tab title="Profundidade de conteúdo">
    * **Estratégico de alto nível** - Foca no "o quê" e no "porquê" com mínimos detalhes técnicos
    * **Técnico detalhado** - Inclui especificidades de implementação, padrões de código, decisões de arquitetura
    * **Exemplos de código** - Controle se o código aparece (incluir/excluir, completo vs. trechos, formato diff)
    * **Conteúdo de testes** - Incluído por padrão para fluxos de trabalho de QA, omitido para planos focados em PM

    <Tip>
      Ajuste a profundidade do conteúdo ao seu público. Use estratégico de alto nível para colaboração entre equipes e técnico detalhado ao implementar sozinho ou com desenvolvedores seniores.
    </Tip>
  </Tab>

  <Tab title="Elementos visuais">
    * **Diagramas Mermaid** - Fluxogramas, diagramas de sequência, máquinas de estado (gerados automaticamente ou explícitos)
    * **Árvores de hierarquia DOM** - Estrutura de componentes em formato de pastas em árvore
    * **Wireframes** - Mockups de UI e esboços de layout
    * **Tabelas de estilo** - Especificações de CSS com células mescladas, organizadas por componente

    <Tip>
      Os diagramas Mermaid são gerados automaticamente a partir do conteúdo do plano quando solicitados. Peça explicitamente tipos específicos de diagramas nas suas regras de plano se quiser que eles apareçam por padrão.
    </Tip>
  </Tab>

  <Tab title="Comportamentos padrão">
    * **Omitir por padrão** - Testes, estilos, compatibilidade retroativa (reduz o tamanho do plano)
    * **Elementos obrigatórios** - Critérios de aceitação, casos extremos, KPIs (garante prontidão para produção)
    * **Preferências de clarificação** - Múltiplas rodadas vs. confirmação única vs. nenhuma confirmação

    <Tip>
      Comece com omissões para manter os planos concisos e, depois, adicione elementos obrigatórios apenas para o que você realmente precisa. Você sempre pode solicitar o conteúdo omitido em sessões de plano específicas.
    </Tip>
  </Tab>

  <Tab title="Específico por papel">
    * **Frontend** - Arquitetura visual com diagramas, árvores DOM, tabelas de estilo, omite testes por padrão
    * **QA/Test** - Tabelas de casos de teste com matrizes de cobertura, análise de valores limite, rastreabilidade
    * **Product Manager** - Apenas requisitos de negócio, diagramas/wireframes, sem trechos de código

    <Tip>
      Comece com um modelo de papel e personalize a partir dele. A maioria dos desenvolvedores usa os modelos Frontend ou QA como base e ajusta seções específicas para combinar com seu fluxo de trabalho.
    </Tip>
  </Tab>
</Tabs>

***

## Modelos de plano baseados em papéis [#modelos-de-plano-baseados-em-papéis]

O Verdent fornece modelos de papéis profissionais que ajustam automaticamente a estrutura do plano, a profundidade do conteúdo e o estilo de apresentação:

<Tabs>
  <Tab title="Frontend">
    **Foco:** Planos de implementação técnica com estrutura visual

    **Características principais:**

    * Pesquisa abrangente da base de código antes de planejar
    * Fluxogramas e diagramas de estado Mermaid para fluxos de interação
    * Hierarquia DOM em formato de pastas em árvore
    * Tabelas de estilo com células mescladas para propriedades CSS
    * **Omite:** Conteúdo de testes e estilos por padrão (a menos que solicitado)
    * **Fornece:** Soluções definitivas sem múltiplas opções

    **Melhor para:** Desenvolvedores frontend que precisam de arquitetura visual e caminhos de implementação claros
  </Tab>

  <Tab title="Test">
    **Foco:** Geração abrangente de casos de teste e garantia de qualidade

    **Características principais:**

    * Design de testes orientado a objetivos (lógica de negócio, segurança, estabilidade)
    * Casos de teste estruturados com tabelas Markdown de 9 colunas
    * Classes de equivalência, valores limite e parâmetros-chave
    * Cobertura total: casos normais, alternativos, de exceção e extremos
    * Foco em executabilidade com suporte à automação
    * Rastreabilidade até os pontos de requisito

    **Melhor para:** Engenheiros de QA e especialistas em automação de testes que precisam de cobertura de testes sistemática
  </Tab>

  <Tab title="Product Manager (PM)">
    **Foco:** Requisitos de produto sob a perspectiva de negócio

    **Características principais:**

    * **Sem trechos de código ou implementação técnica**
    * Foca no **o quê** e no **porquê**, não no **como**
    * Diagramas de sequência, fluxogramas e wireframes
    * Listas de requisitos com prioridades e comparações Antes/Depois
    * Casos extremos com estratégias de tratamento
    * Especificações de dados com KPIs e rastreamento de eventos

    **Melhor para:** Gerentes de produto que definem requisitos de negócio sem poluição técnica
  </Tab>
</Tabs>

***

## Regras de plano personalizadas [#regras-de-plano-personalizadas]

Crie regras de plano personalizadas definindo:

**Componentes da regra:**

* **Estilo de apresentação** - Formato resumo-detalhe-resumo, diagrama primeiro ou tabular
* **Profundidade de conteúdo** - Visão geral de alto nível vs. implementação detalhada
* **Omissões** - O que excluir por padrão (testes, estilos, compatibilidade retroativa)
* **Elementos obrigatórios** - Seções obrigatórias (diagramas, critérios de aceitação, especificações de dados)
* **Preferências de interação** - Abordagem de clarificação, requisitos de confirmação

<Tip>
  No Plan Mode, clique no botão **Plan Rules** na caixa de entrada para acessar e modificar rapidamente suas regras de plano.
</Tip>

**Aplicação das regras:**

* Aplica-se a todas as sessões do Plan Mode
* Persiste entre as sessões do espaço de trabalho
* Pode ser substituída por diretivas inline
* Funciona com subagentes personalizados

**Saiba mais:** Crie ou edite `Plan.md` no seu espaço de trabalho para definir regras de plano personalizadas usando o formato Markdown.

***

## Veja também [#veja-também]

<CardGroup cols="3">
  <Card title="Professional Plan" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    Transforme ideias em planos de implementação
  </Card>

  <Card title="Clarification Loop" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    Refinamento interativo de requisitos
  </Card>
</CardGroup>
