diff --git a/README.md b/README.md
index d0a2f4f..8776b38 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,14 @@ By default, this installs recommended GitHub Agent Workflow triggers, adds `agen
 sets `COPILOT_GITHUB_TOKEN`, creates branch `ai-gh-aw-setup`, pushes it, and opens a PR. Use
 `--continuous-improvement` to also install selected continuous improvement workflows.
 
+## Who uses this?
+
+See the [full list in the docs](https://elastic.github.io/ai-github-actions/#who-uses-this).
+
+- **Playground**: [elastic/ai-github-actions-playground](https://github.com/elastic/ai-github-actions-playground) — reference implementation with the full workflow suite enabled.
+- **Heavy users**: [strawgate/py-key-value](https://github.com/strawgate/py-key-value)
+- **Light users**: [elastic/beats](https://github.com/elastic/beats), [elastic/integrations](https://github.com/elastic/integrations)
+
 ## License
 
 MIT
diff --git a/docs/index.md b/docs/index.md
index 12f15ae..b39d0e1 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -23,6 +23,27 @@ GitHub Agent Workflows are recommended for all new deployments and ongoing maint
 
 - [Claude Composite Actions (legacy)](workflows/claude-workflows.md)
 
+## Who uses this?
+
+### Playground (featured)
+
+[elastic/ai-github-actions-playground](https://github.com/elastic/ai-github-actions-playground) is the reference implementation — a dedicated test-bed repository that runs the full suite of GitHub Agent Workflows. Start here to see what a fully configured repository looks like.
+
+### Heavy users
+
+These repositories run a broad set of workflows and serve as real-world examples of large-scale adoption:
+
+| Repository | Notes |
+| --- | --- |
+| [strawgate/py-key-value](https://github.com/strawgate/py-key-value) | Python project with broad workflow coverage |
+
+### Light users
+
+| Repository | Notes |
+| --- | --- |
+| [elastic/beats](https://github.com/elastic/beats) | Large Elastic OSS repo using a focused set of workflows |
+| [elastic/integrations](https://github.com/elastic/integrations) | Large multi-package Elastic repo using a focused set of workflows |
+
 ## More
 
 - [Developing](developing.md)