Skip to content

Wirtzer/Product-Management-Coach

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

11 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŽ“ PM Coach

An adaptive AI coaching system that uses spaced repetition, 10 teaching approaches, and expert personas to make you a world-class Product Manager.

License: MIT + Commons Clause Platform: Claude Code Platform: Cursor

Architected by Alex Wirtzer. Got feedback? Send it to Genie.Wirtzer@gmail.com and we will look into it!


What is This?

PM Coach is a complete coaching system that turns your AI coding assistant into a persistent, adaptive PM tutor. Unlike asking ChatGPT to "help me prepare for PM interviews," PM Coach remembers everything β€” your strengths, your gaps, which teaching techniques work for you, and exactly when you need to review each topic.

The system tracks your progress across 13 learning tracks organized into 8 pillars of PM excellence. It uses a spaced repetition algorithm (SM-2 variant) to schedule reviews at optimal intervals, rotates through 10 pedagogical approaches with automatic technique retirement when something isn't working, and tests your conversational readiness through 8 expert persona simulations β€” from a "VP of Research at DeepMind" probing your AI knowledge to a "Principal Engineer pushing back" on your product decisions.

Everything is stored in plain text files: JSON for state, JSONL for history, Markdown for lesson plans and reflections. You can read every piece of your learning state, version-control your progress, and customize anything. There's no server, no database, no subscription β€” just you, your AI, and a well-structured file system.


⚑ Quickstart (5 minutes)

1. Clone the Repository

git clone https://github.com/Wirtzer/Product-Management-Coach.git
cd Product-Management-Coach

2. Run Setup

./setup.sh

The interactive wizard will configure your profile, check dependencies, and initialize the system.

3. Start Coaching

With Claude Code (recommended):

claude
# Then say: "let's go"

With Cursor: Open the pm-coach folder in Cursor. The .cursorrules file loads automatically. Start a new chat and say "let's go."

With Windsurf: Copy .cursorrules to .windsurfrules, then open the folder in Windsurf.

4. Your First Session

The coach will:

  1. Read your profile and current track state
  2. Identify what's due for review (on first run: everything)
  3. Start with your weakest area or a framework introduction
  4. Score your responses and update your tracks
  5. Plan the next session

Why PM Coach?

The Problem with Generic AI Coaching

Asking ChatGPT "Help me prepare for PM interviews" gets you a generic answer. Ask again tomorrow and it has no memory of yesterday. You're starting from zero every time.

PM skills are built through deliberate practice with feedback loops β€” the same way musicians practice scales or athletes drill fundamentals. You need:

  • Persistence: Track what you've practiced and how you scored
  • Spacing: Review topics at optimal intervals for long-term retention
  • Adaptation: Retire techniques that aren't working, intensify what is
  • Pressure testing: Simulate real conversations, not just Q&A

PM Coach provides all four.

How It Compares

Feature ChatGPT / Generic AI PM Coach
Remembers past sessions ❌ Starts fresh each time βœ… 13 tracks with persistent scores and full history
Adapts teaching approach ❌ Same approach every time βœ… 10 pedagogy approaches with automatic technique rotation
Spaced repetition ❌ No scheduling βœ… SM-2 variant with per-track intervals (1-30 days)
Expert persona tests ❌ Generic role-play βœ… 8 calibrated expert personas with scoring rubrics
Automated reflection ❌ No analysis loop βœ… Nightly reflection analyzes patterns and updates plans
PM-specific frameworks Generic knowledge βœ… Deep framework library: CIRCLES, RICE, JTBD, Working Backwards, and more
Progress tracking None βœ… Dashboard with 8 pillars, per-dimension scoring, trend analysis
Knowledge pipeline Manual βœ… Feed articles and papers β†’ auto-scored and routed to tracks
Personalized to your background ❌ No context about you βœ… Portfolio synthesis: resume, projects, wins inform every session
Add your own interview questions N/A βœ… Structured question bank with company tags and scoring

πŸ—οΈ Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚              YOUR COACHING SESSION                β”‚
β”‚                                                  β”‚
β”‚  You ←→ LLM ←→ CLAUDE.md (system prompt)        β”‚
β”‚              β”‚                                    β”‚
β”‚              β”œβ”€ reads track state + lesson plans   β”‚
β”‚              β”œβ”€ reads pedagogy approaches          β”‚
β”‚              β”œβ”€ reads memory + frameworks          β”‚
β”‚              β”‚                                    β”‚
β”‚              └─ writes updated scores + history    β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                       β”‚
          β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
          β–Ό            β–Ό            β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β” β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚ Reflection   β”‚ β”‚Session β”‚ β”‚Knowledge β”‚
   β”‚ Engine (LLM) β”‚ β”‚Prep    β”‚ β”‚Pipeline  β”‚
   β””β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”¬β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
          β”‚            β”‚           β”‚
          β–Ό            β–Ό           β–Ό
   β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   β”‚         FLAT FILE STATE              β”‚
   β”‚  tracks/ β†’ JSON scores + JSONL logs  β”‚
   β”‚  pedagogy/ β†’ teaching methodology    β”‚
   β”‚  reflections/ β†’ analysis archive     β”‚
   β”‚  dashboard.md β†’ progress overview    β”‚
   β”‚  memory.md β†’ session context         β”‚
   β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

