Adapt a prompt for a reasoning model
Rewrites a prompt for reasoning-capable models by removing step-by-step micromanagement, stating goals, constraints and success criteria, and keeping the output format exact.
Prompts written for earlier chat models often compensate for weak reasoning: "think step by step", a rigid ten-step procedure, a scratchpad section to fill in, many few-shot examples showing the reasoning. Models that reason internally before answering are guided differently. Provider guidance for these models agrees on the main points: state the goal, the constraints and what success looks like, and let the model plan; prefer high-level instructions to think carefully over prescriptive steps; start zero-shot and add examples only if needed, keeping them consistent with the instructions; use delimiters for inputs; and be exact about the final output, since internal reasoning should not leak into a parsed answer. Hard rules (formats, policies, tool limits) still need stating explicitly; what goes is the micromanagement of how to think.
Adapt this prompt for a reasoning-capable model.
Only if [FAILURE_EXAMPLES] is given:
- Work out the prompt's goal, inputs, deliverable and hard requirements. If the goal cannot be inferred, ask one question and stop.
- Classify every instruction as one of:
- goal or success criterion (keep, sharpen);
- hard constraint: format, policy, length, tool or safety rule (keep, state once, clearly);
- reasoning scaffolding: "think step by step", forced scratchpads, prescribed reasoning order, reasoning-heavy examples (remove or turn into a success criterion);
- procedure that encodes real domain knowledge, such as a required check or a business rule (keep as a requirement, not as a thinking order);
- filler or emphasis (remove).
- Rewrite the prompt: context and goal first, then inputs in delimiters, constraints, explicit success criteria (what a correct answer must satisfy, how to handle ambiguity), and the exact output format with an instruction to return only the final answer in that format.
- Address each failure example with a specific change.
- Propose test inputs that compare old and new, including a simple case (to catch overthinking) and a hard one.
- Keep every placeholder, hard constraint, policy and output field exactly. Changing the output schema breaks whatever consumes it.
- Do not ask the model to show its reasoning in the final answer unless the original output requires an explanation for the user; then ask for a short justification, not the reasoning trace.
- Keep few-shot examples only if they show the output format or a subtle judgement that instructions cannot; trim their reasoning to the answer.
- Model-agnostic: no model names or vendor-only parameters in the prompt. Mention reasoning-effort or thinking-budget settings only as a note for the operator.
- The rewrite is usually shorter. Do not add new requirements.
- Do not claim the new prompt performs better; say how to test it.
Diagnosis
A table: Instruction (quoted, shortened) | Type | Action (keep, rewrite, remove).
Rewritten prompt
The full prompt in one fenced block.
Changes
At most six bullets, most important first, each tied to a failure example where one applies.
Kept on purpose
Bullets for procedures or examples kept, and why.
Test it
Three test inputs, what to compare, and one note on reasoning-effort settings to try.
1 required value still a placeholder; the assistant will ask for it.
details
- kind
- Prompt: a task you run by name to get one finished thing back
- domain
- Prompting and assistants
- category
- Prompt engineering
- level
- Intermediate
- made for
- ML / AI engineer, Software engineer, Product manager
- risk
- read-only
- version
- v1.0.0 · incubating
- reviewed
- 2026-10-03
- works in
- Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai
use in
npx @hermes-hq/hodios install adapt-prompt-for-reasoning-model --target claude-codenpx skills add hermes-hq/hodios-dist --skill adapt-prompt-for-reasoning-model -a claude-codeclaude plugin marketplace add hermes-hq/hodios-distclaude plugin install hodios-prompting@hodiosThe plugin brings every entry in this domain at once.
pairs well with
All of Prompt engineeringImprove a prompt
Diagnoses why a prompt gives weak or inconsistent results and rewrites it with clear context, task, constraints and output format while keeping its intent. Use on any prompt for any AI assistant.
improve-promptBuild a test set for a prompt
Builds a hand-run test set for a prompt with happy, edge and negative inputs, expected behaviour and checkable pass criteria per case, and a scoring sheet to compare prompt versions side by side.
build-prompt-test-setCompress a prompt
Shortens a long prompt while preserving its behaviour, maps every original instruction to where it now lives, reports the real size reduction and lists test inputs to check nothing changed.
compress-promptPrompt engineer
Prompt engineer who writes clear, testable instructions, iterates against real examples and evals, and avoids model-specific tricks. Use for designing, debugging and maintaining prompts.
prompt-engineerCreate few-shot examples
Builds a small set of diverse, representative few-shot examples for a task, including tricky and negative cases, balanced so the model learns the rule rather than copying surface patterns.
create-few-shot-examplesDesign a prompt chain
Splits a complex task into a chain of focused prompts with defined inputs and outputs, checks between steps, failure handling and a test plan. Use when automating multi-step work with AI.
design-prompt-chain