Skip to content

Conversation

@mattpodwysocki
Copy link
Contributor

Summary

Add two new prompts that guide users through using the Map Matching and Optimization tools added in PR #89.

Builds on: #89

New Prompts

1. clean-gps-trace

Helps users clean and snap noisy GPS traces to actual roads:

  • Example: "Clean up this GPS trace from my bike ride"
  • Guides through parsing GPS coordinates (arrays or JSON)
  • Uses map_matching_tool with proper profile and parameters
  • Shows before/after visualization with confidence scores
  • Analyzes segments with low confidence

2. optimize-deliveries

Helps users find optimal routes for multiple stops:

  • Example: "Optimize my delivery route for these 10 addresses"
  • Automatically geocodes addresses to coordinates
  • Configures optimization with shipments format
  • Handles async polling for results
  • Shows time/distance savings and efficiency gains

Changes

Code

  • ✅ Added CleanGpsTracePrompt.ts with map matching workflow
  • ✅ Added OptimizeDeliveriesPrompt.ts with route optimization workflow
  • ✅ Updated promptRegistry.ts to include new prompts
  • ✅ Added comprehensive tests in promptRegistry.test.ts
  • ✅ Updated README with example prompts

Testing

npm test
# ✓ All 424 tests passing
# ✓ New prompt metadata tests verify structure
# ✓ Prompts follow kebab-case naming convention

Use Cases

Clean GPS Trace:

  • Fix fitness tracker routes with GPS drift
  • Clean recorded delivery routes
  • Snap tracked paths to actual roads

Optimize Deliveries:

  • Multi-stop delivery route planning
  • Tourist attraction visit ordering
  • Service call optimization

Integration

These prompts complement the tools in #89 by:

  • Providing clear step-by-step workflows
  • Handling input parsing and validation
  • Guiding visualization of results
  • Making complex tools more discoverable

🤖 Generated with Claude Code

Add two new prompts to guide users through using the Map Matching
and Optimization tools added in PR #89.

New Prompts:
- clean-gps-trace: Clean and snap noisy GPS traces to roads
  * Guides through parsing GPS coordinates
  * Uses map_matching_tool with proper parameters
  * Shows before/after visualization with confidence scores
  * Example: "Clean up this GPS trace from my bike ride"

- optimize-deliveries: Optimize multi-stop routes
  * Handles address geocoding automatically
  * Configures optimization with shipments format
  * Shows optimized route with efficiency metrics
  * Example: "Optimize my delivery route for these addresses"

Changes:
- Added CleanGpsTracePrompt.ts with map matching workflow
- Added OptimizeDeliveriesPrompt.ts with route optimization workflow
- Updated promptRegistry.ts with new prompts
- Added comprehensive tests in promptRegistry.test.ts
- Updated README.md with example prompts

Testing:
- All 424 tests passing ✓
- New prompt metadata tests verify correct structure
- Prompts follow kebab-case naming convention

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@mattpodwysocki mattpodwysocki requested a review from a team as a code owner January 6, 2026 04:17
@mattpodwysocki
Copy link
Contributor Author

Closing this PR - the prompts have been combined into PR #89 to simplify the review process. All prompt work is now included in that single PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant