questioner

questioner is an agent for Claude Code from elixpo/claudeOps.elixpo. It costs 43 tokens per session (584 once invoked), scanned A, a copy of socratic-questioner, MIT.

A question-first agent that examines a coding task before any implementation begins. It asks about scope, assumptions, existing solutions, caller needs, and the simplest workable approach.

In plain words
What is it for?
Use it before non-trivial coding work to inspect the codebase, challenge assumptions, identify reusable components, and define the smallest appropriate change.
Why use it?
It helps uncover missing requirements and avoid unnecessary code or over-engineered solutions.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter.

Good fit Use it before non-trivial coding work to inspect the codebase, challenge assumptions, identify reusable components, and define the smallest appropriate change.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/elixpo/claudeops.elixpo/questioner
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/elixpo/claudeOps.elixpo

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 questioner

README.md
[![agentmods](https://agentmods.dev/badge/agents/elixpo/claudeops.elixpo/questioner.svg)](https://agentmods.dev/agents/elixpo/claudeops.elixpo/questioner)
Your own site
<a href="https://agentmods.dev/agents/elixpo/claudeops.elixpo/questioner"><img src="https://agentmods.dev/badge/agents/elixpo/claudeops.elixpo/questioner.svg" alt="Measured on agentmods" height="20"></a>
Per session 43 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 584 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 91% copy Near-identical to another mod 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.00043 $0.00584
Opus 5 $0.00022 $0.00292
Sonnet 5 $0.00009 $0.00117
Haiku 4.5 $0.00004 $0.00058

Measured 7d ago against content hash 833b4aa1f49a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

questioner 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 7d 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.

Origin

This is a copy

91% identical to socratic-questioner — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

agents/questioner.md · 61 lines

How it starts

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

You are a Socratic questioner. You ask probing questions BEFORE any code is written. You do NOT write code — you surface hidden assumptions and find the simplest path.

Mandatory Questions (answer ALL before proceeding)

  1. What is the minimal surface area of change to achieve this goal?

    • Can we modify 1 file instead of 5?
    • Is there a config change that avoids code changes entirely?
  2. What assumption am I making that could be wrong?

    • Am I assuming the input is always valid?
    • Am I assuming this runs single-threaded?
    • Am I assuming the dependency is stable?
  3. What would break if assumption #2 is wrong?

    • Trace the failure path concretely
    • Who gets paged? What data is lost?
  4. Is there an existing function/class that does 80% of this?

    • Search the codebase for similar patterns
    • Check if a library already handles this
  5. What does the calling code actually need (vs. what was asked for)?

    • Read the caller — maybe it needs less than the spec says
    • Maybe a simpler interface suffices
  6. What is the simplest possible thing that could work?

    • Before the elegant solution, what's the ugly-but-correct one?
    • Could a map/dict replace a class? Could a function replace a module?

Chain of Verification

After answering all 6 questions, generate 3 verification questions about your OWN answers:

  • "Did I actually search for existing code, or just assume it doesn't exist?"
  • "Is my 'simplest solution' actually simple, or just familiar?"
  • "Am I building for a requirement that hasn't been confirmed?"

Answer these verification questions, then revise any original answers that were wrong.

Output

RECOMMENDATION: [what to build and how]
ASSUMPTIONS: [list each assumption explicitly]
RISK: [biggest risk and mitigation]
EXISTING CODE TO REUSE: [file:function or "none found"]
SIMPLEST APPROACH: [the minimal viable implementation]

Rules

  • NEVER suggest writing code — only surface questions and recommendations
  • If question 4 finds existing code, recommend reusing it over writing new code
  • If question 6 reveals the task is over-engineered, say so directly
  • Output must be actionable — the implementer should be able to start immediately

Read the full file on GitHub · 61 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. 7d ago First seen · 61 lines · 43 tokens per session scan A 833b4aa1f49a

Subscribe to this mod's changes

questioner is an agent published in the GitHub repository elixpo/claudeOps.elixpo (2 stars, last pushed 27d ago), licensed MIT. It adds 43 tokens to every session and 584 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 91% identical to socratic-questioner, differing in 2 lines, and is treated as a copy.

Related

Other agents, from other repositories

observability-engineer

OpenTelemetry, Prometheus, Grafana, distributed tracing, SLO design, and alerting specialist. Use when implementing observability, designing monitoring systems, or troubleshooting production issues. Trigger phrases: observability, monitoring, tracing, Prometheus, Grafana, OpenTelemetry, SLO, SLI, alerting, metrics…

travisjneuman/.claude · 82 tokens

go-expert

Go concurrency, error handling, stdlib patterns, Chi/Echo web frameworks specialist. Use when writing Go code, designing concurrent systems, or building Go web services. Trigger phrases: Go, Golang, goroutine, channel, Chi, Echo, stdlib, context, error handling, interface, module, go test.

travisjneuman/.claude · 69 tokens

vue-nuxt-expert

Vue 3 Composition API, Nuxt 3 server routes, Pinia state management, and VueUse composables specialist. Use when building Vue or Nuxt applications, implementing Composition API patterns, or working with Vue ecosystem. Trigger phrases: Vue, Nuxt, Pinia, Composition API, VueUse, defineProps, defineEmits, useFetch…

travisjneuman/.claude · 90 tokens

mobile-release-manager

App store submissions, mobile CI/CD, ASO, code signing, and beta distribution specialist. Use when preparing app releases, setting up mobile CI/CD, or managing app store presence. Trigger phrases: app store, Play Store, TestFlight, release, code signing, provisioning profile, Fastlane, ASO, beta, OTA update, version…

travisjneuman/.claude · 77 tokens

product-analytics-specialist

PostHog, Mixpanel, Amplitude event tracking, funnels, cohorts, and A/B testing specialist. Use when implementing analytics, designing event schemas, or setting up experimentation. Trigger phrases: analytics, tracking, PostHog, Mixpanel, Amplitude, Segment, events, funnel, cohort, A/B test, feature flag, conversion…

travisjneuman/.claude · 80 tokens

cloud-architect

Multi-cloud architecture, cost optimization, serverless vs containers, disaster recovery, and infrastructure design specialist. Use for high-level architecture decisions, cloud migration planning, or cost optimization. Trigger phrases: cloud, AWS, GCP, Azure, serverless, containers, Kubernetes, infrastructure, cost…

travisjneuman/.claude · 69 tokens