Rework core integration: validated capability layer, docs, and session state

README.md

@@ -228,6 +228,19 @@ Veskslop stands on the shoulders of legends:
 
 GPL-3.0-or-later. See [LICENSE](LICENSE). Fork responsibly, ship slop ethically.
 
+## 🛠️ Development
+
+This project runs the real Vesktop client and controls it through a small, validated capability
+layer. All logic lives in an external daemon.
+
+Start here:
+
+- [docs/INDEX.md](docs/INDEX.md) — all design documents
+- [AGENTS.md](AGENTS.md) — rules for agents and contributors
+- [poc/README.md](poc/README.md) — daemon run commands
+- [docs/core-bridge.md](docs/core-bridge.md) — the capability layer
+- [docs/daemon.md](docs/daemon.md) — the MCP daemon
+
 <div align="center">
 
 <br />