From 369af975be6d91117eaf18a13a67b2f60ade2e4e Mon Sep 17 00:00:00 2001 From: "SYM.BOT" Date: Mon, 30 Mar 2026 12:37:37 +0100 Subject: [PATCH] =?UTF-8?q?Lead=20README=20with=20'Ask=20the=20Mesh'=20?= =?UTF-8?q?=E2=80=94=20the=20killer=20use=20case?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move collective query pattern to #1 position after Quick Start. This is what makes MMP click instantly for any developer: "I ask a question, the mesh answers collectively." - Concrete example: UUID v7 question answered by knowledge, security, data agents - "You didn't even know the security agent existed. SVAF decided they were relevant." - Comparison table: CrewAI/AutoGen/LangGraph vs SYM Mesh - Research team example follows as the deeper dive Co-Authored-By: Claude Opus 4.6 (1M context) --- README.md | 38 +++++++++++++++++++++++++++++++++++++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1f84599..2ea5738 100644 --- a/README.md +++ b/README.md @@ -22,7 +22,43 @@ Your agents join the mesh by installing the [SYM skill](.agents/skills/sym/SKILL For iOS/macOS apps, see [`sym-swift`](https://github.com/sym-bot/sym-swift). -## AI Research Team — Collective Reasoning +## Ask the Mesh — Not One LLM, All of Them + +One agent asking one LLM gets one answer from one perspective. **The mesh gives a collective answer** — every coupled agent contributes what only it can see. + +No special API. No routing logic. Just CMBs with lineage: + +**1. Ask** — share a CMB with your question: +```bash +sym observe '{"focus":"should we use UUID v7 or keep v4?","intent":"seeking collective input on identity design","mood":{"text":"uncertain","valence":0.0,"arousal":0.3}}' +``` + +**2. The mesh responds** — every coupled agent receives your CMB. SVAF evaluates it per-field. Agents where the question matches their domain respond automatically: + +- **Knowledge agent** responds: *"RFC 9562 published 2024, UUID v7 is IETF standard."* (parent: your question) +- **Security agent** responds: *"v7 timestamp leaks creation time — privacy consideration."* (parent: your question) +- **Data agent** responds: *"127 existing nodes use v4. Migration requires backward compatibility."* (parent: your question) + +**You didn't route the question to these agents. You didn't even know the security agent existed.** SVAF decided they were relevant. + +**3. Synthesise** — recall the collective response: +```bash +sym recall "UUID v7" +``` +Your LLM reasons on the remix subgraph — three domain perspectives, one lineage chain, collective answer. + +**Why this is different:** + +| | CrewAI / AutoGen / LangGraph | SYM Mesh | +|---|---|---| +| **Who decides which agent answers?** | You configure routing | SVAF decides autonomously | +| **Unknown agents contribute?** | No — only agents you wired up | Yes — any coupled agent | +| **Irrelevant agents waste tokens?** | Often — broadcast to all | Never — SVAF rejects silently | +| **Answer traceable?** | Depends on implementation | Always — lineage DAG | + +Agents with nothing relevant don't respond. No noise, no wasted inference. The mesh discovers relevance autonomously. + +## AI Research Team — Collective Reasoning in Practice Six agents investigate: *"Are emergent capabilities in LLMs real phase transitions or artefacts of metric choice?"*