docs: port cross-repo map from owl/REPO_MAP.md into claude-shared - #15
Merged
Conversation
Migrates the non-duplicated parts of the local owl/REPO_MAP.md into the org source of truth: - architecture.md §6: cross-repo connection matrix (who-calls-whom grid) - architecture.md §4: live-endpoints table (prod nodes, *.retina.fm, LAN UIs) - architecture.md §5: add `docs` and `claude-shared` rows - docs/cross-cutting-changes.md: "I need to change X, where do I look?" guide Applies the survey corrections already in architecture.md rather than the older REPO_MAP framing: the vendored libs (tracker/geolocator/analytics) run in-process inside the central server, not as tracker-host subprocesses, and the node→central detection forward is flagged config-gated. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
- §1 system context and §2 signal chain: ASCII art → Mermaid flowcharts - §6: replace the dense who-calls-whom table with two readable Mermaid views (runtime data/API calls; build/deploy/hardware coupling); keep the exhaustive matrix collapsed in a <details> block as the precise reference Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Migrates the non-duplicated parts of the local
owl/REPO_MAP.mdinto the org source of truth so there's one place for cross-repo architecture, and modernizes the diagrams.What's here
Content ported from REPO_MAP.md
architecture.md§6 — cross-repo connection matrix (who-calls-whom)architecture.md§4 — live-endpoints table (prod nodes,*.retina.fm, LAN UIs)architecture.md§5 — addeddocsandclaude-sharedrowsdocs/cross-cutting-changes.md(new) — "I need to change X, where do I look?" blast-radius guide, linked from the READMEDiagrams → Mermaid
<details>block as the precise referenceCorrections baked in
Adopts the survey-verified framing already in
architecture.mdrather than the older REPO_MAP wording:tracker-hostsubprocessesdisabledon the node surveyed)Review notes
CLAUDE.mdviasetup-repo, not the org doc.REPO_MAP.mdhas been trimmed locally to point here for the migrated sections.🤖 Generated with Claude Code