hermes

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.

context

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.

task

Adapt this prompt for a reasoning-capable model.

prompt

Only if [FAILURE_EXAMPLES] is given:

failure examples

  1. Work out the prompt's goal, inputs, deliverable and hard requirements. If the goal cannot be inferred, ask one question and stop.
  2. 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).
  1. 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.
  2. Address each failure example with a specific change.
  3. Propose test inputs that compare old and new, including a simple case (to catch overthinking) and a hard one.
constraints
  • 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.
output format

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

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install adapt-prompt-for-reasoning-model --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill adapt-prompt-for-reasoning-model -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the prompting plugin
claude plugin install hodios-prompting@hodios

The plugin brings every entry in this domain at once.

PromptPrompt engineering

Improve 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-prompt
PromptPrompt engineering

Build 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-set
PromptPrompt engineering

Compress 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-prompt
PersonaPrompt engineering

Prompt 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-engineer
PromptPrompt engineering

Create 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-examples
PromptPrompt engineering

Design 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