diff --git a/src/content/docs/docs/how-to-use-promptless/interacting-with-promptless-p-rs.mdx b/src/content/docs/docs/how-to-use-promptless/interacting-with-promptless-p-rs.mdx
index c98572d0..30dcde21 100644
--- a/src/content/docs/docs/how-to-use-promptless/interacting-with-promptless-p-rs.mdx
+++ b/src/content/docs/docs/how-to-use-promptless/interacting-with-promptless-p-rs.mdx
@@ -14,6 +14,10 @@ import Info from '@components/fern/Info.astro';
 
 After Promptless opens a docs PR, you can provide follow-on instructions directly through GitHub comments. Promptless automatically handles quality issues (like linter failures, Vale warnings, or broken links) that arise in documentation PRs, so manual feedback can focus on content improvements rather than technical fixes.
 
+<Info>
+Currently, tagging @Promptless in comments only works on documentation PRs that Promptless has opened—it doesn't work on source code PRs or issues. This is a temporary limitation while we rebuild the system to handle more contexts. Soon, @Promptless mentions will work everywhere on GitHub, including issues and PRs on any repository.
+</Info>
+
 ## Comment trigger modes
 
 Configure how Promptless responds to comments on documentation PRs:
diff --git a/src/content/docs/docs/how-to-use-promptless/providing-feedback.mdx b/src/content/docs/docs/how-to-use-promptless/providing-feedback.mdx
index aff06bb1..fea400b1 100644
--- a/src/content/docs/docs/how-to-use-promptless/providing-feedback.mdx
+++ b/src/content/docs/docs/how-to-use-promptless/providing-feedback.mdx
@@ -7,6 +7,7 @@ sidebar:
   order: 26
 ---
 import Frame from '@components/fern/Frame.astro';
+import Info from '@components/fern/Info.astro';
 
 Provide feedback on suggestions through request changes, inline comments, overall comments, or close feedback. Each method lets you request immediate changes or save preferences for future suggestions.
 
@@ -103,6 +104,10 @@ You can also provide additional context in the feedback field. Check "Remember t
 
 Leave comments directly in the GitHub PR interface to provide feedback. Tag @Promptless in any line comment to request changes.
 
+<Info>
+Currently, tagging @Promptless in comments only works on documentation PRs that Promptless has opened—it doesn't work on source code PRs or issues. This is a temporary limitation while we rebuild the system to handle more contexts. Soon, @Promptless mentions will work everywhere on GitHub, including issues and PRs on any repository.
+</Info>
+
 Promptless reads all previous comments in the thread to understand context, so you can give brief instructions like "same change here" or "apply this to the other sections too."
 
 <Frame>