Follow-up to v1.6.2.0. Codex (GPT-5.4) under the gpt.md overlay
treated "No preamble / Prefer doing over listing" as license to skip
the Simplify paragraph and the RECOMMENDATION line on AskUserQuestion
calls. Users had to manually re-prompt "ELI10 and don't forget to
recommend" almost every time.
Two layers:
1. model-overlays/gpt.md — adds an explicit "AskUserQuestion is NOT
preamble" carve-out. The "No preamble" rule applies to direct
answers; AskUserQuestion content must emit the full format
(Re-ground, Simplify/ELI10, Recommend, Options). Tells the model:
if you find yourself about to skip any of these, back up and emit
them — the user will ask anyway, so do it the first time.
2. scripts/resolvers/preamble/generate-ask-user-format.ts — step 2
renamed to "Simplify (ELI10, ALWAYS)" with explicit "not optional
verbosity, not preamble" framing. Step 3 "Recommend (ALWAYS)"
hardened: "Never omit, never collapse into the options list."
All T2 skills regenerated across all hosts. Golden fixtures refreshed
(claude-ship, codex-ship, factory-ship). Updated the ELI10 assertion
in test/gen-skill-docs.test.ts to match the new wording.
Codex compliance to be verified empirically via test/codex-e2e-plan-format.test.ts.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
028627fbcd