From 15ab06f3e74011cf6c8bfabc65ff6fa6158d542e Mon Sep 17 00:00:00 2001
From: VinPropane <don@donmail.org>
Date: Mon, 4 May 2026 21:24:25 -0400
Subject: [PATCH] docs: note canonical GitHub org for Linear and doc links

---
 docs/plans/README.md | 4 ++++
 1 file changed, 4 insertions(+)

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)).