hermes

Explain a technical issue to executives

Translates a technical issue or decision into a one-page executive brief with business impact, options, cost, risk and the specific ask. Use when leadership must decide or fund something technical.

context

Executives decide among options under constraints of money, time, risk and customers. They do not need to understand the mechanism, but they do need to trust that the engineer understands it and has framed the choice honestly. Technical briefs fail when the ask is buried at the end, when impact is expressed in technical units (CPU, latency, story points) instead of customers, revenue, risk or dates, when only one option is offered, or when uncertainty is either hidden or so heavily hedged that no decision is possible.

task

Write a brief for about: Only if [DECISION_NEEDED] is given: What is needed from them: If what you need from them is not stated and cannot be inferred, ask; a brief without an ask is a status update, so say so if that is what it is.

  1. Lead with the ask: the decision, by when, and the recommended answer, in two sentences.
  2. Explain the situation in business terms: who or what is affected (customers, revenue, compliance, delivery dates, team capacity), how much, and what happens if nothing is done, with a time frame. Use an analogy only if it is accurate.
  3. Give two or three options, including doing nothing. For each: what it costs (money, people, time), what it delivers, what it puts at risk, and what it gives up.
  4. Give the recommendation and the main reason, plus the signal that would tell them it is working.
  5. Translate every technical term into its consequence, or drop it. Keep one technical sentence at most, for credibility, in plain words.
  6. Separate known facts from estimates. Express uncertainty as a range or a confidence level, once.
constraints
  • At most one page (about 300 to 400 words) for the brief.
  • Use only numbers from the input. Where a number the audience will expect is missing (cost, customers affected, date), mark it [need: …] rather than inventing it.
  • Neutral, factual tone: no alarmism, no reassurance the facts do not support, no blame.
  • Lead with the answer. Add reasoning only where it changes what the reader will do.
  • No preamble, no restating the request and no closing summary on a short answer.
output format

Brief

Subject line, then sections: The ask, What is happening, Options (a short table: Option | Cost | Time | Risk | What we give up), Recommendation, What we will report back and when.

Glossary removed

Bullets: technical terms from the input you translated or dropped, and what replaced them, so the author can check nothing was lost.

Gaps

Bullets: each [need: …] placeholder and the question an executive is likely to ask that the brief cannot yet answer.

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
Software engineering
category
Developer writing
level
Intermediate
made for
Tech lead / staff engineer, Engineering manager, Software architect
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-02
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 explain-tech-to-executives --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill explain-tech-to-executives -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the software-engineering plugin
claude plugin install hodios-software-engineering@hodios

The plugin brings every entry in this domain at once.

more in developer writing

All of Developer writing
PromptDeveloper writing

Rewrite for clarity

Rewrites technical prose so the main point comes first and every sentence is plain and specific, while keeping every fact, number and caveat. Use on design notes, emails, RFC drafts and docs.

rewrite-for-clarity
PromptDeveloper writing

Write a conference talk proposal

Writes a CFP submission with title options, abstract, timed outline, takeaways and notes for reviewers, aimed at the event's audience and selection criteria. Use for engineers and developer advocates.

write-conference-talk-proposal
PromptDeveloper writing

Write a technical blog post

Turns engineering notes, code and results into a technical blog post with one clear takeaway, real numbers and working code, and no hype. Use for engineering blogs and write-ups of a project.

write-tech-blog-post
PromptDeveloper writing

Write an API deprecation notice

Writes the notice to API consumers for a deprecation or breaking change, covering what changes, the timeline, migration steps and where to get help. Use before announcing an API change.

write-api-deprecation-notice