From d12c29a5976efabbcad53f7050ffc3b00c6a2471 Mon Sep 17 00:00:00 2001
From: Mr Lyndon Williams <68136524+welshDog@users.noreply.github.com>
Date: Sat, 14 Feb 2026 18:57:34 +0000
Subject: [PATCH] docs: add community feedback call-to-action to README

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index aed3654..140374d 100644
--- a/README.md
+++ b/README.md
@@ -172,6 +172,21 @@ pytest -v
 
 We welcome contributions from everyone, especially neurodivergent developers! Please read our [Contributing Guide](.github/CONTRIBUTING.md) to get started.
 
+## 💬 Community Feedback (5–10 Minute Review)
+
+Want to help shape HyperCode quickly? Start here:
+
+1. Read this README and the [Getting Started Guide](docs/getting_started.md).
+2. Share first impressions:
+   - What feels clear vs confusing?
+   - What excites you most (or least)?
+   - Which part should we simplify first?
+3. Post feedback where maintainers can action it fastest:
+   - [GitHub Issues](https://github.com/welshDog/HyperCode-V2.0/issues) for bugs, feature requests, or clarity gaps.
+   - [GitHub Discussions](https://github.com/welshDog/HyperCode-V2.0/discussions) for open-ended ideas and design debate.
+
+If you have time for a deeper review, see [docs/architecture.md](docs/architecture.md), [docs/security_threat_model.md](docs/security_threat_model.md), and [docs/traceability_matrix.md](docs/traceability_matrix.md), then open a PR or issue with your recommendations.
+
 ---
 
 ## 📜 License