Skip to content

docs: add Location Grounding section with example prompts#212

Draft
mattpodwysocki wants to merge 1 commit into
mainfrom
docs/grounding-example-prompts
Draft

docs: add Location Grounding section with example prompts#212
mattpodwysocki wants to merge 1 commit into
mainfrom
docs/grounding-example-prompts

Conversation

@mattpodwysocki

Copy link
Copy Markdown
Contributor

Summary

The ground_location_tool is the recommended entry point for coordinate-first queries (neighborhood, POI, reachability, routing), but the README doesn't mention it — a reader cloning the repo today wouldn't know it exists or when to reach for it.

This PR adds a Location Grounding subsection at the top of Example Prompts with four prompts, one per dispatch strategy the tool's classifier can pick:

  • Neighborhood"What neighborhood is 47.6097, -122.3408, and what's around me?"
  • POI"Coffee shops within a 10-minute walk of 40.7580, -73.9855"
  • Region"What can I reach in a 15-minute walk from 37.7749, -122.4194?"
  • Routing"Closest routable point to drop someone off at 34.0522, -118.2437"

Why a draft

A grounding blog series is in the works. Once the first post lands, a follow-up PR will replace the <!-- TODO --> placeholder with the live link and drop the "in the works" hedge. Keeping this as a draft until then so the team can review the prompt set without merging an empty link.

Test plan

  • Prompts trigger ground_location_tool (and not search-and-geocode or reverse_geocode_tool) when run against the server
  • Each prompt exercises a distinct classifier strategy (neighborhood / poi / region / routing)
  • README renders cleanly on GitHub (prettier already auto-formatted the italics)

🤖 Generated with Claude Code

The ground_location_tool is the recommended entry point for coordinate-first
queries (neighborhood, POI, reachability, routing), but the README didn't
mention it. Add a Location Grounding subsection at the top of Example Prompts
with four prompts — one per dispatch strategy — so readers see the tool's
range without needing to read the source.

Includes a TODO placeholder for the upcoming grounding blog post; a
follow-up PR will swap that for the live link once published.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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