diff --git a/apps/hook/commands/plannotator-annotate.md b/apps/hook/commands/plannotator-annotate.md
index 4da50d9e..9e645dbd 100644
--- a/apps/hook/commands/plannotator-annotate.md
+++ b/apps/hook/commands/plannotator-annotate.md
@@ -4,9 +4,11 @@ allowed-tools: Bash(plannotator:*)
 disable-model-invocation: true
 ---
 
-## Markdown Annotations
+## Instructions
 
-!`plannotator annotate $ARGUMENTS`
+Run `plannotator annotate $ARGUMENTS` using the Bash tool with `run_in_background: true`. This starts an annotation server and opens the browser. The user will annotate the document and submit feedback — this may take a long time.
+
+**Wait for the background task to complete before proceeding.** Do not interrupt or take other actions while the user is annotating.
 
 ## Your task
 
diff --git a/apps/hook/commands/plannotator-last.md b/apps/hook/commands/plannotator-last.md
index 51f8b5f4..76e0ae93 100644
--- a/apps/hook/commands/plannotator-last.md
+++ b/apps/hook/commands/plannotator-last.md
@@ -4,9 +4,11 @@ allowed-tools: Bash(plannotator:*)
 disable-model-invocation: true
 ---
 
-## Message Annotations
+## Instructions
 
-!`plannotator annotate-last $ARGUMENTS`
+Run `plannotator annotate-last $ARGUMENTS` using the Bash tool with `run_in_background: true`. This starts an annotation server and opens the browser. The user will annotate the message and submit feedback — this may take a long time.
+
+**Wait for the background task to complete before proceeding.** Do not interrupt or take other actions while the user is annotating.
 
 ## Your task
 
diff --git a/apps/hook/commands/plannotator-review.md b/apps/hook/commands/plannotator-review.md
index 6f3d544a..852ad790 100644
--- a/apps/hook/commands/plannotator-review.md
+++ b/apps/hook/commands/plannotator-review.md
@@ -4,10 +4,12 @@ allowed-tools: Bash(plannotator:*)
 disable-model-invocation: true
 ---
 
-## Code Review Feedback
+## Instructions
 
-!`plannotator review $ARGUMENTS`
+Run `plannotator review $ARGUMENTS` using the Bash tool with `run_in_background: true`. This starts a review server and opens the browser. The user will review code and submit feedback — this may take a long time.
+
+**Wait for the background task to complete before proceeding.** Do not interrupt or take other actions while the user is reviewing.
 
 ## Your task
 
-If the review above contains feedback or annotations, address them. If no changes were requested, acknowledge and continue.
+When the command finishes, read its output. If it contains feedback or annotations, address them. If no changes were requested, acknowledge and continue.