diff --git a/get-shit-done/bin/gsd-tools.cjs b/get-shit-done/bin/gsd-tools.cjs
index f2599c010..382aa4cb0 100755
--- a/get-shit-done/bin/gsd-tools.cjs
+++ b/get-shit-done/bin/gsd-tools.cjs
@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 
 /**
+ * @deprecated The supported programmatic surface is `gsd-sdk query` (SDK query registry)
+ * and the `@gsd-build/sdk` package. This Node CLI remains the compatibility implementation
+ * for shell scripts and older workflows; prefer calling the SDK from agents and automation.
+ *
  * GSD Tools — CLI utility for GSD workflow operations
  *
  * Replaces repetitive inline bash patterns across ~50 GSD command/workflow/agent files.