
Por que diagramas importam
- Quer entender o controle de fluxo na sua base de código
- Precisa rastrear a linhagem dos dados da entrada até a saída
- Tá onboardando outras pessoas ou documentando seu sistema
Duas dimensões a considerar
- Propósito: tá mapeando lógica, fluxo de dados, infraestrutura ou outra coisa?
- Formato: quer algo rápido (tipo um diagrama Mermaid) ou formal (tipo UML)?
Como criar prompts
- Controle de fluxo: “Me mostra como as requisições vão do controller até o banco de dados.”
- Linhas de dados: “Rastreia essa variável desde a entrada até onde ela termina.”
- Estrutura: “Me dá uma visão em nível de componentes desse serviço.”
Trabalhando com Mermaid
flowchart
para lógica e sequênciassequenceDiagram
para interaçõesclassDiagram
para estrutura de objetosgraph TD
para mapas direcionais simples
- Vai na aba Extensions
- Busca por Mermaid
- Instala

Estratégia de diagramas
- Escolhe uma função, rota ou processo
- Pede pro Cursor diagramar essa parte usando Mermaid
- Quando tiver algumas, pede pra ele combinar
Fluxo recomendado
- Começa com um diagrama detalhado e de baixo nível
- Resume para uma visão de nível intermediário
- Repete até chegar no nível de abstração que você quer
- Pede pro Cursor mesclar tudo em um único diagrama ou mapa do sistema
Principais pontos
- Usa diagramas pra entender fluxo, lógica e dados
- Começa com prompts pequenos e vai expandindo teu diagrama a partir daí
- Mermaid é o formato mais fácil de usar no Cursor
- Começa no baixo nível e vai abstraindo, como no modelo C4
- O Cursor pode te ajudar a gerar, refinar e combinar diagramas com facilidade