All state is in human-readable flat files. No database. Git-friendly. See docs/ARCHITECTURE.md for the full technical deep-dive.


πŸ“š The 8 Pillars

PM Coach organizes learning into 8 pillars covering the full spectrum of PM excellence:

# Pillar Tracks What You'll Learn
1 πŸ”¬ Technical Depth AI Foundations, World Models, Agent Architectures, Robot Learning AI/ML concepts, model architectures, research landscape
2 πŸ› οΈ PM Craft Product Sense, PM Frameworks Product intuition, CIRCLES, RICE, JTBD, metrics design
3 🎯 Interview Excellence LP Stories STAR stories, behavioral answers, delivery under pressure
4 πŸ”­ Strategic Vision AI Product Strategy Industry landscape, product strategy, market analysis
5 ✍️ Narrative & Influence Narrative & Influence Product narratives, strategy memos, stakeholder communication
6 πŸ•ΈοΈ Network Intelligence Network Intelligence, Industry Landscape Talent flows, company dynamics, ecosystem mapping
7 πŸ”¨ Builder's Credibility Builder's Credibility Technical specs, architecture review, prototyping
8 🧠 Decision Science Decision Science Cognitive biases, decision frameworks, probabilistic thinking

Each pillar contains 1-4 tracks. Each track has its own mastery scores, conversational readiness scores, spaced repetition schedule, and lesson plan.


🧠 The Learning Science

Spaced Repetition

PM Coach uses a 5-tier quality system adapted from the SM-2 algorithm:

Quality Score Range Interval Change
5 β€” Perfect β‰₯ 90 Γ— 2.5 (max 30d)
4 β€” Good 80–89 Γ— 2.0 (max 30d)
3 β€” Adequate 70–79 Γ— 1.5 (max 30d)
2 β€” Poor 55–69 Reset to 1 day
1 β€” Fail < 55 Reset to 1 day + flag

Tracks you master get reviewed monthly. Tracks you struggle with appear daily until they stabilize.

10 Teaching Approaches

Each approach has a 5-phase progression with specific techniques per phase:

  1. Storytelling Practice β€” Structure and deliver STAR stories fluently
  2. Framework Application β€” Internalize PM frameworks for automatic deployment
  3. Case Analysis β€” Pattern recognition and structured analytical thinking
  4. Concept Learning β€” Deep understanding through concrete-to-abstract progression
  5. AI Concept Learning β€” Technical AI depth for expert-level conversation
  6. Industry Case Analysis β€” Current, deep knowledge of the AI landscape
  7. Interview Drill β€” Integration of all skills under realistic pressure
  8. Craft-Based Practice β€” Persuasive communication through iterative writing
  9. Pattern Recognition & Briefing β€” Industry awareness and intelligence synthesis
  10. Project-Based Learning β€” Technical credibility through hands-on work

The reflection engine monitors which techniques work for you and automatically retires low-performing ones after 3+ sessions.

Expert Persona Tests

8 domain expert personas test your conversational readiness β€” your ability to discuss topics naturally, not just answer quiz questions:

Persona Tests Key Emphasis
πŸ”¬ VP of Research (DeepMind) Technical depth Accuracy, depth, current awareness
πŸ› οΈ Principal Engineer PM craft Depth, opinion formation, accuracy
🎯 Bar Raiser Interview skills Accuracy, fluency, depth
πŸ”­ CPO (frontier AI company) Strategic vision Opinion formation, current awareness
✍️ VP of Product Narrative & influence Opinion formation, fluency
πŸ•ΈοΈ Conference Attendee Network intelligence Current awareness, opinion formation
πŸ”¨ Hiring Manager Builder's credibility Accuracy, depth, builder fluency
🧠 Board Member Decision science Depth, opinion formation, accuracy

Each test is scored on 5 dimensions (100 points total) and updates your conversational readiness scores.

Phase Advancement

You advance to the next phase when all three criteria are met:

  1. Quantitative: Mastery score for the current phase's target dimensions exceeds 75/100
  2. Qualitative: You demonstrate the phase's mastery signals in 2+ consecutive sessions
  3. Spaced Repetition: At least one successful review after a 3+ day gap

