Skip to content

docs: add geolocation architecture to CLAUDE.md - #4103

Open
ben-dz wants to merge 1 commit into
mainfrom
bdz/geolocation-claude-md
Open

docs: add geolocation architecture to CLAUDE.md#4103
ben-dz wants to merge 1 commit into
mainfrom
bdz/geolocation-claude-md

Conversation

@ben-dz

@ben-dz ben-dz commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Adds a Geolocation Architecture section to CLAUDE.md documenting the telemetry-agent / geoprobe-agent split, which is easy to get backwards.

  • telemetry-agent runs on DZDs (Arista devices) and measures geoprobes via TWAMP; DZDs are the roots of trust with known coordinates.
  • geoprobe-agent runs on geoprobe servers (not DZDs), caches DZD location offsets, and measures outbound targets.

The two binaries have opposite roles — DZDs measure geoprobes; geoprobes measure targets — and nothing in the repo's guidance captures that today, so it's a recurring source of confusion when working on geolocation.

Docs only; no code or tests affected.

@ben-dz
ben-dz requested a review from nikw9944 July 29, 2026 14:43
@ben-dz
ben-dz enabled auto-merge (squash) July 29, 2026 14:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants