**High Priority Quick Win** - Demonstrates seamless PopKit feature integration
/plugin marketplace add jrc1883/popkit-claude/plugin install popkit-dev@popkit-claudeHigh Priority Quick Win - Demonstrates seamless PopKit feature integration
The PRD Parser agent transforms Product Requirements Documents (PRDs) into structured, actionable implementation plans with automatic complexity analysis and technology research.
complexity_scoring.py to score each feature (1-10 scale)This agent demonstrates seamless integration between PopKit features:
Complexity Analyzer (complexity_scoring.py)
WebSearch (Technology Research)
TodoWrite (Task Management)
/popkit:dev workflowsGitHub Issues (Project Tracking)
User: "Parse this PRD: docs/feature-spec.md"
The agent will:
š PRD PARSER COMPLETE
Document: User Authentication System
Features: 12 identified (4 LOW, 6 MEDIUM, 2 HIGH)
Complexity Analysis:
- Average: 5.8/10
- HIGH (7-10): 2 features requiring careful planning
- MEDIUM (4-6): 6 features for foundation building
- LOW (1-3): 4 features as quick wins
Technologies Researched:
ā Next.js 15 (via WebSearch) - Server Actions, PPR, Turbopack
ā Prisma ORM (existing knowledge)
ā Redis (existing knowledge)
Generated Artifacts:
ā TodoWrite: 12 tasks created
ā Breakdown: .workspace/prd-breakdown-user-auth-system.md
ā GitHub Issues: 2 HIGH priority issues (#42, #43)
Estimated Timeline: 28 days (4 weeks)
Next: /popkit:dev work 1
Located at: packages/shared-py/popkit_shared/utils/prd_parser.py
from popkit_shared.utils.prd_parser import parse_prd_file
# Parse a PRD file
result = parse_prd_file("docs/feature-spec.md")
# Access parsed features
for feature in result.features:
print(f"{feature.title}: {feature.complexity_score}/10")
print(f" Subtasks: {len(feature.acceptance_criteria)}")
print(f" Risks: {feature.complexity_analysis['risk_factors']}")
# Access technologies
for tech in result.technologies:
if tech.should_research:
print(f"Research: {tech.name} {tech.version}")
The PRD parser automatically invokes the complexity analyzer:
# Happens automatically in parse_prd_file()
from popkit_shared.utils.complexity_scoring import get_complexity_analyzer
analyzer = get_complexity_analyzer()
for feature in features:
analysis = analyzer.analyze(
feature.description,
metadata={
"acceptance_criteria": feature.acceptance_criteria,
"dependencies": feature.dependencies
}
)
feature.complexity_score = analysis.complexity_score
feature.complexity_analysis = analysis.to_dict()
Technologies are researched via WebSearch when needed:
# Auto-research unfamiliar technologies
for tech in result.technologies:
if tech.should_research:
# Use WebSearch tool
research = WebSearch(
query=f"{tech.name} {tech.version} overview best practices 2026"
)
# Extract key insights
tech.research_notes = extract_key_points(research)
Research triggers:
Skip research:
The parser expects markdown PRDs with this structure:
# Document Title
Brief overview...
## Features
### Feature Name (H3)
Feature description and requirements.
**Acceptance Criteria:**
- AC: User can do X
- AC: System must do Y
**Dependencies:**
- Requires: Feature Z
- Depends on: Service A
**Technical Requirements:**
- Use Technology X
- Implement pattern Y
Key patterns:
Test the PRD parser utility:
# Test with built-in sample
cd packages/shared-py
python popkit_shared/utils/prd_parser.py
# Test with actual PRD file
python popkit_shared/utils/prd_parser.py path/to/your-prd.md
Test the agent:
# Parse the test PRD
User: "Parse .workspace/test-prd-user-auth.md"
# Expected output:
# - 6 features extracted (Login, Registration, Password, OAuth, Session, Security)
# - Complexity scores for each
# - Technologies: Next.js 15, Prisma, Redis, OAuth
# - TodoWrite list created
# - Breakdown document generated
Time Savings:
Quality Improvements:
Integration Benefits:
/popkit:dev workflowsGiven this PRD:
# E-commerce Checkout Flow
## Features
### Shopping Cart
Persistent cart with quantity management.
- AC: User can add items to cart
- AC: User can update quantities
- AC: Cart persists across sessions
- Requires: Product catalog system
### Payment Processing
Secure payment with Stripe integration.
- AC: User can enter payment details
- AC: System processes payment securely
- AC: User receives order confirmation
- Depends on: Shopping cart completion
The parser produces:
Features: 2
- Shopping Cart [4/10]
- Subtasks: 2-4 recommended
- AC: 3 criteria
- Deps: 1 (Product catalog)
- Risks: None
- Payment Processing [7/10]
- Subtasks: 5-7 recommended
- AC: 3 criteria
- Deps: 1 (Shopping cart)
- Risks: security_critical, integration_complexity
TodoWrite: 2 tasks created
Estimated: 7-11 days total
Current (v1.0.0):
Future enhancements:
complexity_scoring.py) - Feature scoringgithub_issues.py) - Issue creationpackages/popkit-dev/agents/tier-2-on-demand/prd-parser/
āāā AGENT.md # Agent definition and instructions
āāā README.md # This file
āāā .../ # Future additions
packages/shared-py/popkit_shared/utils/
āāā prd_parser.py # Core parsing utility
āāā complexity_scoring.py # Complexity analysis
āāā github_issues.py # GitHub integration
.workspace/
āāā test-prd-user-auth.md # Example PRD for testing
To improve the PRD parser:
prd_parser.pyMIT - Part of PopKit plugin suite
You are an elite AI agent architect specializing in crafting high-performance agent configurations. Your expertise lies in translating user requirements into precisely-tuned agent specifications that maximize effectiveness and reliability.