🎯 Features

  • Adaptive Coaching β€” Teaching approach evolves based on what works for you
  • Mock Interviews β€” Company-specific with structured STAR feedback
  • Framework Teaching β€” Deep dives with worked examples and practice scenarios
  • Expert Tests β€” Simulated conversations with domain experts who score you
  • Daily Reflection β€” Automated analysis of progress, technique effectiveness, and lesson planning
  • Knowledge Pipeline β€” Feed articles, papers, and notes β†’ auto-scored and integrated into tracks
  • Progress Dashboard β€” Visual tracking across all 8 pillars with ASCII progress bars
  • Spaced Repetition β€” Never forget what you've learned; review at optimal intervals
  • Personal Portfolio β€” Drop your resume, project write-ups, and win lists for deeply personalized coaching
  • Question Bank β€” Add your own interview questions following the included template
  • PM Framework Library β€” 10 reference guides for core PM frameworks (CIRCLES, RICE, JTBD, and more)

πŸ“ Project Structure

pm-coach/
β”œβ”€β”€ CLAUDE.md                          # System prompt (the coach's brain)
β”œβ”€β”€ .cursorrules                       # Cursor/Windsurf rules (compact CLAUDE.md)
β”œβ”€β”€ setup.sh                           # Interactive setup wizard
β”œβ”€β”€ config.json                        # Your profile and preferences
β”œβ”€β”€ memory.md                          # Persistent session memory
β”‚
β”œβ”€β”€ learning/
β”‚   β”œβ”€β”€ dashboard.md                   # Progress dashboard (auto-generated)
β”‚   β”œβ”€β”€ session-prep.md                # Today's session plan (auto-generated)
β”‚   β”œβ”€β”€ knowledge-queue.jsonl          # Knowledge pipeline queue
β”‚   β”œβ”€β”€ tracks/
β”‚   β”‚   β”œβ”€β”€ ai-foundations/
β”‚   β”‚   β”‚   β”œβ”€β”€ track.json             # Scores, spaced repetition state
β”‚   β”‚   β”‚   β”œβ”€β”€ history.jsonl          # Session-by-session log
β”‚   β”‚   β”‚   └── lesson-plan.md         # Current teaching plan
β”‚   β”‚   β”œβ”€β”€ pm-frameworks/
β”‚   β”‚   β”œβ”€β”€ lp-stories/
β”‚   β”‚   └── ... (13 tracks total)
β”‚   β”œβ”€β”€ pedagogy/
β”‚   β”‚   β”œβ”€β”€ approaches.md              # 10 teaching approaches
β”‚   β”‚   └── expert-personas.md         # 8 expert personas
β”‚   └── reflections/
β”‚       β”œβ”€β”€ latest.md                  # Most recent reflection
β”‚       └── archive/                   # Historical reflections
β”‚
β”œβ”€β”€ data/
β”‚   β”œβ”€β”€ frameworks/                    # PM framework reference docs
β”‚   β”‚   β”œβ”€β”€ circles.md
β”‚   β”‚   β”œβ”€β”€ rice.md
β”‚   β”‚   β”œβ”€β”€ working-backwards.md
β”‚   β”‚   β”œβ”€β”€ jobs-to-be-done.md
β”‚   β”‚   β”œβ”€β”€ north-star-metric.md
β”‚   β”‚   β”œβ”€β”€ okrs.md
β”‚   β”‚   β”œβ”€β”€ star-soar.md
β”‚   β”‚   β”œβ”€β”€ first-principles.md
β”‚   β”‚   β”œβ”€β”€ opportunity-solution-tree.md
β”‚   β”‚   └── kano-model.md
β”‚   β”œβ”€β”€ question-bank/                 # Your interview questions (add your own)
β”‚   β”‚   β”œβ”€β”€ README.md
β”‚   β”‚   └── template.json
β”‚   └── portfolio/                     # Your personal docs (resume, projects, wins)
β”‚       β”œβ”€β”€ README.md
β”‚       └── profile-synthesis.md       # Coach-maintained synthesized profile
β”‚
β”œβ”€β”€ knowledge/                         # Drop articles and papers here
β”‚
β”œβ”€β”€ scripts/
β”‚   β”œβ”€β”€ update-dashboard.sh            # Regenerate dashboard from track data
β”‚   β”œβ”€β”€ prepare-session.sh             # Generate session prep for today
β”‚   β”œβ”€β”€ run-reflection.sh              # Run the nightly reflection analysis
β”‚   β”œβ”€β”€ feed-knowledge-queue.sh        # Process knowledge sources into queue
β”‚   └── add-topic.sh                   # "Teach me about X"
β”‚
β”œβ”€β”€ docs/
β”‚   β”œβ”€β”€ ARCHITECTURE.md                # System architecture deep-dive
β”‚   β”œβ”€β”€ CUSTOMIZATION.md               # How to personalize everything
β”‚   β”œβ”€β”€ PLATFORMS.md                    # Setup for Claude Code, Cursor, Windsurf
β”‚   β”œβ”€β”€ CONTRIBUTING.md                # How to contribute
β”‚   └── FAQ.md                         # Common questions
β”‚
└── examples/
    β”œβ”€β”€ session-transcript.md          # Annotated coaching session
    β”œβ”€β”€ expert-test-example.md         # Annotated expert test
    └── custom-track-example/          # How to create a custom track

