Inline technique handling: calls between techniques resolve, get checked, and arrive as steps - #466
Draft
m2ux wants to merge 1 commit into
Draft
Inline technique handling: calls between techniques resolve, get checked, and arrive as steps#466m2ux wants to merge 1 commit into
m2ux wants to merge 1 commit into
Conversation
Seed commit anchoring the draft PR for the inline-technique handling work package of epic #397 (protocol structure: alternatives and delegation the server can see). Implementation follows. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
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
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.
Summary
A technique file tells an agent how to carry out one job, and it sometimes tells the agent to go and do what another technique file says. The server reads that sentence as ordinary prose, so this work package makes the reference resolve, checks the values handed across it, and delivers the called file alongside the caller.
🐛 Issue 📐 Engineering
Motivation
When one technique file tells the agent to apply another, nothing follows that instruction through. The reference is not resolved, the values handed across are never compared against what the receiving file declares it needs, and the receiving file is never delivered — the agent is handed a raw file path in the middle of a sentence and improvises the rest. A survey of all 554 technique files found 118 of these calls. Ninety-nine of them, 84%, are invisible to the activity layer that schedules work, and 56 hand over fewer values than the file they call requires. Every link target exists, so nothing is dangling; the decay is entirely in the contracts, which is exactly the part nothing checks.
Left alone, this class of instruction keeps drifting quietly. Renaming a file, or changing the values it needs, reaches its callers with no warning, and instances of that drift are already in the tree — a caller passing a value under one name to a file that declares it under another, a wrapper that dropped one of its callee's three inputs. About ten entries in the server's core-operations list exist only to compensate for the missing delivery by hand, with nothing keeping them in step with the prose they mirror. One guard even points the wrong way: a technique reached only through an inline call looks unused, so the diagnostic blames the callee instead of the absent delivery path.
The rule that sorts these calls is already settled and recorded. A technique may call another technique when the result stays inside the calling technique's own work; the moment the workflow itself acts on the outcome — a gate reads it, a checkpoint presents it, a loop retries it — the call must become an activity step. The reasoning and the alternatives that were rejected are in the doctrine decision record.
Changes
Implementation (pending):
Scope within epic #397 is confirmed at requirements elicitation before implementation begins.
📌 Submission Checklist
🔱 Fork Strategy
🗹 TODO before merging