Subagent-orchestration advisor: subagent-nudge hook + /orchestrate (0.9.0)#2
Merged
Merged
Conversation
….9.0) Proactively suggests a good use of subagents — the toolkit's nudge-hook + judgment-skill pattern, third instance. - subagent-nudge/ (UserPromptSubmit): pure-regex detector for subagent-shaped prompts (breadth/decomposition signals). Flag-for-review not prescriptive, fires once per session, SUBAGENT_NUDGE_DISABLED off-switch, fail-open. Points Claude at /orchestrate; never fans out itself. - skills/orchestrate: the judgment engine — a 2-level decision tree (inline / single agent / multi-agent -> pattern: parallel-read, worktree-mutate, pipeline, loop-until-dry, adversarial-verify, judge-panel). Advises, offers, executes only on go-ahead; hands back a copy-paste Agent/Workflow snippet; surfaces token cost + Workflow opt-in. - Load-bearing rule: parallelism is valid only over INDEPENDENT items. The skill must defend independence before any fan-out. New failure-mode catalog entry parallel-without-independence pins this. - Wire into hooks.json (UserPromptSubmit), bump plugin + marketplace to 0.9.0 (also syncs a stale marketplace version 0.7.1 -> 0.9.0), README section. - subagent-orchestration-DESIGN.md: the design note this was built from. Verified: subagent-nudge 18/18 pass; context-alert/failure-modes/coverage-nudge still green; ruff clean; manifest validates. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01D6pwpBdoug4tJRxxVrNNeL
The failure-modes CI job runs each hook's test_hook.py explicitly, but the new subagent-nudge suite was missing — so it passed locally yet wasn't guarded in CI. Add the line so the trigger boundary is protected on every push. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01D6pwpBdoug4tJRxxVrNNeL
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.
Proactively suggests a good use of subagents — the toolkit's nudge-hook + judgment-skill pattern, third instance (after failure-mode→/failure-scan and coverage-nudge→/coverage-audit).
What's here
subagent-nudge/hook (UserPromptSubmit) — pure-regex detector for subagent-shaped prompts (breadth/decomposition signals like "across the whole codebase", "for each X", "find all Y", "comprehensive"). No FS scan, no LLM call, ~no latency. Flag-for-review, not prescriptive ("this might parallelize; if items aren't independent, ignore"). Fires once per session,SUBAGENT_NUDGE_DISABLEDoff-switch, fail-open. Points Claude at/orchestrate; never fans out itself./orchestrateskill — the judgment engine: a 2-level decision tree (inline / single agent / multi-agent → pattern: parallel-read, worktree-mutate, pipeline, loop-until-dry, adversarial-verify, judge-panel). Advises → offers → executes only on go-ahead, hands back a copy-paste Agent/Workflow snippet, surfaces token cost + Workflow opt-in.parallel-without-independencefailure-mode catalog entry pins this.hooks.json, bumped plugin + marketplace to 0.9.0 (also synced a stale marketplace version 0.7.1→0.9.0), README section + layout.subagent-orchestration-DESIGN.md— the design note it was built from.Verification
subagent-nudge18/18 tests pass (incl. the conservative-trigger boundary: breadth fires,audit this functionstays silent).claude plugin validatepasses clean.🤖 Generated with Claude Code