Nível de Código C4: [Nome do Diretório]

Use esta habilidade quando

• Trabalhando em tarefas ou fluxos de trabalho do nível de código C4: [nome do diretório]
• Precisando de orientação, melhores práticas ou listas de verificação para o nível de código C4: [nome do diretório]

Não use esta habilidade quando

• A tarefa não estiver relacionada ao nível de código C4: [nome do diretório]
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique as melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.

Visão Geral

• Nome: [Nome descritivo para este diretório de código]
• Descrição: [Breve descrição do que este código faz]
• Localização: [Link para o caminho real do diretório]
• Linguagem: [Linguagem(ns) de programação principal(is)]
• Propósito: [O que este código realiza]

Elementos de Código

Funções/Métodos

• functionName(param1: Type, param2: Type): ReturnType
  • Descrição: [O que esta função faz]
  • Localização: [caminho do arquivo:número da linha]
  • Dependências: [do que esta função depende]

Classes/Módulos

• ClassName
  • Descrição: [O que esta classe faz]
  • Localização: [caminho do arquivo]
  • Métodos: [lista de métodos]
  • Dependências: [do que esta classe depende]

Dependências

Dependências Internas

• [Lista de dependências de código internas]

Dependências Externas

• [Lista de bibliotecas, frameworks, serviços externos]

Relacionamentos

Diagramas opcionais de Mermaid para estruturas de código complexas. Escolha o tipo de diagrama com base no paradigma de programação. Diagramas de código mostram a estrutura interna de um único componente.

Código Orientado a Objetos (Classes, Interfaces)

Use classDiagram para código OOP com classes, interfaces e herança:

---
title: Code Diagram for [Component Name]
---
classDiagram
    namespace ComponentName {
        class Class1 {
            +attribute1 Type
            +method1() ReturnType
        }
        class Class2 {
            -privateAttr Type
            +publicMethod() void
        }
        class Interface1 {
            <<interface>>
            +requiredMethod() ReturnType
        }
    }

    Class1 ..|> Interface1 : implements
    Class1 --> Class2 : uses

### Functional/Procedural Code (Modules, Functions)

For functional or procedural code, you have two options:

**Option A: Module Structure Diagram** - Use `classDiagram` to show modules and their exported functions:

```mermaid
---
title: Estrutura do Módulo para [Nome do Componente]
---
classDiagram
    namespace ProcessamentoDados {
        class validadores {
            <<module>>
            +validarEntrada(dados) Resultado~Dados, Erro~
            +validarEsquema(esquema, dados) bool
            +sanitizar(entrada) string
        }
        class transformadores {
            <<module>>
            +parseJSON(bruto) Registro
            +normalizar(dados) DadosNormalizados
            +agregar(itens) Resumo
        }
        class io {
            <<module>>
            +lerArquivo(caminho) string
            +escreverArquivo(caminho, conteudo) void
        }
    }

    transformadores --> validadores : usa
    transformadores --> io : lê de
```

**Option B: Data Flow Diagram** - Use `flowchart` to show function pipelines and data transformations:

```mermaid
---
title: Pipeline de Dados para [Nome do Componente]
---
flowchart LR
    subgraph Entrada
        A[lerArquivo]
    end
    subgraph Transformação
        B[parseJSON]
        C[validarEntrada]
        D[normalizar]
        E[agregar]
    end
    subgraph Saída
        F[escreverArquivo]
    end

    A -->|string bruta| B
    B -->|dados analisados| C
    C -->|dados válidos| D
    D -->|normalizado| E
    E -->|resumo| F
```

**Option C: Function Dependency Graph** - Use `flowchart` to show which functions call which:

```mermaid
---
title: Dependências de Função para [Nome do Componente]
---
flowchart TB
    subgraph API Pública
        processarDados[processarDados]
        exportarRelatorio[exportarRelatorio]
    end
    subgraph Funções Internas
        validar[validar]
        transformar[transformar]
        formatar[formatar]
        cache[memoizar]
    end
    subgraph Utilitários Puros
        compor[compor]
        encadear[encadear]
        curry[curry]
    end

    processarDados --> validar
    processarDados --> transformar
    processarDados --> cache
    transformar --> compor
    transformar --> encadear
    exportarRelatorio --> formatar
    exportarRelatorio --> processarDados
```

### Escolhendo o Diagrama Correto


…