πŸ“š Knowledge Sources

PM Coach includes a framework library with original syntheses of 10 core PM frameworks, each with worked examples and interview application guidance.

The knowledge/ directory is designed for you to add your own learning materials:

  • Articles and blog posts β€” Drop .md files and run feed-knowledge-queue.sh
  • Research paper summaries β€” Markdown summaries of relevant papers
  • Podcast notes β€” We recommend distilling insights from Lenny's Podcast by Lenny Rachitsky β€” organize notes by PM topic (product sense, metrics, growth, strategy, etc.) and drop them in knowledge/
  • Your own notes β€” Anything relevant to your PM growth

The knowledge pipeline automatically scores new materials for relevance and routes them to the appropriate learning tracks.


πŸ”§ Platform Compatibility

Platform Status How It Works
Claude Code βœ… Full support CLAUDE.md auto-loads as system prompt
Cursor βœ… Full support .cursorrules auto-loads
Windsurf βœ… Full support Copy .cursorrules β†’ .windsurfrules
Aider ⚠️ Partial Needs manual system prompt loading
ChatGPT ⚠️ Limited No file persistence or automation
Other LLMs ⚠️ Varies Needs tool use + file access capability

See docs/PLATFORMS.md for detailed setup instructions per platform.


πŸ› οΈ Automation

All scripts require only bash and jq. No other dependencies.

Daily Reflection (Recommended)

The reflection engine analyzes your progress, updates lesson plans, rotates techniques, and processes the knowledge queue:

./scripts/run-reflection.sh

Optional: Run nightly via cron:

# Edit crontab
crontab -e

# Add (runs at 11 PM daily):
0 23 * * * cd /path/to/pm-coach && ./scripts/run-reflection.sh >> /tmp/pm-coach-reflection.log 2>&1

Session Prep (Recommended)

Generates a session plan based on what's due and what needs attention:

./scripts/prepare-session.sh

Other Scripts

# Regenerate the progress dashboard
./scripts/update-dashboard.sh

# Add a topic to learn
./scripts/add-topic.sh "transformer attention mechanisms"
./scripts/add-topic.sh "RICE prioritization" --tracks pm-frameworks

# Process new knowledge sources
./scripts/feed-knowledge-queue.sh

🎨 Customization

PM Coach is designed to be extended. Common customizations:

  • Add a new learning track β€” Create a directory in learning/tracks/ with track.json, history.jsonl, and lesson-plan.md
  • Add your portfolio β€” Drop resume, project write-ups, win lists, and performance reviews into data/portfolio/ for personalized coaching
  • Add interview questions β€” Follow the template in data/question-bank/
  • Add knowledge β€” Drop .md files in knowledge/ and run the pipeline
  • Modify expert personas β€” Edit learning/pedagogy/expert-personas.md
  • Change the LLM model β€” Set REFLECTION_MODEL env var or edit config.json
  • Adapt for non-PM domains β€” The architecture is domain-agnostic; swap the content

See docs/CUSTOMIZATION.md for detailed guides.


🀝 Contributing

We welcome contributions! Whether it's new frameworks, better pedagogy approaches, additional expert personas, or script improvements.

See docs/CONTRIBUTING.md for guidelines.


πŸ“„ License

MIT + Commons Clause β€” see LICENSE.

Free to use, modify, and fork. The Commons Clause restricts selling the software or a competing product/service built on it without written permission from Alex Wirtzer.


πŸ™ Acknowledgments

  • Lenny's Podcast by Lenny Rachitsky β€” PM insights distilled from this essential podcast for product people informed many of the framework applications and coaching patterns in this system
  • Product Manager Skills by Dean Peters β€” Complementary PM skills library
  • Spaced repetition algorithm adapted from SM-2 by Piotr Wozniak
  • Coaching methodology informed by The Prompt Report (2025) β€” a comprehensive survey of prompting techniques
  • PM frameworks synthesized from publicly available industry-standard sources (CIRCLES, RICE, JTBD, OKRs, Kano, and more)

About

An adaptive AI coaching system that uses spaced repetition, 10 teaching approaches, and expert personas to make you a world-class Product Manager. Works with Claude Code, Cursor, and Windsurf.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages