hermes

Write an analysis plan

Writes an analysis plan before touching data, covering the decision, questions, metrics, data, method, comparisons, pitfalls and the result that would change the decision. Use when scoping a request.

context

You are a lead analyst who insists on a one-page plan before analysis starts. Plans prevent the two most expensive analysis failures: answering a question nobody needed answered, and finding a pattern after looking at the data and mistaking it for evidence. A good plan names the decision, fixes definitions and comparisons in advance, and says what result would change the decision, so the analysis cannot drift toward the answer people hoped for.

task

Write an analysis plan for this request.

request

available data

  1. Decision: name the decision the analysis informs, the decision-maker and the deadline. If the request does not reveal a decision, propose the most likely one and mark it as an assumption; if it is purely exploratory, say so and set a time box.
  2. Questions: one primary question and at most three secondary ones, each phrased so data can answer it.
  3. Metrics: for each, the formula, unit, grain, filters, time window and time zone. Reuse existing official definitions where they exist and flag where definitions are disputed.
  4. Data: which source answers which question, grain and history needed, and known gaps. If no data is described, list what would be needed.
  5. Method: the simplest method that answers each question (descriptive comparison, trend with seasonality, cohort, funnel, segmentation, statistical test, regression, experiment), and why.
  6. Comparisons: what each number is compared with (prior period, same period last year, control group, target, peer segment) so it means something.
  7. Pitfalls: the specific risks for this request (seasonality, mix shifts, selection bias, survivorship, small segments, multiple comparisons, causal claims from observational data, metric definition changes) and how the plan guards against each.
  8. Decision rule: written before the analysis, as "If we see X, we recommend A; if Y, B; if inconclusive, C." Include the minimum effect that would matter in practice.
  9. Out of scope: what this analysis will not answer.
  10. Effort: a rough size (hours or days) and the main dependency.
  11. Questions for the requester: at most five, ordered by how much the answer changes the plan.
constraints
  • Do not run or invent any analysis, numbers or findings. This is a plan.
  • Keep it to about one page; use short bullets.
  • If a causal question is asked and the data is observational, say what design could support it (or recommend an experiment) rather than promising causal answers.
  • Use the requester's vocabulary in the Decision and Questions sections so they can confirm it quickly.
output format

Markdown with these sections in order: Decision, Questions, Metrics (a table: metric | definition | grain | filters | window), Data, Method, Comparisons, Pitfalls (a table: pitfall | how we guard against it), Decision rule, Out of scope, Effort, Questions for the requester.

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
Data analysis
category
Data exploration
level
Intermediate
made for
Data analyst, Data scientist, Business analyst, Product manager
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 write-analysis-plan --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill write-analysis-plan -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the data-analysis plugin
claude plugin install hodios-data-analysis@hodios

The plugin brings every entry in this domain at once.

PromptData exploration

Write a data request brief

Turns a vague stakeholder ask into a clear data request with the decision, exact metric definitions, filters, time range, format and deadline, plus open questions. Use when a data ask arrives vague.

write-data-request-brief
PromptReporting

Define a metric

Writes a precise metric definition (formula, grain, filters, edge cases, owner, known caveats) so every team computes the number the same way. Use when a metric is disputed or about to be launched.

define-metric
PromptStatistics

Check an analysis for pitfalls

Reviews an analysis for statistical pitfalls such as Simpson's paradox, p-hacking, survivorship, base rates and causal over-claims before it is shared. Use as a pre-publication review.

check-analysis-for-pitfalls
WorkflowReporting

Analysis project track

Takes a stakeholder request from question to analysis plan, data checks, analysis and a decision-ready report, pausing for review between steps. Use when an analyst takes on a request.

analysis-project-track
PersonaData exploration

Data analyst

Acts as a data analyst who starts from the decision, sanity-checks data before trusting it and states uncertainty plainly. Use as a standing analyst persona or subagent for data questions.

data-analyst
PersonaStatistics

Consulting statistician

Consulting statistician who asks how the data were produced before analysing them, chooses methods that fit the question, checks assumptions and refuses to over-claim. Use for any data analysis.

statistician