Skip to content

chore(repo): resolve subagent narration + tool-registration failures#55

Merged
Sawmonabo merged 1 commit into
developfrom
chore/subagent-narration-resolve
May 12, 2026
Merged

chore(repo): resolve subagent narration + tool-registration failures#55
Sawmonabo merged 1 commit into
developfrom
chore/subagent-narration-resolve

Conversation

@Sawmonabo
Copy link
Copy Markdown
Owner

Summary

Builds on the guardrails landed in #53.

Test plan

  • Post-restart smoke tests against both agents — filesystem-confirmed Edit/Write effects (housekeeper rewrote target.md + manifest preserving _script_stage; contract-author wrote a Zod schema file)
  • All 393 plan-execution skill tests pass (including the buildHousekeeperPrompt snapshot test that pins the orchestrator's runtime brief)
  • All 411 package tests pass (runtime-daemon 295, control-plane 81, client-sdk 35)
  • pnpm typecheck 8/8 successful, pnpm lint 5/5 clean
  • Zero orphan refs to removed headings / anti-pattern strings across the repo
  • Memory captured at feedback_subagent_authoring_pitfalls documenting both rules + the unknown-root-cause caveat for the YAML parser

🤖 Generated with Claude Code

Two related fixes that unblock plan-execution-housekeeper and
plan-execution-contract-author dispatches.

YAML registration: Claude Code's session-start parser handled
`tools: ["Read", ...]` flow-form inconsistently — same byte format
parsed as a real array for some agents, as a literal string for these
two, leaving zero tools registered ("No such tool available"). Switch
to block-list YAML form so the parser registers the tool array
reliably.

Narration anti-pattern: agent bodies contained literal `Tool: <Name>`
strings in failure-mode warnings and "do not output X" sections.
Opus 4.7's literal instruction following caused the model to emit
those tokens as text content instead of invoking the tool API
(totalToolUseCount: 0 across PR #36 / #42 / #45 / #51 dispatches).
Replace with positive-only action contracts; let the orchestrator's
existing validator (check #13, narration_mode_detected) and
auto-deviation fallback handle the defense-in-depth.

Housekeeper cleanup: consolidate duplicate `## First action (mandatory)`
into `## Manifest contents` so each heading has a single, distinct
purpose.

Validation: post-restart smoke tests exercise both agents end-to-end
(housekeeper edits target.md + writes manifest preserving _script_stage;
contract-author writes a Zod schema file). All 393 plan-execution skill
tests pass (including the buildHousekeeperPrompt snapshot test that
pins the orchestrator's runtime brief), all 411 package tests pass,
typecheck and lint clean.

Builds on the guardrails landed in #53.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Sawmonabo Sawmonabo merged commit a198e0a into develop May 12, 2026
8 checks passed
@Sawmonabo Sawmonabo deleted the chore/subagent-narration-resolve branch May 12, 2026 01: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