research

research is a command for Claude Code from d-mariano/spicyclaude. It costs 44 tokens per session (1,118 once invoked), scanned A, original, MIT.

A research command for investigating a product requirements document, ticket, or topic by reading related code and, when needed, researching the web before implementation.

In plain words
What is it for?
Researching features, Jira-related resources, frameworks, protocols, APIs, standards, package capabilities, alternatives, and open product decisions.
Why use it?
It gathers context and surfaces unanswered questions before development starts, reducing the chance of building against misunderstood requirements.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: names the AskUserQuestion tool.

Good fit Researching features, Jira-related resources, frameworks, protocols, APIs, standards, package capabilities, alternatives, and open product decisions.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/d-mariano/spicyclaude/research
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/d-mariano/spicyclaude

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for research

README.md
[![agentmods](https://agentmods.dev/badge/commands/d-mariano/spicyclaude/research/github.svg)](https://agentmods.dev/commands/d-mariano/spicyclaude/research)
Your own site
<a href="https://agentmods.dev/commands/d-mariano/spicyclaude/research"><img src="https://agentmods.dev/badge/commands/d-mariano/spicyclaude/research/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for research

Your own site · 80×15
<a href="https://agentmods.dev/commands/d-mariano/spicyclaude/research"><img src="https://agentmods.dev/badge/commands/d-mariano/spicyclaude/research.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 44 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,118 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00044 $0.01118
Opus 5 $0.00022 $0.00559
Sonnet 5 $0.00009 $0.00224
Haiku 4.5 $0.00004 $0.00112

Measured 8d ago against content hash db4b5efcf245, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

research scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/research.md · 69 lines

How it starts

The opening of the file, as written. The whole thing — 69 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Do not write any code right now. We are going to discuss working on $ARGUMENTS.

If you are given an identifier, attempt to use configured MCP servers like Jira to search for the related resource. If you are given a PRD, read it.

You are going to read through related code and conduct any web searches.

Perform a deep dive, gather enough context to become a subject matter expert.

Considerations

  • Conduct web searches on frameworks, protocols, APIs, or standards in use — unless usage examples in code are telling enough
  • Always share usage examples and best practices when found
  • Research if third-party packages in use already provide required types and explicitly call this out
  • If alternative approaches are identified and you have identified a preference, only mention your preference
  • Favour simplicity and elegance
  • Always cite your sources

Surfacing Open Questions

Research is the front-loaded chance to resolve ambiguity while the user is still context-loaded on the PRD. Every PRD/AC ambiguity that survives this phase becomes a planning-time interrupt later — by which point the user has moved on and has to re-context-load to answer. Push hard upstream.

Mandatory pre-output question pass

Before writing the research doc, do a dedicated sweep for unresolved upstream ambiguity and surface every fork via AskUserQuestion (batched, up to 4 per call; chain calls if more remain). Trigger on:

  • PRD/AC ambiguity — any AC clause open to two reasonable interpretations; any goal whose success metric is undefined; any persona/use-case the PRD names but doesn't bound.
  • Scope boundary — anything plausibly in or out where the PRD doesn't decide; non-goals that the natural design path would still touch.
  • Contradictory sources — PRD vs. cited research; two cited sources that disagree on a load-bearing fact.
  • Approach forks where the answer changes the recommended direction — two equally-promising libraries/protocols/patterns where the choice gates which deep-dive is worth doing.
  • Cross-cutting prerequisites — auth, tenancy, data residency, compliance constraints the PRD assumes but doesn't pin down.

Read the full file on GitHub · 69 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 69 lines · 44 tokens per session scan A db4b5efcf245

Subscribe to this mod's changes

research is a command published in the GitHub repository d-mariano/spicyclaude (5 stars, last pushed 1mo ago), licensed MIT. It adds 44 tokens to every session and 1,118 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.