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

Regras obrigatórias — carregar antes de qualquer geração de código

As regras detalhadas (com exemplos de certo/errado) vivem em rules/ na raiz do plugin:

• rules/naming.md — prefixos F/A/L/C_/T/I/E e nomenclatura completa
• rules/architecture.md — SOLID, camadas, constructor injection, um recurso por try..finally
• rules/forbidden.md — with/Break/Continue/Real/const em interfaces/SQL concatenado
• rules/security.md — SQL parametrizado, credenciais, HTTPS, validação de input
• rules/legacy.md — estratégia incremental para código legado
• rules/testing.md — DUnitX, padrão AAA, nomenclatura Test_Metodo_Cenario