diff --git a/dot_config/AGENTS.md b/dot_config/AGENTS.md
index 48b98eb78f327f2598a54d260a3a8e9590ffaf71..36b4fb2bedc19fa65b96f159ab502ca8085e9738 100644
--- a/dot_config/AGENTS.md
+++ b/dot_config/AGENTS.md
@@ -110,12 +110,12 @@ I like using a bug tracker that embeds bugs and identities and conversations dir
 
 CLI for Lunatask (E2E encrypted productivity app). Names/contents are write-only due to encryption.
 
-**Conventions:** Resources accept UUIDs or `lunatask://` deeplinks as IDs, config keys for areas/goals/habits/notebooks, `-` for stdin, natural language for dates, and Markdown for content.
+**Conventions:** Resources accept UUIDs or `lunatask://` deeplinks (as `[title](lunatask://...)` links) as IDs, config keys for areas/goals/habits/notebooks, `-` for stdin, natural language for dates, and Markdown for content.
 
 Task notes are useful for storing context/prompts for future agent sessions—use a `TASK_ID` placeholder, then update with the real ID so agents can track progress.
 
 ```bash
-lune task add "Name" -a AREA -g GOAL -n "note" -s next
+lune task add "Name" -a AREA -g GOAL -n "[Person](lunatask://person/ID)" -s next
 lune task update ID -s completed
 lune jrnl "Entry"                    # or: lune journal add -d yesterday
 lune habit track KEY -d "2 days ago"