From plan-pmf
Orchestrates PMF context layer creation with icp.md, value-prop.md, mvp.md, and validation-plan.md files. Checks pmf/ folder progress and routes to builders.
npx claudepluginhub adidacta/pmf-detective --plugin pmf-detectiveThis skill is limited to using the following tools:
You help product builders create their PMF context layer - a set of reference files that Claude uses when building anything for their product.
Guides users sequentially through PMF context layer: ICP, value proposition, MVP PRD, validation plan, execution. Triggered by /plan-pmf or full context needs.
Creates and updates product marketing context document with overview, audience, positioning. Auto-drafts from repo (README, package.json) or gathers interactively section-by-section.
Creates or updates reusable product marketing context documents with positioning, audience, ICP, use cases, and messaging. Use at project start to avoid repeating core info across tasks.
Share bugs, ideas, or general feedback.
You help product builders create their PMF context layer - a set of reference files that Claude uses when building anything for their product.
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)
├── mvp.md # MVP scope — aha moment, features & requirements (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.
Check the pmf/ folder to understand current progress:
pmf/icp.md exists → ICP definedpmf/value-prop.md exists → Value proposition definedpmf/mvp.md exists → MVP scope definedpmf/validation-plan.md exists → Validation plan setShow 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 │
│ • mvp.md - MVP scope & features │
│ │
│ Claude will reference these files when building │
│ anything for your product. │
│ │
├───────────────────────────────────────────────────────────────┤
│ Start: /plan-pmf to build your full context layer │
└───────────────────────────────────────────────────────────────┘
Show complete status and explain how to update:
┌───────────────────────────────────────────────────────────────┐
│ PMF CONTEXT LAYER - COMPLETE │
├───────────────────────────────────────────────────────────────┤
│ │
│ [✓] ICP - pmf/icp.md (assumption) │
│ [✓] Value Proposition - pmf/value-prop.md (assumption) │
│ [✓] MVP - pmf/mvp.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-mvp - Revise MVP scope │
└───────────────────────────────────────────────────────────────┘
When showing status:
┌───────────────────────────────────────────────────────────────┐
│ PMF CONTEXT STATUS │
├───────────────────────────────────────────────────────────────┤
│ │
│ [✓] ICP (assumption) │
│ Who: [Brief summary from icp.md] │
│ │
│ [✓] Value Proposition (assumption) │
│ Core: [Primary message from value-prop.md] │
│ │
│ [ ] MVP (assumption) │
│ Not yet defined │
│ │
│ [ ] Validation Plan │
│ Not yet defined │
│ │
├───────────────────────────────────────────────────────────────┤
│ Progress: ██████████░░░░░░░░░░ 2/4 sections │
├───────────────────────────────────────────────────────────────┤
│ Next: /update-mvp to define MVP scope │
└───────────────────────────────────────────────────────────────┘
When user wants to work on a specific section:
Created by Adi Shmorak, The P/MF Detective Star on GitHub if this helped | Feedback: adi@adidacta.com