gstack/review
Jayesh Betala 8d79caf178 fix(ask-user): keep question payloads compact (#1208)
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>
2026-06-17 12:34:05 +05:30
..
specialists feat: adaptive gating + cross-review dedup for review army (v0.15.2.0) (#760) 2026-04-04 22:46:21 -07:00
SKILL.md fix(ask-user): keep question payloads compact (#1208) 2026-06-17 12:34:05 +05:30
SKILL.md.tmpl v1.42.0.0 Daegu wave: 23 community-filed bugs + PTY classifier enforcement (24 bisect commits) (#1594) 2026-05-20 07:35:01 -07:00
TODOS-format.md v1.57.5.0 feat: cross-session decision memory + gbrain dream-stage call graph (#1910) 2026-06-08 06:20:58 -07:00
checklist.md feat: Review Army — parallel specialist reviewers for /review (v0.14.3.0) (#692) 2026-03-30 22:07:50 -06:00
design-checklist.md feat: adaptive gating + cross-review dedup for review army (v0.15.2.0) (#760) 2026-04-04 22:46:21 -07:00
greptile-triage.md feat: TODOS-aware skills, 2-tier Greptile replies, gitignore fix (#61) 2026-03-14 20:15:11 -07:00