From e2d4bb333c202ef8ad15ff24d8f1468c75f9f444 Mon Sep 17 00:00:00 2001
From: reachableceo <charles@turnsys.com>
Date: Thu, 30 Jul 2026 16:42:57 -0500
Subject: [PATCH] fix: enforce one-server-at-a-time workflow in agent protocol
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Agents were attempting to build/validate multiple MCP servers in
parallel, leading to incomplete work that never finished. This adds
a mandatory rule: work on exactly one MCP/LSP server end-to-end
(build, handshake, live client invocation with real data, status
update, commit) before starting the next.

💘 Generated with Crush

Assisted-by: Crush:glm-5.2
---
 AGENTS.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 2721fdc..815c664 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -159,6 +159,27 @@ git config core.hooksPath .githooks
 
 If you cannot complete an item (e.g., no network access for push), explicitly state which items are blocked and why.
 
+## One Server At A Time (MANDATORY)
+
+AI agents MUST work on exactly **one MCP/LSP server at a time, end-to-end** before
+starting the next one. This includes:
+
+1. **Build** the container
+2. **Run** the container and validate the protocol handshake
+3. **Spin up a live Crush or bash session** and actually invoke the server through
+   the real client pipeline
+4. **Observe a successful real tool call** (not just a handshake — an actual tool
+   invocation that returns real data or completes a real action)
+5. **Update STATUS.md and JOURNAL.md** for that server
+6. **Commit and push** before moving on
+
+**NEVER** attempt to build/validate multiple MCP servers in parallel or batch them.
+**NEVER** skip from "built" to the next server without completing steps 3-4 (real
+client invocation with real data).
+
+The pattern of "build all, then validate all" leads to incomplete work that never
+finishes. One server, fully done, then the next.
+
 ## Related Documentation
 
 - [README.md](README.md) - Project overview, server inventory, installation, usage