Skip to content

shinpr/nautilus / .agents/skills/recipe-discover

recipe-discover

Verified

Frames product Opportunities and creates decision-relevant hypotheses from available evidence. Use when exploring a problem, market opportunity, or user need.

Context: Discover Opportunities and generate hypotheses by combining business analysis (BMC/VPC/market) with user analysis (JTBD/pains/gains). Outputs Opportunity files and hypothesis files.

Required Skills [LOAD BEFORE EXECUTION]

  1. [LOAD IF NOT ACTIVE] hypothesis-discipline — hypothesis lifecycle, evidence, and stopping conditions
  2. [LOAD IF NOT ACTIVE] product-principles — Opportunity hierarchy, 4 Risks, and framing rules

Conditional Skills [LOAD WHEN TRIGGERED]

  • WHEN the request or available evidence raises a business-model, market, or viability decision: [LOAD IF NOT ACTIVE] business-context

Delegate code analysis when a separate repository reading can change the discovery decision.

Execution Decision Flow

1. Context Assessment

Input: Use the path or text supplied with the explicit skill invocation. If no input was supplied and the target cannot be inferred unambiguously, ask for it.

Assess the starting point:

SituationAction
Greenfield (no existing product)Gather the business and user evidence needed to frame the requested outcome
Existing codebaseInvoke codebase-analyzer when current behavior can change the Opportunity framing
Specific market opportunityFocus on market analysis + VPC
User feedback / support ticketsFocus on user analysis + journey mapping
Vision exists (docs/product/vision.md)Align discovery with Product Outcomes

2. Business Context Analysis

When business context can change the Opportunity decision, select the relevant business-context framework:

  • BMC: Understand the business model — especially Customer Segments, Value Propositions, Revenue Streams
  • VPC: Map Customer Profile (jobs/pains/gains) to Value Map (products/pain relievers/gain creators)
  • Market Analysis: TAM/SAM/SOM, competitive landscape, market gaps

Read the selected business-context reference for its decision boundary and evidence requirements.

Web search: Use web search for market research — industry reports, competitor analysis, trend data. Market research benefits from hypothesis context (unlike code analysis).

3. User Context Analysis

  • Personas: Reference existing personas (docs/product/personas/) or delegate to recipe-persona for full persona work
  • JTBD: Identify functional, social, and emotional jobs from VPC Customer Profile
  • Journey Mapping: Create a journey map using references/journey-template.md when sequence or handoff evidence is needed to locate the Opportunity

4. Opportunity Identification

Synthesize business and user analysis into Opportunities:

  1. Draft Opportunity files using product-principles skill references/opportunity-template.md
  2. 3+ Solutions Test: Use the ability to identify meaningfully different Solutions as a diagnostic. If the framing supports fewer than three, report that signal without generating filler alternatives
  3. Link Opportunities to Product Outcomes (if vision exists)
  4. Assess impact (frequency x severity x breadth)

Present Opportunities to the user for the product-scope decision:

  • Opportunity summaries with impact assessment
  • Evidence supporting each Opportunity
  • 3+ Solutions test results
  • Recommended priority order

End the current turn with the Opportunity summaries as the workflow output. Generate hypotheses only for the Opportunities the user confirms in a later turn.

5. Hypothesis Generation

For confirmed Opportunities, generate hypotheses:

  1. Draft hypothesis files using hypothesis-discipline skill references/hypothesis-template.md
  2. Assign appropriate level (outcome / opportunity / solution / assumption)
  3. Set initial confidence scores (typically 0-2 for new hypotheses)
  4. Define a stopping condition; add a time budget or deadline only when it changes the validation decision
  5. Suggest validation methods

6. File Output

Write the confirmed Opportunities and their decision-relevant hypotheses. Create only the artifacts produced by this discovery:

  • Opportunity files in docs/discovery/opportunities/
  • Hypothesis files in docs/discovery/hypotheses/
  • Journey maps in docs/discovery/journeys/ when journey evidence was required

Present the created hypotheses, proposed validation methods or stopping conditions, and recommended priority.

Sub-agent Usage

AgentWhenWhy (context separation benefit)
codebase-analyzerCurrent implementation can change the Opportunity or persona decisionObjective fact-gathering without hypothesis bias

Scope Boundaries

Included: Opportunity discovery, hypothesis generation, market research, journey mapping Not included: Hypothesis validation (→ recipe-validate), PRD creation (→ recipe-define), persona deep-dive (→ recipe-persona)

Completion

The workflow is complete when the confirmed Opportunities and their decision-relevant hypotheses exist, and the user has received the proposed validation methods, stopping conditions, and priority.

slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall