Skip to content

docs(rewrite-worker): require Haiku for the mechanism-3 rewrite subagent - #153

Merged
bodencrouch merged 4 commits into
masterfrom
docs/rewrite-worker-haiku-model-requirement
Jul 30, 2026
Merged

docs(rewrite-worker): require Haiku for the mechanism-3 rewrite subagent#153
bodencrouch merged 4 commits into
masterfrom
docs/rewrite-worker-haiku-model-requirement

Conversation

@bodencrouch

Copy link
Copy Markdown
Contributor

Summary

Requested: ensure the parent agent invoking the mechanism-3 rewrite-worker skill is thoroughly aware the actual rewrite-producing subagent must run on a small model (Haiku), not whatever model the orchestrating session happens to be on.

Made this unmissable at three separate points in .claude/skills/agentdecompile-rewrite-worker/SKILL.md:

  • A prominent banner right after the intro, before any procedure steps
  • The exact dispatch step (step 4) where the Agent tool call happens
  • The "What NOT to do" list, restated a third time deliberately since "inherit the parent's model" is the natural mistake

Also added the same guidance to docs/solutions/architecture-patterns/rewrite-queue-subagent-fulfillment.md so it's discoverable from the durable pattern doc, not just the skill file.

Rationale: the subagent's task is a single bounded text transformation (rewrite one already-compiling C function into an alternate spelling) with no quality upside from a larger model, and a real --autonomous campaign can trigger this dispatch many times — the cost/latency difference compounds.

Test plan

  • Docs-only change, no code affected
  • Verified the Haiku requirement appears in the rendered skill file at all three intended locations

🤖 Generated with Claude Code

https://claude.ai/code/session_01Ros3797gzvmswnJudQ1Znk

Copilot added 4 commits July 30, 2026 05:48
Makes it unmissable at three points (frontmatter description, the exact
dispatch step, and the "what not to do" list) that the Agent subagent
producing the actual rewrite text must always be dispatched on a small/
cheap model (Haiku) -- never the orchestrating /loop session's own model,
and never omitted to "inherit." The task is a single bounded text
transformation (rewrite one already-compiling C function into an
alternate spelling); a real campaign can trigger this dispatch many times,
so a larger model here is pure cost/latency waste with no quality upside.

Also added the same guidance to the durable pattern doc
(docs/solutions/architecture-patterns/rewrite-queue-subagent-fulfillment.md)
so it isn't only discoverable by reading the skill file directly.
# Conflicts:
#	.claude/skills/agentdecompile-rewrite-worker/SKILL.md
@bodencrouch
bodencrouch merged commit b800e7a into master Jul 30, 2026
24 checks passed
@bodencrouch
bodencrouch deleted the docs/rewrite-worker-haiku-model-requirement branch July 30, 2026 20:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant