Merge pull request #22 from mojwang/feat/product-manager-evolution

feat(mcp): intelligent API key validation with caching and cleanup

Author: mojwang

.claude-agents.json

@@ -197,6 +197,143 @@
         "default": "Debug and fix MCP server issues",
         "setup": "Configure and test MCP server installation"
       }
+    },
+    
+    "product_manager": {
+      "name": "Product Manager",
+      "enabled": true,
+      "priority": "high",
+      "triggers": [
+        "on_prd_provided",
+        "on_complex_project",
+        "on_task_management_request",
+        "on_multi_step_feature"
+      ],
+      "configuration": {
+        "discovery_methods": {
+          "customer_interviews": "simulated_personas",
+          "surveys": "ai_generated_responses",
+          "usability_testing": "heuristic_evaluation",
+          "market_analysis": "web_research",
+          "competitive_analysis": "automated_comparison"
+        },
+        "risk_assessment": {
+          "value_risk": true,
+          "usability_risk": true,
+          "feasibility_risk": true,
+          "viability_risk": true
+        },
+        "frameworks": [
+          "opportunity_assessment",
+          "jobs_to_be_done",
+          "design_thinking",
+          "lean_startup",
+          "dual_track_agile"
+        ],
+        "auto_parse_prd": true,
+        "analyze_complexity": true,
+        "research_enabled": "auto",
+        "break_down_tasks": true,
+        "track_progress": true
+      },
+      "prompts": {
+        "default": "Parse PRD and create comprehensive task breakdown with implementation plan",
+        "discovery": "Conduct product discovery: identify customer problems, assess four risks, define success metrics",
+        "opportunity": "Create opportunity assessment: problem, target user, market size, success criteria",
+        "validation": "Validate assumptions through customer interviews and rapid prototyping",
+        "prioritization": "Prioritize using ICE (Impact, Confidence, Ease) or RICE framework",
+        "roadmap": "Create outcome-based roadmap focused on customer value, not features",
+        "research": "Research technical requirements and create detailed implementation tasks",
+        "complexity": "Analyze task complexity and suggest optimal implementation order"
+      }
+    },
+    
+    "customer_persona": {
+      "name": "Customer Persona Simulator",
+      "enabled": true,
+      "priority": "normal",
+      "triggers": [
+        "on_customer_research",
+        "on_interview_simulation",
+        "on_feedback_needed"
+      ],
+      "configuration": {
+        "persona_types": [
+          "early_adopter",
+          "power_user",
+          "casual_user",
+          "skeptical_user",
+          "enterprise_buyer"
+        ],
+        "response_styles": {
+          "interview": "conversational",
+          "survey": "structured",
+          "feedback": "detailed"
+        }
+      },
+      "prompts": {
+        "default": "Simulate diverse customer perspectives for product validation",
+        "interview": "Respond to interview questions as different user personas",
+        "feedback": "Provide detailed product feedback from various user perspectives"
+      }
+    },
+    
+    "market_research": {
+      "name": "Market Research Analyst",
+      "enabled": true,
+      "priority": "normal",
+      "triggers": [
+        "on_market_analysis",
+        "on_competitive_research",
+        "on_sizing_request"
+      ],
+      "configuration": {
+        "research_methods": [
+          "competitive_analysis",
+          "market_sizing",
+          "trend_analysis",
+          "technology_adoption"
+        ],
+        "data_sources": {
+          "primary": "web_research",
+          "secondary": "industry_reports",
+          "tertiary": "expert_synthesis"
+        }
+      },
+      "prompts": {
+        "default": "Analyze market trends and competitive landscape",
+        "competitive": "Identify and analyze key competitors and their features",
+        "sizing": "Estimate market size and growth potential"
+      }
+    },
+    
+    "ux_research": {
+      "name": "UX Research Specialist",
+      "enabled": true,
+      "priority": "normal",
+      "triggers": [
+        "on_usability_testing",
+        "on_heuristic_evaluation",
+        "on_accessibility_check"
+      ],
+      "configuration": {
+        "evaluation_methods": [
+          "nielsen_heuristics",
+          "cognitive_walkthrough",
+          "accessibility_wcag",
+          "information_architecture"
+        ],
+        "testing_approaches": {
+          "heuristic": "expert_review",
+          "usability": "simulated_testing",
+          "accessibility": "automated_checks"
+        }
+      },
+      "prompts": {
+        "default": "Evaluate usability and user experience",
+        "heuristic": "Perform heuristic evaluation using Nielsen's principles",
+        "accessibility": "Check accessibility compliance and inclusive design"
+      }
     }
   },
 
@@ -212,6 +349,18 @@
       ]
     },
 
+    "complex_project": {
+      "description": "Complex project implementation with PRD",
+      "sequence": [
+        "product_manager",
+        "development",
+        "shell",
+        "security",
+        "quality",
+        "documentation"
+      ]
+    },
+    
     "security_audit": {
       "description": "Comprehensive security audit",
       "parallel": [
@@ -251,6 +400,29 @@
         "configuration",
         "quality"
       ]
+    },
+    
+    "product_discovery": {
+      "description": "Product discovery and validation process",
+      "sequence": [
+        "product_manager",
+        "customer_persona",
+        "market_research",
+        "ux_research",
+        "product_manager"
+      ]
+    },
+    
+    "customer_validation": {
+      "description": "Customer validation through simulated interviews",
+      "parallel": [
+        "customer_persona",
+        "market_research"
+      ],
+      "then": [
+        "product_manager",
+        "ux_research"
+      ]
     }
   },
 

CLAUDE.md

@@ -16,13 +16,29 @@ Automated macOS dev environment setup for Apple Silicon.
 3. Backup before system changes
 4. Use modular zsh config in `.config/zsh/`
 
-## Git Workflow
-- **Worktrees**: Siblings with `.purpose` suffix (e.g., `macbook-dev-setup.review`)
+## Git Workflow (ENFORCED)
+- **Feature branches required**: ALL changes, no exceptions
+- **Worktrees mandatory**: Complex features (3+ files or multi-step)
+- **Auto-commit allowed**: Only on feature branches
+- **PR creation**: Manual after feature complete
+- **Branch protection**: Main branch is read-only for Claude
 - **Quick switch**: `gw main`, `gw review`, `gw hotfix`, or `gwcd` for interactive
 - **Stacked PRs**: `gt` (Graphite CLI) for dependent changes
-- **Commits**: `gc*` aliases for conventional format
 - See `docs/GIT-WORKFLOW.md` for details
 
+## Git Rules (STRICT)
+- **NEVER commit to main**: Always check branch first with `git branch --show-current`
+- **Branch naming**: feat/, fix/, docs/, chore/, refactor/, test/
+- **Auto-commit complete work**: Only on feature branches
+- **Descriptive messages**: Capture full scope of changes
+- **Smart commit timing**: 
+  - ✅ Commit: Complete features, verified fixes, finished refactors
+  - ❌ Wait: Sub-tasks, failing tests, incomplete changes
+- **Conventional format**: Use `type(scope): description`
+- **Examples**:
+  - `feat(agents): evolve TaskMaster into Product Manager with discovery workflows`
+  - `fix(git): enforce feature branch workflow for all commits`
+
 ## Key Directories
 - `/lib`: Core libraries (common.sh, signal-safety.sh)
 - `/scripts`: Component installers and utilities
@@ -47,8 +63,28 @@ Automated macOS dev environment setup for Apple Silicon.
 - [MCP Servers](docs/MCP_SERVERS.md) - Claude integrations
 - [Claude Agents](docs/CLAUDE_AGENTS.md) - Sub-agent architecture
 
+## MCP Server Priority
+1. **Context7**: Library docs, code examples, API references (check first)
+2. **Taskmaster**: Direct task management commands via MCP
+3. **Exa**: General web research (fallback for non-code queries)
+
+Note: For product discovery and PRD workflows, use "Product Manager" as a sub-agent via the Task tool
+
+## Taskmaster/Product Manager Configuration
+- **As "taskmaster" MCP Server**: Direct task commands (`task-master list`, `task-master next`)
+- **As "Product Manager" Sub-Agent**: Product discovery, PRD parsing, customer validation via Task tool
+- **Research**: Enabled if PERPLEXITY_API_KEY set, gracefully disabled otherwise
+- To enable research: Add `export PERPLEXITY_API_KEY="your-key"` to `~/.config/zsh/51-api-keys.zsh`
+- **Naming Convention**: "taskmaster" for MCP operations, "Product Manager" for agent workflows
+
 ## Agent Workflows for This Project
 
+### Complex Project Implementation:
+1. **Product Manager Agent** → Discovery, validate, prioritize
+2. **Development Agent** → Implement features
+3. **Quality Agent** → Test implementation
+4. **Documentation Agent** → Update docs
+
 ### Shell Script Development:
 1. **Create/Modify** → Shell Script Agent (validation)
 2. **Security Check** → Security Agent (scan for vulnerabilities)  

docs/CLAUDE_AGENTS.md

@@ -65,6 +65,94 @@ Claude Code's Task tool enables launching specialized agents for complex, multi-
 "Implement a new installer for Docker Desktop with proper error handling"
 ```
 
+## Product Discovery Agents
+
+### Product Manager Agent
+**Purpose**: Comprehensive product management and discovery  
+**Triggers**:
+- PRD provided
+- Feature requests
+- Product discovery needed
+- Validation required
+
+**Responsibilities**:
+- Product discovery and validation
+- Risk assessment (Value, Usability, Feasibility, Viability)
+- Customer problem identification
+- Opportunity assessment
+- Prioritization (ICE/RICE frameworks)
+- Outcome-based roadmapping
+- PRD parsing and task breakdown
+
+**Techniques**:
+- Jobs-to-be-done framework
+- Design thinking
+- Lean startup methodology
+- Dual-track agile
+- Rapid prototyping
+
+**Example Activation**:
+```
+"Conduct product discovery for the new payment feature"
+```
+
+### Customer Persona Agent
+**Purpose**: Simulate diverse customer perspectives  
+**Triggers**:
+- Customer research needed
+- Interview simulation
+- Feedback collection
+
+**Responsibilities**:
+- Generate realistic user personas
+- Respond to interviews in character
+- Provide product feedback
+- Express pain points and needs
+- Simulate different user types
+
+**Example Activation**:
+```
+"Interview 5 different personas about the checkout experience"
+```
+
+### Market Research Agent
+**Purpose**: Market analysis and competitive intelligence  
+**Triggers**:
+- Market analysis requests
+- Competitive research
+- Market sizing needed
+
+**Responsibilities**:
+- Competitive analysis
+- Market sizing estimates
+- Trend analysis
+- Technology adoption tracking
+- Industry insights
+
+**Example Activation**:
+```
+"Analyze the competitive landscape for developer tools"
+```
+
+### UX Research Agent
+**Purpose**: Usability and user experience evaluation  
+**Triggers**:
+- Usability testing
+- Heuristic evaluation
+- Accessibility checks
+
+**Responsibilities**:
+- Nielsen's heuristic evaluation
+- Cognitive walkthroughs
+- Accessibility assessment (WCAG)
+- Information architecture review
+- Usability testing simulation
+
+**Example Activation**:
+```
+"Perform heuristic evaluation of the onboarding flow"
+```
+
 ## Specialized Agents
 
 ### 4. Shell Script Specialist Agent
@@ -382,7 +470,19 @@ Common issues and solutions:
 
 ## Examples
 
-### Example 1: Full System Update
+### Example 1: Product Discovery Sprint
+```
+User: "I want to build a CLI tool for managing git worktrees"
+
+Agents activated:
+1. Product Manager - Define opportunity and risks
+2. Customer Persona - Interview developer personas
+3. Market Research - Analyze existing solutions
+4. UX Research - Evaluate usability patterns
+5. Product Manager - Synthesize and prioritize
+```
+
+### Example 2: Full System Update
 ```
 User: "Update all dependencies and ensure everything still works"