Files
koios/prompts/tools/periplus.md
Robert Helewka b7e0dc927f docs(personal): restructure bourdain docs to separate system prompt
Refactor documentation to distinguish character reference from AI
system prompt. Removed user context and persona definitions.
System prompt instructions moved to prompts/personal/bourdain.md.
2026-05-21 06:53:04 -04:00

1.4 KiB

Periplus (maps, bookmarks, collections, directions)

Periplus is the canonical store for places — bookmarks with real coordinates, organized into collections, with routing between them. Backed by OpenStreetMap (Nominatim for search, OSRM for directions).

  • NEVER estimate coordinates. Always call search_places to look them up. Estimated coordinates put bookmarks in the ocean. This rule has no exceptions, even for "obvious" landmarks.
  • Workflow for any new place: search_places("place name") → use the returned lat/lng for create_bookmark. Step 1 is non-negotiable.
  • Search before creating bookmarks. Run search_bookmarks first to avoid duplicates. Bookmarks aren't deduplicated by coordinates automatically.
  • Periplus is the place; Neo4j is the interpretation. Periplus holds the lat/lng and address. Neo4j holds what Robert did there (Activity, Restaurant, Observation). Link by storing the Periplus bookmark UUID on the Neo4j node when relevant.
  • Tags are JSON strings. Pass '{"category": "restaurant"}', not a dict.
  • Waypoints for get_directions are semicolon-separated lat,lng pairs: "45.42,-75.70;45.50,-73.57". Get this format wrong and routing fails silently.
  • Collections are non-exclusive. A bookmark can be in many collections. Adding to one doesn't remove from others.
  • import_bookmarks reads server-side paths. Absolute path on the Periplus server's filesystem, not the client's.