Robert Helewka
b7e0dc927f
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.
13 lines
1.4 KiB
Markdown
13 lines
1.4 KiB
Markdown
# 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.
|