{
"markdown": "# PM AI Partner Framework\n\n**AI-powered skills, workflows, and methodology for Product Managers.**\n\n[](https://www.npmjs.com/package/pm-ai-partner)\n[](https://github.com/ahmedkhaledmohamed/PM-AI-Partner-Framework)\n[](LICENSE)\n\n```bash\nnpx pm-ai-partner@latest\n```\n\n13 agent skills · 7 workflow commands · 4 automation hooks · Claude Code, Cursor, and Codex\n\n\n\n> **Finding this useful?** [Star this repo](https://github.com/ahmedkhaledmohamed/PM-AI-Partner-Framework) — it helps others discover it and lets me know it's working!\n>\n> **Questions or feedback?** [Quick survey](https://docs.google.com/forms/d/e/1FAIpQLScOSVX0EGYYZpnanXxpwofhcng4BqY7ddFBKaqQhB1PvCkShA/viewform) (2 min) · [Start a discussion](https://github.com/ahmedkhaledmohamed/PM-AI-Partner-Framework/discussions) · [Share your experience](https://github.com/ahmedkhaledmohamed/PM-AI-Partner-Framework/issues/new?template=success_story.md)\n\n---\n\n## Install the Plugin\n\n```bash\nnpx pm-ai-partner@latest\n```\n\nOne command installs 13 AI skills, 7 workflow commands, and 4 automation hooks. Works with Claude Code, Cursor, and Codex.\n\n**[See plugin details, all commands, and usage examples →](plugin/)**\n\n---\n\n## Or: Fork the Full Framework\n\nFor the complete methodology, workspace architecture, and templates:\n\n### 1. Fork This Repo\nClick \"Fork\" on GitHub (or clone directly).\n\n### 2. Customize Your Context\nEdit `CLAUDE.md` with your team/domain info:\n```markdown\n# My Workspace\n**My Role**: Product Manager\n**Domain**: [Your area]\n**Focus**: [Current priorities]\n```\n\n### 3. Start Working\nOpen in Cursor → Use AI as your thinking partner:\n- Draft ideas in `sandbox/`\n- Polish and share from `product-catalog/`\n\n---\n\n## What's Included\n\n```\npm-ai-partner-framework/\n├── CLAUDE.md # Main AI context (customize this!)\n├── sandbox/ # Your personal drafts & exploration\n│ ├── CLAUDE.md # Pre-configured for rough work\n│ └── _examples/ # Example files to learn from\n├── product-catalog/ # Polished work ready to share\n│ ├── CLAUDE.md # Pre-configured for quality output\n│ └── _examples/ # Example polished docs\n├── framework/ # Framework documentation\n│ ├── core/ # Agent modes, workflows, philosophy\n│ │ ├── pm-ai-partner-framework.md # Full guide\n│ │ ├── quick-reference.md # Cheat sheet\n│ │ ├── starter-prompts.md # Copy-paste prompts\n│ │ └── workflows/ # Repeatable patterns\n│ ├── templates/ # Config templates (CLAUDE.md, mcp.json)\n│ ├── demo/ # Demo scripts & materials\n│ └── examples/ # Case studies\n├── getting-started.md # Detailed setup guide\n└── site/ # Visual landing page\n```\n\n---\n\n## The Core Idea\n\n> **PM work is reconciling four sources of truth. AI helps you explore each faster. Judgment stays human.**\n\n```mermaid\ngraph TD\n CODE[\"**CODE**
Technical
What CAN happen?\"] --> R\n DOCS[\"**DOCS**
Contextual
What's expected?\"] --> R\n DATA[\"**DATA**
Empirical
What IS happening?\"] --> R\n JUDGMENT[\"**JUDGMENT**
Human
What SHOULD happen?\"] --> R\n\n R[\"**RECONCILIATION**
(AI + Human)\"] --> D[\"**DECISION**\"]\n\n style CODE fill:#1e3a5f,stroke:#3b82f6,color:#f8fafc\n style DOCS fill:#1a3a2a,stroke:#22c55e,color:#f8fafc\n style DATA fill:#3a2a1a,stroke:#f59e0b,color:#f8fafc\n style JUDGMENT fill:#3b1f5e,stroke:#a855f7,color:#f8fafc\n style R fill:#1a1a2e,stroke:#6366f1,color:#f8fafc\n style D fill:#1a2e1a,stroke:#22c55e,color:#f8fafc\n```\n\n---\n\n## Six Agent Modes\n\nTell AI which \"hat\" to wear for your task:\n\n\n\n| Mode | When to Use | Try Saying |\n|------|-------------|------------|\n| **Thought Partner** | Brainstorming, exploring options | \"Help me think through this problem...\" |\n| **Technical Analyst** | Understanding systems, code | \"Explain how [X] works...\" |\n| **Writer** | Creating documents | \"Help me write a [brief/strategy/email]...\" |\n| **Devil's Advocate** | Stress-testing ideas | \"Challenge this proposal...\" |\n| **Builder** | Creating tools, scripts | \"Build me a simple [X]...\" |\n| **Data Analyst** | Analyzing metrics | \"What patterns do you see in this data?\" |\n\n---\n\n## Twelve Workflow Patterns\n\nRepeatable processes for common PM tasks:\n\n| # | Pattern | When to Use |\n|---|---------|-------------|\n| 1 | Strategic Clarity | New role, team needs definition |\n| 2 | Planning Cycle | Quarterly/sprint planning |\n| 3 | Codebase Discovery | Understanding what actually exists |\n| 4 | Tool Building | Creating internal tools |\n| 5 | Communication Prep | Presentations, dev talks |\n| 6 | PM-Eng Bridge | Translating code ↔ product |\n| 7 | Data Investigation | Metrics analysis |\n| 8 | Doc Restructuring | Fixing confusing docs |\n| 9 | Analysis Pipeline | Data question → shareable presentation |\n| 10 | Documenting AI Work | Capturing PM thinking for PRs |\n| 11 | Model Routing | Choosing the right model per task |\n| 12 | Deep Research | Multi-source research with verification |\n\n---\n\n## Skills & Commands\n\n13 agent skills and 7 workflow commands you can invoke via `/command` or auto-trigger by context:\n\n| Type | Skills |\n|------|--------|\n| Agent Modes (6) | `/thought-partner`, `/technical-analyst`, `/writer`, `/devil-advocate`, `/builder`, `/data-analyst` |\n| Scenarios (3) | `/product-brief`, `/meeting-prep`, `/stakeholder-update` |\n| Workflows (1) | `/strategic-clarity` |\n| Analysis (2) | `/hypothesis-tester`, `/competitor-analyst` |\n| Accountability (1) | `/thinking-trail` |\n| Commands (7) | `/pm:plan-week`, `/pm:write-brief`, `/pm:prep-meeting`, `/pm:audit-codebase`, `/pm:competitor-scan`, `/pm:metrics-review`, `/pm:thinking-trail` |\n\nEach skill includes instructions, examples, and lessons learned from real usage.\n\n**Quick install:** `npx pm-ai-partner@latest` — or manually from [`plugin/`](plugin/) or [`framework/templates/skills/`](framework/templates/skills/).\n\n---\n\n## Key Resources\n\n| Need | Go To |\n|------|-------|\n| **Install the plugin** | `npx pm-ai-partner@latest` or [`plugin/`](plugin/) |\n| **Get set up** | [`getting-started.md`](getting-started.md) |\n| Full framework guide | [`framework/core/pm-ai-partner-framework.md`](framework/core/pm-ai-partner-framework.md) |\n| One-page cheat sheet | [`framework/core/quick-reference.md`](framework/core/quick-reference.md) |\n| Copy-paste prompts | [`framework/core/starter-prompts.md`](framework/core/starter-prompts.md) |\n| Config templates | [`framework/templates/`](framework/templates/) |\n| Cursor Skills | [`framework/templates/skills/`](framework/templates/skills/) |\n| Case study | [`framework/examples/case-studies/openclaw-deep-dive.md`](framework/examples/case-studies/openclaw-deep-dive.md) |\n| Workflow guides | [`framework/core/workflows/`](framework/core/workflows/) |\n| Presentations | [`site/presentations/`](site/presentations/) |\n| Release notes | [`RELEASE-NOTES.md`](RELEASE-NOTES.md) |\n\n---\n\n## Customization Guide\n\n### Essential (Do First)\n1. Edit `CLAUDE.md` with your context\n2. Review `sandbox/_examples/` and `product-catalog/_examples/`\n3. Delete example files when you understand the pattern\n\n### Optional (Power Users)\n- Copy templates from `framework/templates/` as needed\n- Set up MCP tools (see `getting-started.md`)\n- Customize `.cursorrules` for your preferences\n\n---\n\n## Contributing\n\nWe welcome contributions! See [`CONTRIBUTING.md`](CONTRIBUTING.md) for ways to help:\n\n- Share your success stories\n- Report issues or suggest features\n- Add examples and case studies\n- Improve documentation\n\n---\n\n## Author & Contact\n\n**Author:** Ahmed Khaled Mohamed \n**LinkedIn:** [Ahmed Khaled](https://linkedin.com/in/ahmedkhaledmohamed)\n\n---\n\n## Star History\n\n[](https://star-history.com/#ahmedkhaledmohamed/PM-AI-Partner-Framework&Date)\n\n---\n\n## Related\n\n- **Plugin (npm):** [`npx pm-ai-partner@latest`](plugin/) — install skills, commands, and hooks\n- **Framework Website:** [`site/index.html`](site/index.html)\n- **Case Study:** [OpenClaw Deep Dive](framework/examples/case-studies/openclaw-deep-dive.md) — the framework in action\n- **Substack Article:** [PM AI Partner Framework](https://substack.com/home/post/p-184388693)\n\n---\n\n*Version 3.1.0 · July 2026*\n",
"bytes": 8847,
"sha": "b604cb52144147410107c55bbc1f37f2880ffa455556a0caa6bf33091b73edd2",
"repo_slug": "ahmedkhaledmohamed/pm-ai-partner-framework",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/plg_ahmedkhaledmohamed_pm_ai_partner_framewo_306080e5/readme"
}