.wrangler/memory/knowledge-base/reference-prompts/skills/problem-mapping/SKILL.md
Foundational problem framing for design sprints and product strategy. Based on Google Design Sprint "Understand" phase methodology. Use when teams need to establish shared understanding before ideation - defining problem statements, identifying users/stakeholders, setting success criteria, documenting constraints and assumptions, and capturing pain points. Works in solo, team synchronous, or team asynchronous modes. Creates structured problem map document as foundation for HMW exercises and solution generation.
npx skillsauth add bacchus-labs/wrangler problem-mappingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Problem Mapping helps teams understand and frame design challenges before jumping to solutions. Based on the "Understand" phase from Google Design Sprint methodology, this skill structures messy problem spaces into clear goals, assumptions, and pain points.
Start here: "I'd like to start a problem mapping session"
Claude will ask: "How are you running this session?"
Each mode follows the same 6-step questioning framework but adapts the interaction style.
Use when working through problems independently - initial exploration, personal projects, or prep work.
Use when team is together (in-person or video call) - kickoff meetings, workshops, retreat sessions.
Facilitator (you):
Claude:
Team:
Total: ~50 minutes
Use when team is distributed, busy schedules, or when gathering diverse perspectives independently matters.
Phase 1: Generate Questions (5 min)
Phase 2: Distribute (You handle)
Phase 3: Compile (10 min)
Phase 4: Synthesis (Claude does this)
Phase 5: Review (Team)
Claude asks what format works for your team:
All modes produce a structured problem map:
# Problem Map: [Project Name]
**Date:** [Date]
**Participants:** [Names/Roles]
**Mode:** [Solo/Team Sync/Team Async]
---
## Problem Statement
[Clear, concise description of challenge]
---
## Users & Stakeholders
**Primary Users:**
- [User type]: [Main needs/goals]
**Stakeholders:**
- [Stakeholder]: [Interest/influence]
---
## Success Criteria
What "good" looks like:
1. [Measurable outcome]
2. [Measurable outcome]
3. [Measurable outcome]
---
## Constraints
**Time:** [Limitations]
**Resources:** [Budget, team, tools]
**Technical:** [Platform, integration, legacy]
**Business:** [Policy, compliance, market]
---
## Assumptions
Things we're taking for granted (need validation):
- [Assumption about users]
- [Assumption about solution]
- [Assumption about context]
- [Assumption about feasibility]
---
## Pain Points & Challenges
Key problems and frustrations:
- [User pain point]
- [Business challenge]
- [Technical obstacle]
- [Process friction]
---
## Open Questions
What we need to learn or validate:
- [Research question]
- [Validation needed]
- [Knowledge gap]
---
## Next Steps
[If team decided on immediate actions]
Async mode adds individual perspectives section:
---
## Individual Perspectives
**On [Topic]:**
- [Person A]: [Their view]
- [Person B]: [Their view]
- [Person C]: [Their view]
**Patterns Observed:**
- [Common theme]
- [Area of alignment]
- [Area of divergent thinking]
**Note:** Shows what team said, not what it means.
Team discusses significance together.
Claude catches these automatically:
❌ Jumping to solutions - "We should build X" ✅ Staying in problem space - "Users struggle with Y because Z"
❌ Vague goals - "Make it better"
✅ Specific criteria - "Reduce task time from 5 min to 2 min"
❌ Hidden assumptions - Treating beliefs as facts ✅ Named assumptions - "We assume users have smartphones (needs validation)"
❌ Problem statements that are actually solutions - "We need a mobile app" ✅ Clear problem statements - "Users can't access information when away from desktop"
After Problem Mapping:
hmw-affinity skill during talks)crazy-8s skill)Problem Mapping creates the foundation. Everything else builds on this shared understanding.
Note: In Google Design Sprints, Problem Mapping is part of the "Understand" phase. After this foundational work, teams conduct Lightning Talks where experts present insights. During talks, team members capture "How Might We" (HMW) opportunities - that's a separate skill (hmw-affinity).
tools
Use when creating technical specifications for features, systems, or architectural designs. Creates comprehensive specification documents using the Wrangler MCP issue management system with proper structure and completeness checks.
testing
Creates and refines agent skills using TDD methodology with pressure testing and rationalization detection. Use when creating new skills, editing existing skills, testing skills with pressure scenarios, or verifying skills work before deployment.
tools
Use when design is complete and you need detailed implementation tasks - creates tracked MCP issues with exact file paths, complete code examples, and verification steps. Optional reference plan file for architecture overview.
development
Validates governance file completeness, format compliance, and metric accuracy. Use when auditing governance health, after bulk changes, or ensuring documentation integrity.