speckit.product-forge.problem-discovery

speckit.product-forge.problem-discovery is a command for Claude Code from VaiYav/speckit-product-forge. It costs 77 tokens per session (2,697 once invoked), scanned A, original, MIT.

A preparation step that checks whether a proposed feature solves a real and understood problem before research or specification work begins. It uses job analysis, an interview script, a Problem Statement Canvas, and a confidence report.

In plain words
What is it for?
Use it to clarify who has the problem, what they are trying to do, and what blocks them. It is intended to run before product research and detailed feature planning.
Why use it?
It helps teams avoid spending research and development time on the wrong problem or on a problem that is not important enough to users.

Command for Claude Code

Written for Claude Code: $ARGUMENTS substitution.

Part of the speckit-product-forge plugin — 31 commands shipped together

Good fit Use it to clarify who has the problem, what they are trying…

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/vaiyav/speckit-product-forge/problem-discovery
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/VaiYav/speckit-product-forge

Made for: Claude Code.

Or install speckit-product-forge, the plugin that ships this one along with the rest of its 31 commands.

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 speckit.product-forge.problem-discovery

README.md
[![agentmods](https://agentmods.dev/badge/commands/vaiyav/speckit-product-forge/problem-discovery.svg)](https://agentmods.dev/commands/vaiyav/speckit-product-forge/problem-discovery)
Your own site
<a href="https://agentmods.dev/commands/vaiyav/speckit-product-forge/problem-discovery"><img src="https://agentmods.dev/badge/commands/vaiyav/speckit-product-forge/problem-discovery.svg" alt="Measured on agentmods" height="20"></a>
Per session 77 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,697 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.00077 $0.02697
Opus 5 $0.00039 $0.01349
Sonnet 5 $0.00015 $0.00539
Haiku 4.5 $0.00008 $0.00270

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

Security

Grade A, and why

speckit.product-forge.problem-discovery 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.

commands/problem-discovery.md · 371 lines

How it starts

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

Product Forge — Phase 0: Problem Discovery

You are the Problem Validator for Product Forge Phase 0. Your goal: validate that the problem is real, well-understood, and worth solving before any research or spec work begins.

User Input

$ARGUMENTS

Why This Phase Exists

Most features fail not because of bad implementation but because they solve the wrong problem, or a problem that isn't painful enough. This phase forces structured thinking before committing to the research → spec → implement pipeline.


Step 1: Extract Problem Hypothesis

Parse $ARGUMENTS and extract:

  • Feature idea: what the user wants to build
  • Assumed problem: what problem it supposedly solves
  • Assumed user: who experiences this problem
  • Assumed trigger: when/why the user encounters it

If any are missing or ambiguous, ask in ONE message:

Before we start researching, let's validate the problem itself.

1. **Who has this problem?**
   Describe the specific user segment (role, context, experience level, device, etc.)

2. **What are they trying to do?** (the Job)
   Complete: "Help me ___" — from the user's perspective, not the feature's perspective

3. **What's blocking them right now?**
   Current solution / workaround they use today (even if it's "nothing" or "manual process")

4. **How painful is it?**
   - [ ] Annoying but tolerable — they've adapted a workaround
   - [ ] Regularly frustrating — they complain about it
   - [ ] Business-critical — it costs them time/money/customers
   - [ ] Blocking — they can't proceed without a solution

5. **How do you know this is a real problem?**
   - [ ] User interviews / support tickets / churn feedback
   - [ ] My own observation / dogfooding
   - [ ] Competitor has this — implies demand
   - [ ] Assumption / hypothesis (not yet validated)

6. **What's the expected outcome if solved?**
   How will the user's life/work be measurably different?

Step 2: JTBD Analysis

Apply the Jobs-to-be-Done framework to the validated problem.

Read the full file on GitHub · 371 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 · 371 lines · 77 tokens per session scan A ba22c703bbe8

Subscribe to this mod's changes

speckit.product-forge.problem-discovery is a command published in the GitHub repository VaiYav/speckit-product-forge (23 stars, last pushed 13d ago), licensed MIT. It adds 77 tokens to every session and 2,697 once invoked, about $0.0004 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-30.