docs: update documentation, refs #6

Author: soulcodingmatt

README.md

@@ -64,6 +64,8 @@ public class User {
 
 👉 Extended copy-paste flow: [Quickstart](docs/quickstart.md).
 
+🧪 **Working example project:** [equilibrium-test](https://github.com/soulcodingmatt/equilibrium-test) — a ready-to-clone project that demonstrates how the annotations work in practice.
+
 ---
 
 ## How it works

docs/README.md

@@ -2,6 +2,8 @@
 
 Guides in this folder go deeper than the [root README](../README.md). Start there for the overview and quickstart; use these pages when you need full detail.
 
+**Working example project:** [equilibrium-test](https://github.com/soulcodingmatt/equilibrium-test) — clone and run to see the annotations in action.
+
 |                                    Guide                                    |                                        What it covers                                         |
 |-----------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------|
 | [Why Project Equilibrium?](why-equilibrium.md)                              | Benefits, when to use it, when to pick something else                                         |

docs/quickstart.md

@@ -64,4 +64,6 @@ After `mvn compile`, you get a type such as `com.example.dto.UserDto` (package a
 
 **Done** — no hand-maintained DTO stub for that class.
 
+**Want to see it in action?** Clone the [equilibrium-test](https://github.com/soulcodingmatt/equilibrium-test) project for a ready-to-run example that demonstrates the annotations in a real Maven build.
+
 Next: [Annotations reference](annotations-reference.md) for ignores, multiple variants, nesting, and records/VOs.