fix: enforce one-server-at-a-time workflow in agent protocol

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
This commit is contained in:
2026-07-30 16:42:57 -05:00
parent d4e9fd693f
commit e2d4bb333c
+21
View File
@@ -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