diff --git a/docs/reference/storage/backups.md b/docs/reference/storage/backups.md
index 0221d73..44cb7cc 100644
--- a/docs/reference/storage/backups.md
+++ b/docs/reference/storage/backups.md
@@ -35,7 +35,7 @@ Daily automated backups from [[indri]] to [[sifaka | Sifaka]] NAS.
 
 ## Sifaka-Native Data
 
-Some data lives directly on [[sifaka | Sifaka]] rather than being backed up to it (photos via [[immich]], music via [[navidrome]], video via [[jellyfin]]). See [[sifaka | Sifaka]] for data protection details.
+Some data lives directly on [[sifaka]] rather than being backed up to it (photos via [[immich]], music via [[navidrome]], video via [[jellyfin]]). See [[sifaka]] for data protection details.
 
 ## What Is NOT Backed Up
 
diff --git a/docs/tutorials/ai-assistance-guide.md b/docs/tutorials/ai-assistance-guide.md
index b6dbcc3..454e7e4 100644
--- a/docs/tutorials/ai-assistance-guide.md
+++ b/docs/tutorials/ai-assistance-guide.md
@@ -59,6 +59,15 @@ echo "Description" > docs/changelog.d/branch-name.feature.md
 
 Types (file suffix): `.feature`, `.bugfix`, `.infra`, `.doc`, `.misc`
 
+### Wiki-Link Formatting
+
+Use simple wiki-links without alternate text or extra spaces:
+- Prefer `[[borgmatic]]` over `[[borgmatic | Borgmatic]]`
+- Only use alternate text when grammatically warranted (e.g., `[[cluster|Kubernetes]]` reads better than `[[cluster]]`)
+- No spaces around the pipe: `[[path|Text]]` not `[[ path | Text ]]`
+
+When editing documentation, rewrite links to follow this convention as you encounter them.
+
 ## Service Locations
 
 Understanding where services run helps target changes correctly:
@@ -66,7 +75,7 @@ Understanding where services run helps target changes correctly:
 | Location | Services | Management |
 |----------|----------|------------|
 | [[indri]] (native) | Forgejo, Zot, Jellyfin, Caddy | Ansible |
-| [[cluster | Kubernetes]] | Everything else | ArgoCD |
+| [[cluster|Kubernetes]] | Everything else | ArgoCD |
 
 ## Mise Tasks
 
@@ -108,7 +117,7 @@ For AI agents building context:
 
 Credentials live in 1Password. Never retrieve them directly - use existing patterns:
 - Ansible `pre_tasks` gather secrets at playbook start
-- [[external-secrets|External Secrets]] syncs to Kubernetes
+- [[external-secrets]] syncs to Kubernetes
 - Scripts use `op` CLI with user biometric prompts
 
 ## Common Pitfalls