diff --git a/base-action/action.yml b/base-action/action.yml
index fec2cf5..c7ee853 100644
--- a/base-action/action.yml
+++ b/base-action/action.yml
@@ -73,15 +73,15 @@ inputs:
     default: ""
   json_schema:
     description: |
-      JSON schema for structured output validation. Claude must return JSON matching this schema 
-      or the action will fail. Outputs are automatically set for each field.
+      JSON schema for structured output validation. Claude must return JSON matching this schema
+      or the action will fail. All fields are returned in a single structured_output JSON string.
 
-      Access outputs via: steps.<step-id>.outputs.<field_name>
+      Access outputs via: fromJSON(steps.<step-id>.outputs.structured_output).<field_name>
 
       Limitations:
-      - Field names must start with letter or underscore (A-Z, a-z, _)
-      - Special characters in field names are replaced with underscores
-      - Each output is limited to 1MB
+      - All fields are returned in a single structured_output JSON string
+      - Field names can use any valid JSON property name (including hyphens, special characters, etc.)
+      - The entire structured_output string is limited to 1MB
     required: false
     default: ""