retro: subagent-as-tool v1 shakedown#187
Open
rdwj wants to merge 1 commit into
Open
Conversation
End-to-end retrospective on the 2026-05-08 session: triage of subagent- as-tool issues, design synthesis for the foundation underneath #163/#164/#166/#168 (#182), demo build (calculus-coordinator delegating to calculus-agent specialist via subagent-as-tool v1), three-model scorecard, and cluster cleanup. Champion model: Ministral 3 14B — only candidate with 6/6 delegation correctness. Granite 4.1 8B partial; Granite 4.0 H-Small blocked on a vLLM hermes-parser bug. Two framework bugs surfaced and filed (#185 observers drop subagent events, #186 transport URL doubling). Patterns to start: sanity-check load-bearing dependencies before declaring end-to-end works; file at the moment of diagnosis. Patterns to stop: batching CLAUDE.md updates at session-close; JSON-Patch index paths against positional arg arrays. Assisted-by: Claude Code (Opus 4.7)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds
retrospectives/2026-05-08_subagent-as-tool-v1-shakedown/RETRO.mddocumenting the 2026-05-08 session that took the just-merged subagent-as-tool v1 (PR #173) through end-to-end production validation.Highlights
/v1/chat/completions).calculus-helperMCP into the missing namespace as the fix.Patterns
Start: sanity-check load-bearing dependencies (specialist endpoints, MCP backends, model availability) before declaring end-to-end works; file issues at the moment of diagnosis (verbal "I'll file" is not a filed issue); visual UI verification on every UI-touching demo; isolate model-can't from prompt-can't with a 30-second curl harness.
Stop: batching CLAUDE.md updates at session-close; JSON-Patch index paths against positional arg arrays.
Continue: foundation-design-before-piecemeal-implementation; reproducible scorecard methodology; surgical cluster operations.
Test plan