CLAUDE.md

1# Delphi AI Spec-Kit
2 
3This is the **Delphi AI Spec-Kit**, the master guide for Delphi (Object Pascal) development in this repository.
4 
5## Project Stack
6- **Language:** Object Pascal (Delphi)
7- **Native IDE:** RAD Studio / Delphi
8- **Main Frameworks:** VCL, FMX, FireDAC
9- **Tests:** DUnitX
10- **Build / Tooling:** MSBuild, dcc32/dcc64, Boss (Package Manager)
11 
12## Crucial Directives (Memory Management)
13- **Watched Blocks (Required):** EVERYTHING you instantiate with `.Create` (if it is `TObject` and does not have `Owner`) **MUST** have a `try..finally` on the IMMEDIATELY subsequent line.
14```pascal
15  Obj := TMyClass.Create;
16  try
17    Obj.DoSomething;
18  finally
19    Obj.Free; //my FreeAndNil(Obj)
20  end;
21```
22- **DO NOT use** `with`.
23- **DO NOT create** God Classes. Use SOLID Principles.
24- Isolate visual components (FMX/VCL) from strict business rules. Do not access DBGrid or form edits in pure logical units.
25- For dependency injection, pass abstractions in the constructor.
26 
27## File Organization & Naming (PascalCase)
28- Classes: Start with `T` (ex: `TCustomer`).
29- Interfaces: Start with `I` (ex: `ICustomer`).
30- Exceptions: Start with `E` (ex: `EValidationError`).
31- Private attributes or fields: Start with `F` (ex: `FName`).
32- Local variables: Start with `L` (ex: `LCustomer`).
33- Parameters: Start with `A` (ex: `ACustomer`).
34- Unit nomenclature: `NomeProjeto.Camada.Dominio.Funcionalidade.pas`
35 
36*(See the `AGENTS.md` global file and `rules/` folder for guidelines specific to frameworks such as FireDAC, Rest, Horse and Database).*
37