delphi-spec-kit copilot-instructions.md

GitHub Copilot — Instructions for Delphi Projects

Contexto

This is a Delphi (Object Pascal) project that follows SOLID principles, clean code and the Object Pascal Style Guide. See AGENTS.md in the project root for the complete convention reference.

General Guidelines

1. Always generate code in Object Pascal (Delphi) unless explicitly requested in another language.
2. Use PascalCase for all identifiers. Lowercase reserved words.
3. Respect the prefixes of the Pascal convention: T (classes), I (interfaces), E (exceptions), F (private fields), A (parameters), L (local variables).
4. Prefer interfaces over concrete classes for dependencies.
5. Use constructor injection for dependency injection.
6. Never put business logic in form event handlers (OnClick, OnChange, etc.). Delegate to services.

Code Style

Indentation and Formatting

• Indentation: 2 spaces (no tabs)
• begin on the same line of if, for, while, with when in a single block
• begin on new line for method implementations
• Limit of 120 characters per line

Unit Sections

Order unit sections according to:

unit Nome;

interface

uses
  { RTL units },
  { Units do projeto };

type
  { Enums e Records }
  { Interfaces }
  { Classes }

implementation

uses
  { Units adicionais só necessárias na implementação };

{ Implementações }

end.

Variable Declaration

// Preferir inline var quando disponível (Delphi 10.3+)
var LCustomer := TCustomer.Create('João');

// Ou declaraction explícita com prefixo L
var
  LCustomer: TCustomer;
  LCount: Integer;

Error Handling

• Use specific exceptions (create exception classes per domain):

  EBusinessRuleException = class(Exception);
  EEntityNotFoundException = class(Exception);
  EValidationException = class(Exception);
  

• Guard clauses at the beginning of the method instead of deep nesting
• Try/finally for memory management
• Try/except only for actual error handling, never for control flow