diff --git a/docs/plans/README.md b/docs/plans/README.md
index 344e9ee..6533c0d 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -9,6 +9,10 @@ A small number of files keep the historical **Jira / Atlassian `NEON-*`** key in
 - Each such file includes a short **Historical** banner at the top pointing at the matching **`NEO-*`** plan (same scope) where kickoff and commits should align.
 - Prefer opening and linking **`NEO-*`** issues and plans for new contributors.
 
+## GitHub links in Linear (and docs)
+
+The canonical public repo path is **`ViPro-Technologies/neon-sprawl`** (see `git remote`). Use that org in **raw GitHub** markdown links (`https://github.com/ViPro-Technologies/neon-sprawl/blob/main/...`). The path **`neon-sprawl/neon-sprawl`** is not the live repo and will **404**.
+
 ## Conventions
 
 - New or moved plans: `docs/plans/{LINEAR_KEY}-implementation-plan.md` (see [story kickoff](../../.cursor/rules/story-kickoff.md)).