Productplan Pm

ProductPlan for Product Managers

Complete toolkit for day-to-day product management in ProductPlan.

The ID Chain Pattern

ProductPlan tools require IDs. Always list first, then drill down:

list_roadmaps → roadmap_id → get_roadmap_bars → bar_id → get_bar
list_objectives → objective_id → get_objective → key_result data
list_ideas → idea_id → get_idea → customer/tag data

Roadmap Management

View your roadmap

1. Call list_roadmaps to get roadmap IDs
2. Call get_roadmap_complete with roadmap_id for all data in one call
   • Returns bars, lanes, and milestones together
   • Faster than separate calls

Add a new feature

1. Get roadmap_id from list_roadmaps
2. Get lane_id from get_roadmap_lanes (pick the category)
3. Call manage_bar with:
   • action="create"
   • roadmap_id, lane_id
   • name, start_date, end_date (YYYY-MM-DD)

Reschedule a feature

1. Get bar_id from get_roadmap_bars
2. Call manage_bar with action="update", bar_id, new start_date and end_date

Move feature to different lane

1. Get bar_id from get_roadmap_bars
2. Get target lane_id from get_roadmap_lanes
3. Call manage_bar with action="update", bar_id, lane_id

Create feature dependencies

1. Get both bar IDs from get_roadmap_bars
2. Call manage_bar_connection with action="create", bar_id (source), target_bar_id

Add comments to features

1. Get bar_id from get_roadmap_bars
2. Call manage_bar_comment with action="create", bar_id, content

Link external resources

Call manage_bar_link with action="create", bar_id, url, title

Manage lanes

• Create: manage_lane with action="create", roadmap_id, name, color
• Reorder: manage_lane with action="update", lane_id, position
• Delete: manage_lane with action="delete", lane_id

Add milestones

Call manage_milestone with action="create", roadmap_id, name, date

OKR Workflows

Review quarterly objectives

1. Call list_objectives to see all objectives with progress percentages
2. For details, call get_objective with objective_id

Create new objective

Call manage_objective with action="create", name, description, time_frame (e.g., "Q1 2025")

Add key result to objective

Call manage_key_result with action="create", objective_id, name, start_value, target_value

Update key result progress

1. Get key_result_id from get_objective or list_key_results
2. Call manage_key_result with action="update", objective_id, key_result_id, current_value

Link features to objectives

Features can be linked to key results in the ProductPlan UI to show OKR alignment.

Idea Management

Triage incoming ideas

1. Call list_ideas to see all ideas with vote counts and status
2. For promising ideas, call get_idea for full details
3. Call get_idea_customers to see who requested it

Capture new idea

Call manage_idea with action="create", title, description

Tag ideas

1. Get idea_id from list_ideas
2. Call manage_idea_tag with action="add", idea_id, name (creates tag if new)

Link customer to idea

Call manage_idea_customer with action="add", idea_id, customer_name, customer_email

Promote idea to opportunity

1. Call manage_opportunity with action="create", problem_statement, description
2. Ideas can be linked to opportunities in the ProductPlan UI

Work with idea forms

• list_idea_forms - see available submission forms
• get_idea_form - get form details and fields

Launch Coordination

View upcoming launches

Call list_launches to see all launches with dates and status

Get launch details

Call get_launch with launch_id for full checklist and assignments

Nested Features

Create child features

1. Get parent bar_id from get_roadmap_bars
2. Call manage_bar with action="create" and parent_id set to parent bar_id

View feature hierarchy

Call get_bar_children with bar_id to see nested features

Error Handling

Common errors

Timeout guidance

• List operations: 1-3 seconds typical
• get_roadmap_complete: 3-5 seconds for large roadmaps
• Operations exceeding 10 seconds: check network connectivity
• Use health_check with deep=true to diagnose issues

Recovery steps

1. On error, call check_status to verify authentication
2. If auth fails, reconfigure API token
3. For "not found" errors, re-fetch IDs from list tools

Style Guidelines

DO

• Show features in tables: Name, Lane, Start Date, End Date, Status
• Display OKR progress as percentages
• Format dates as human-readable (March 15, 2025)
• Summarize lists over 10 items
• Include bar_id when referencing features for follow-up actions

DON'T

• Output raw JSON to users
• Show IDs without context
• List more than 10 items without offering to filter
• Mix YYYY-MM-DD and human-readable dates in same response

Tool Reference

Roadmap Tools

• list_roadmaps, get_roadmap, get_roadmap_complete
• get_roadmap_bars, get_roadmap_lanes, get_roadmap_milestones
• manage_bar, manage_lane, manage_milestone

Bar Tools

• get_bar, get_bar_children, get_bar_comments, get_bar_connections, get_bar_links
• manage_bar_comment, manage_bar_connection, manage_bar_link

OKR Tools

• list_objectives, get_objective, list_key_results
• manage_objective, manage_key_result

Idea Tools

• list_ideas, get_idea, get_idea_customers, get_idea_tags
• list_opportunities, get_opportunity
• list_idea_forms, get_idea_form
• manage_idea, manage_idea_customer, manage_idea_tag, manage_opportunity

Launch Tools

• list_launches, get_launch

Utility Tools

• check_status, health_check