diff --git a/lib/schema/src/opencodegraph.schema.json b/lib/schema/src/opencodegraph.schema.json
index 7933a292..d32b1ae0 100644
--- a/lib/schema/src/opencodegraph.schema.json
+++ b/lib/schema/src/opencodegraph.schema.json
@@ -24,7 +24,7 @@
           "type": "string"
         },
         "url": {
-          "description": "An external URL with more information.",
+          "description": "An external URL with more information about the annotation.",
           "type": "string",
           "format": "uri"
         },
@@ -33,8 +33,8 @@
           "$ref": "#/definitions/AnnotationUI"
         },
         "ai": {
-          "description": "Information from the annotation intended for consumption by AI, not humans.",
-          "$ref": "#/definitions/AnnotationAIInfo"
+          "description": "Information from the annotation intended for consumption by AI, not humans.222",
+          "$ref": "#/definitions/AssistantInfo"
         },
         "range": {
           "description": "The range in the file that this annotation applies to. If not set, the annotation applies to the entire file.",
@@ -58,7 +58,7 @@
         }
       }
     },
-    "AnnotationAIInfo": {
+    "AssistantInfo": {
       "description": "Information from an annotation intended for consumption by AI, not humans.",
       "type": "object",
       "additionalProperties": false,
diff --git a/lib/schema/src/opencodegraph.schema.ts b/lib/schema/src/opencodegraph.schema.ts
index 46bc904b..d8a72e08 100644
--- a/lib/schema/src/opencodegraph.schema.ts
+++ b/lib/schema/src/opencodegraph.schema.ts
@@ -13,11 +13,11 @@ export interface Annotation {
      */
     title?: string
     /**
-     * An external URL with more information.
+     * An external URL with more information about the annotation.
      */
     url?: string
     ui?: AnnotationUI
-    ai?: AnnotationAIInfo
+    ai?: AssistantInfo
     range?: Range
 }
 /**
@@ -34,9 +34,9 @@ export interface AnnotationUI {
     format?: 'markdown' | 'plaintext'
 }
 /**
- * Information from the annotation intended for consumption by AI, not humans.
+ * Information from the annotation intended for consumption by AI, not humans.222
  */
-export interface AnnotationAIInfo {
+export interface AssistantInfo {
     /**
      * Text content for AI to consume.
      */