docs: document minimum Lombok version for builder feature, refs #45 (#46)

Users need Lombok 1.18.2+ when using @GenerateDto(builder = true)
because @SuperBuilder was introduced in that release.

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: soulcodingmatt

docs/dto-builder-pattern.md

@@ -5,7 +5,7 @@ Use this when you want **Lombok’s builder** on generated DTOs. Project Equilib
 ## Prerequisites
 
 - **`@GenerateDto(builder = true)`** on your domain (or API) class.
-- **Lombok** on your classpath and on the **annotation processor path** (see the main README). Project Equilibrium does not replace Lombok; it generates code that Lombok then expands.
+- **Lombok 1.18.2 or higher** on your classpath and on the **annotation processor path** (see the main README). Project Equilibrium does not replace Lombok; it generates code that Lombok then expands. Version 1.18.2 is the minimum because `@SuperBuilder` was introduced in that release.
 
 If you do not need builders, omit `builder` and use constructors and setters instead.
 

docs/ecosystem.md

@@ -17,6 +17,14 @@ Use [MapStruct](https://mapstruct.org/) `@Mapper` interfaces to map between doma
 
 Different modules can standardize on different pieces: for example, generated DTOs in an API module and MapStruct mappers in an adapter layer.
 
+## Lombok version compatibility
+
+Project Equilibrium has **no runtime dependency** on Lombok. When you enable `@GenerateDto(builder = true)`, the processor emits `@SuperBuilder` and `@Builder.Default` annotations into generated source code. Your project's Lombok then expands these during its own annotation processing pass.
+
+- **Minimum Lombok version for builders:** **1.18.2** (`@SuperBuilder` was introduced in this release)
+- **No maximum version constraint** — Equilibrium emits standard Lombok annotations as string literals, so any newer Lombok version that supports `@SuperBuilder` will work
+- **Without builders:** Lombok is entirely optional; Equilibrium has no Lombok dependency
+
 ## Related guides
 
 - [DTO builder pattern](dto-builder-pattern.md) when using Lombok `@SuperBuilder` on generated DTOs