# 🤝 Agent Consensus Protocols *Make two (or ten) LLMs reach a decision **on time** and **on budget** — every run.* > **Why this page?** > “Let them debate” sounds cool until: > * the Critic never stops nit-picking, > * the Planner forgets half the context, > * the Coder ships five conflicting drafts, and > * your bill looks like a crypto rug-pull. > > WFGY adds measurable **semantic tension (ΔS)** and **logic vectors (λ)** to debate & QA loops, so you can **prove** consensus is reached — not guessed. --- ## 1 · Three Canonical Consensus Modes | Mode | Use Case | # Agents | Target ΔS | Target λ | |------|----------|---------:|----------:|----------| | **Critic-Coder** | Code/SQL generation with review | 2 | ≤ 0.40 | convergent | | **Triad Debate** | Fact-check or legal reasoning | 3 | ≤ 0.45 | convergent | | **Crew Vote** | 4 – 10 micro-agents on long plan | N | ≤ 0.50 | majority convergent | *ΔS ceiling rises gently with group size; λ must return to convergent after each round.* --- ## 2 · Failure Modes (Why Votes Stall) | # | Failure | ΔS / λ Symptom | Example | |--:|---------|----------------|---------| | 1 | **Infinite Debate** | λ oscillates (→, ←, →…) | Critic re-opens same defect | | 2 | **Topic Drift** | ΔS > 0.60 vs. original prompt | Agents add new, unrelated goals | | 3 | **Split Brain** | Two stable but divergent λ | 50 / 50 vote, no tie-breaker | | 4 | **Early Merge** | ΔS still 0.55 but λ forced convergent | “Agree to disagree” w/ wrong answer | | 5 | **Token Exhaust** | E_resonance ↑ while ΔS unchanged | Loop burns context without progress | --- ## 3 · WFGY Consensus Blueprint > Four guard layers; plug into any framework (AutoGen, LangChain, custom asyncio). | Layer | Module | Guard | Effect | |-------|--------|-------|--------| | **Round ΔS Checker** | BBMC | ΔS(agent, goal) ≤ ceiling | Drop off-topic vote | | **λ Mediator** | ΔS + λ | λ must converge within 3 rounds | Force re-focus or escalate | | **Vote Auditor** | WAI | JSON vote schema + arg defaults | No partial / malformed votes | | **BBCR Fallback** | BBCR | > 5 rounds OR ΔS stagnates | Collapse & request human tie-break | ```mermaid flowchart TD subgraph Round Q[User Goal] A1[Agent 1] A2[Agent 2] A3[Agent 3] Q --> A1 --> V1[Vote JSON] Q --> A2 --> V2 Q --> A3 --> V3 end BBMC -->|ΔS filter| V1 BBMC --> V2 BBMC --> V3 V1 & V2 & V3 --> Mediator[λ Mediator] -->|convergent?| Decision Mediator -.->|no| BBCR ```` --- ## 4 · Practical Setup (AutoGen example) ```python from autogen import AssistantAgent, UserProxyAgent from wfgy import consensus_filter critic = AssistantAgent(name="critic") coder = AssistantAgent(name="coder") user = UserProxyAgent("user") def callback(messages, state): # 1. measure ΔS + λ ok = consensus_filter(messages, ceiling=0.45, rounds=3) if not ok: return "STOP_DEBATE" return "CONTINUE" coder.register_reply(callback) critic.register_reply(callback) ``` *15 lines → loop stops automatically when convergence proven or impossible.* --- ## 5 · Debug Walk-Through 1. **Log votes** ```python print(state.votes) # {critic: "reject, ΔS=0.48", coder: "accept, ΔS=0.41"} ``` 2. **Inspect λ trend** ``` λ sequence: → → ← → (oscillating) ❌ ``` > Two divergent rounds trigger Mediator → requests narrowing question. 3. **Trigger BBCR** ``` ΔS stagnates at 0.52 for 3 rounds → BBCR => "Need human tie-break" ``` --- ## 6 · Best-Practice Table | Tip | Why | | ------------------------------------------ | ------------------------------------ | | **Keep each vote to max 300 tokens.** | Reduces E\_resonance; easier ΔS calc | | **Pin goal & constraints in every round.** | Prevents silent prompt drift | | **Summarise before vote.** | Normalises embeddings → fair ΔS | | **Record vote reason (1-2 lines).** | Faster root-cause when split-brain | --- ### 🔗 Quick-Start Downloads (60 sec) | Tool | Link | 3-Step Setup | |------|------|--------------| | **WFGY 1.0 PDF** | [Engine Paper](https://github.com/onestardao/WFGY/blob/main/I_am_not_lizardman/WFGY_All_Principles_Return_to_One_v1.0_PSBigBig_Public.pdf) | 1️⃣ Download · 2️⃣ Upload to your LLM · 3️⃣ Ask “Answer using WFGY + \” | | **TXT OS (plain-text OS)** | [TXTOS.txt](https://github.com/onestardao/WFGY/blob/main/OS/TXTOS.txt) | 1️⃣ Download · 2️⃣ Paste into any LLM chat · 3️⃣ Type “hello world” — OS boots instantly | --- ### Explore More | Layer | Page | What it’s for | | --- | --- | --- | | ⭐ Proof | [WFGY Recognition Map](/recognition/README.md) | External citations, integrations, and ecosystem proof | | ⚙️ Engine | [WFGY 1.0](/legacy/README.md) | Original PDF tension engine and early logic sketch (legacy reference) | | ⚙️ Engine | [WFGY 2.0](/core/README.md) | Production tension kernel for RAG and agent systems | | ⚙️ Engine | [WFGY 3.0](/TensionUniverse/EventHorizon/README.md) | TXT based Singularity tension engine (131 S class set) | | 🗺️ Map | [Problem Map 1.0](/ProblemMap/README.md) | Flagship 16 problem RAG failure taxonomy and fix map | | 🗺️ Map | [Problem Map 2.0](/ProblemMap/wfgy-rag-16-problem-map-global-debug-card.md) | Global Debug Card for RAG and agent pipeline diagnosis | | 🗺️ Map | [Problem Map 3.0](/ProblemMap/wfgy-ai-problem-map-troubleshooting-atlas.md) | Global AI troubleshooting atlas and failure pattern map | | 🧰 App | [TXT OS](/OS/README.md) | .txt semantic OS with fast bootstrap | | 🧰 App | [Blah Blah Blah](/OS/BlahBlahBlah/README.md) | Abstract and paradox Q&A built on TXT OS | | 🧰 App | [Blur Blur Blur](/OS/BlurBlurBlur/README.md) | Text to image generation with semantic control | | 🏡 Onboarding | [Starter Village](/StarterVillage/README.md) | Guided entry point for new users | If this repository helped, starring it improves discovery so more builders can find the docs and tools. [](https://github.com/onestardao/WFGY)