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:
@@ -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.
|
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
|
## Related Documentation
|
||||||
|
|
||||||
- [README.md](README.md) - Project overview, server inventory, installation, usage
|
- [README.md](README.md) - Project overview, server inventory, installation, usage
|
||||||
|
|||||||
Reference in New Issue
Block a user