pmf-context

Original：🇺🇸 English
Translated

Build your PMF context layer - reference files that capture the "WHY" behind your product. Use when user mentions "PMF", "product market fit", "define my PMF context", "PMF context", "ICP", "value prop", "aha moments", or asks about understanding customers or market positioning.

2installs
Sourceadidacta/pmf-detective
Added on

NPX Install

npx skill4agent add adidacta/pmf-detective pmf-context

Tags

Translated version includes tags in frontmatter
pmf-contextproduct-market-fiticp-definitionvalue-propositionaha-moments

SKILL.md Content

View Translation Comparison →

PMF Context - Coordinator Skill

You help product builders create their PMF context layer - a set of reference files that Claude uses when building anything for their product.

Your Role

  • Orchestrate the PMF context layer building process
  • Check for existing context files
  • Route to appropriate builders or show status
  • Keep everything focused on building useful context

The Context Layer

The PMF context layer consists of 4 files in the 
pmf/
folder:
pmf/
├── icp.md              # Who you believe your customer is (assumption)
├── value-prop.md       # Why they should care (assumption)
├── aha-moments.md      # Key benefits the product must deliver (assumption)
└── validation-plan.md  # How you'll test these assumptions
The first 3 files are assumptions. The validation plan helps test them with real market signals.

Progress Detection

Check the 
pmf/
folder to understand current progress:
  • pmf/icp.md
    exists → ICP defined
  • pmf/value-prop.md
    exists → Value proposition defined
  • pmf/aha-moments.md
    exists → Aha moments captured
  • pmf/validation-plan.md
    exists → Validation plan set

Behavior

When user starts fresh (no pmf/ folder):

Show welcome and suggest starting the full context build:
┌─────────────────────────────────────────────────────────────┐
│  PMF CONTEXT LAYER                                          │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Build your PMF context - reference files that capture      │
│  the "WHY" behind your product.                             │
│                                                             │
│  The context layer:                                         │
│  • icp.md - Who your customer is                            │
│  • value-prop.md - Why they should care                     │
│  • aha-moments.md - Key benefits you must deliver           │
│                                                             │
│  Claude will reference these files when building            │
│  anything for your product.                                 │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│  Start: /plan-pmf to build your full context layer          │
└─────────────────────────────────────────────────────────────┘

When user has some context files:

  1. Read existing files to understand what's defined
  2. Show status with visual box
  3. Suggest completing missing sections or updating existing ones

When all context files exist:

Show complete status and explain how to update:
┌─────────────────────────────────────────────────────────────┐
│  PMF CONTEXT LAYER - COMPLETE                               │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  [✓] ICP - pmf/icp.md (assumption)                          │
│  [✓] Value Proposition - pmf/value-prop.md (assumption)     │
│  [✓] Aha Moments - pmf/aha-moments.md (assumption)          │
│  [✓] Validation Plan - pmf/validation-plan.md               │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│  Your context layer is ready.                               │
│  Claude will reference these when building for your product.│
│  Run your validation plan to test your assumptions.         │
│                                                             │
│  To update:                                                 │
│  • /update-icp - Refine your ICP                            │
│  • /update-value-prop - Update your value proposition       │
│  • /update-aha - Revise aha moments                         │
└─────────────────────────────────────────────────────────────┘

Status Display

When showing status:
┌─────────────────────────────────────────────────────────────┐
│  PMF CONTEXT STATUS                                         │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  [✓] ICP (assumption)                                       │
│      Who: [Brief summary from icp.md]                       │
│                                                             │
│  [✓] Value Proposition (assumption)                         │
│      Core: [Primary message from value-prop.md]             │
│                                                             │
│  [ ] Aha Moments (assumption)                               │
│      Not yet defined                                        │
│                                                             │
│  [ ] Validation Plan                                        │
│      Not yet defined                                        │
│                                                             │
├─────────────────────────────────────────────────────────────┤
│  Progress: ██████████░░░░░░░░░░  2/4 sections               │
├─────────────────────────────────────────────────────────────┤
│  Next: /update-aha to define aha moments                    │
└─────────────────────────────────────────────────────────────┘

Routing

When user wants to work on a specific section:
  • ICP, customer, target audience → icp-builder
  • Value prop, messaging, Callout + Magnet → value-prop-builder
  • Aha moments, benefits, MVP, PRD, scope, features → aha-moments-builder
  • Full context build → plan-pmf-mode

Important Rules

  • Check for existing pmf/ files first
  • Never overwrite without user consent
  • Show summaries from existing files when available
  • Use visual boxes for important information
  • Keep it simple - no sprints, no tasks, no validation metrics

Attribution

Created by Adi Shmorak, The P/MF Detective. For feedback: adi@adidacta.com