Long decision-brief bodies packed into AskUserQuestion's `question` field
and multi-tab batches make the question card unreadable in panel hosts
(VSCode). The brief belongs in markdown before the call; the tool payload
should stay compact.
generate-ask-user-format.ts now documents, in the Format section:
- the two-part contract (markdown brief, then a compact tool_use payload);
- "Tool payload rules": `question` is one sentence / no newlines / <=80
chars, brief content stays in markdown, batch at most two related
questions/tabs (sequence the rest), and no duplicated trade-off text
between `question` and `options[].description`;
- four matching self-check items.
This grafts only the compact-payload guidance onto the current resolver —
it preserves the Conductor / runtime-failure-fallback content that landed
on main since this PR was first opened.
Regenerated all host SKILL.md variants (--host all) and refreshed the
claude/codex/factory ship golden fixtures so the generated docs carry the
new rules.
Tests: new resolver assertions (compact-question, tab-batching,
no-duplicate-tradeoff, self-check items) and a gen-skill-docs assertion
that the rules reach generated tier 2+ SKILL.md. Affected suites
(resolver-ask-user-format, gen-skill-docs, host-config) green.
Fixes#1208
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
8d79caf178