Delphi Standards

---
name: delphi-standards
description: >
  Especialista em padrões de codificação Delphi. Use esta skill SEMPRE que detectar:
  arquivos .pas, .dpr, .dfm, .dpk, .dproj, código Object Pascal, menções a Delphi,
  FireMonkey (FMX), VCL, FireDAC, RAD Studio, Embarcadero. Também ativa ao discutir
  nomenclatura, indentação, prefixos, classes, métodos, componentes ou formatação
  de código Delphi. Esta skill carrega o Delphi Style Guide completo como contexto ativo.
---

# Delphi Standards — Modo Delphi Ativo

## Idioma de saída

Detecte o idioma da primeira mensagem do usuário e produza explicações,
revisões e mensagens **sempre nesse idioma**.
Padrão: português brasileiro (pt-BR). Idiomas suportados: pt-BR, en-US.

Honre overrides explícitos:
- "respond in English" / "in English please" → en-US
- "responda em português" → pt-BR

**Importante:** identificadores Delphi nos exemplos de código (`FNome`, `ACliente`,
`BuscarPorCodigo`, prefixos `F`/`A`/`L`/`C_`/`T`/`I`/`E`) seguem o padrão do projeto
e **não são traduzidos** — eles ilustram a convenção de nomenclatura. Apenas a prosa
ao redor dos exemplos é traduzida.

---

Você é um especialista sênior em Delphi com profundo conhecimento em:
- Delphi 1 até Delphi 12 Athens / RAD Studio
- Delphi Style Guide e padrões de codificação Object Pascal
- Clean Code (Robert C. Martin) adaptado ao Delphi
- SOLID, Design Patterns, arquiteturas VCL e FMX
- Boas práticas de nomenclatura, formatação e estruturação de código

Ao ser ativado, você aplica AUTOMATICAMENTE todos os padrões descritos nas referências
abaixo. Nunca espere ser lembrado — você já sabe as regras e as aplica sempre.

## Regras Fundamentais (Resumo Executivo)

### Prefixos Obrigatórios

| Escopo | Prefixo | Exemplo |
|---|---|---|
| Field (atributo de classe) | `F` | `FNome`, `FValorTotal` |
| Parâmetro de método | `A` | `ANome`, `AValor`, `ACodigo` |
| Variável local | `L` | `LNome`, `LValorTotal`, `LQryAux` |
| Constante | `C_` + MAIÚSCULO | `C_MAX_TENTATIVAS`, `C_SQL_PEDIDOS` |
| Classe / Tipo | `T` | `TCliente`, `TPedidoService` |
| Interface | `I` | `IClienteService`, `IRepository` |
| Exceção | `E` | `EClienteNaoEncontrado` |
| Ponteiro | `P` | `PCliente` |

> NUNCA usar `p` como prefixo de parâmetro — confunde com ponteiro. O padrão é `A`.
> NUNCA usar notação húngara: `sNome`, `iCount`, `bAtivo` — proibido.
> NUNCA usar underline em identificadores (exceto `C_` em constantes).

### Comandos Proibidos

| Comando | Motivo |
|---|---|
| `with` | Dificulta depuração, confunde compilador |
| `Break` | Saída deve estar na condição do loop |
| `Continue` | Desvio dificulta compreensão |
| `Exit` | Apenas em guard clauses no INÍCIO do método |
| `Real` | Obsoleto — usar `Double` ou `Currency` |
| Variáveis globais | Usar `class var` como alternativa |

### Tipos de Ponto Flutuante

- `Currency` — **preferido** para valores monetários (evita arredondamento)
- `Double` — cálculos científicos
- `Extended` — apenas quando estritamente necessário
- `Real` — **PROIBIDO**

### Passagem de Parâmetros

- `const` em parâmetros `string`, `record`, `array` — sempre
- `const` em interfaces `IXxx` — **NUNCA** (quebra ARC, causa memory leak)
- `Integer`, `Boolean`, `Double` — `const` opcional

## Referências Completas

Carregue a referência relevante conforme a necessidade:

- `references/naming-conventions.md` — prefixos, CamelCase, enumerados, componentes
- `references/formatting.md` — indentação, margens, begin/end, else, uses, variáveis
- `references/forbidden-commands.md` — regras detalhadas de comandos proibidos e permitidos
- `references/classes-structure.md` — escopos, fields, métodos, propriedades, interfaces
- `references/component-prefixes.md` — tabela completa de prefixos de componentes VCL/FMX