diff --git a/sdks/python/src/honcho/conclusions.py b/sdks/python/src/honcho/conclusions.py
index 6e572b60..7b5ff31d 100644
--- a/sdks/python/src/honcho/conclusions.py
+++ b/sdks/python/src/honcho/conclusions.py
@@ -66,7 +66,7 @@ class ConclusionScope:
         observed: str,
     ):
         """
-        Initialize an ConclusionScope.
+        Initialize a ConclusionScope.
 
         Args:
             client: The Honcho client instance
@@ -165,7 +165,7 @@ class ConclusionScope:
         Create conclusions in this scope.
 
         Args:
-            conclusions: Single conclusion or list of conclusions to create.
+            conclusions: List of conclusions to create.
                 Each conclusion can be a ConclusionCreateParams object or a dictionary with 'content' and 'session_id' keys.
 
         Returns:
@@ -173,12 +173,6 @@ class ConclusionScope:
 
         Example:
             ```python
-            # Create a single conclusion
-            conclusions = peer.conclusions.create(
-                {"content": "User prefers dark mode", "session_id": "session1"}
-            )
-
-            # Create multiple conclusions
             conclusions = peer.conclusions.create([
                 {"content": "User prefers dark mode", "session_id": "session1"},
                 {"content": "User is interested in AI", "session_id": "session1"},
@@ -388,7 +382,7 @@ class AsyncConclusionScope:
         Create conclusions in this scope.
 
         Args:
-            conclusions: Single conclusion or list of conclusions to create.
+            conclusions: List of conclusions to create.
                 Each conclusion can be a ConclusionCreateParams object or a dictionary with 'content' and 'session_id' keys.
 
         Returns:
@@ -396,12 +390,6 @@ class AsyncConclusionScope:
 
         Example:
             ```python
-            # Create a single conclusion
-            conclusions = await peer.conclusions.create(
-                {"content": "User prefers dark mode", "session_id": "session1"}
-            )
-
-            # Create multiple conclusions
             conclusions = await peer.conclusions.create([
                 {"content": "User prefers dark mode", "session_id": "session1"},
                 {"content": "User is interested in AI", "session_id": "session1"},
diff --git a/sdks/python/src/honcho/peer.py b/sdks/python/src/honcho/peer.py
index 50ecdf30..da0d90f2 100644
--- a/sdks/python/src/honcho/peer.py
+++ b/sdks/python/src/honcho/peer.py
@@ -634,7 +634,7 @@ class Peer(PeerBase):
         has made about themselves. Use this for self-conclusion scenarios.
 
         Returns:
-            An ConclusionScope scoped to this peer's self-conclusions
+            A ConclusionScope scoped to this peer's self-conclusions
 
         Example:
             ```python
@@ -663,7 +663,7 @@ class Peer(PeerBase):
             target: The target peer (either a Peer object or peer ID string)
 
         Returns:
-            An ConclusionScope scoped to this peer's conclusions of the target
+            A ConclusionScope scoped to this peer's conclusions of the target
 
         Example:
             ```python
diff --git a/sdks/typescript/src/conclusions.ts b/sdks/typescript/src/conclusions.ts
index e53217c5..cfb26dc2 100644
--- a/sdks/typescript/src/conclusions.ts
+++ b/sdks/typescript/src/conclusions.ts
@@ -7,7 +7,7 @@ import type { ConclusionCreateParam } from './types'
 export type { RepresentationOptions, ConclusionCreateParam }
 
 /**
- * An conclusion from the theory-of-mind system.
+ * A conclusion from Honcho's reasoning system.
  *
  * Conclusions are facts derived from messages that help build a representation
  * of a peer.
@@ -60,7 +60,7 @@ export class Conclusion {
   }
 
   /**
-   * Create an Conclusion from an API response object.
+   * Create a Conclusion from an API response object.
    *
    * @param data - API response data
    * @returns A new Conclusion instance
@@ -135,7 +135,7 @@ export class ConclusionScope {
   readonly observed: string
 
   /**
-   * Initialize an ConclusionScope.
+   * Initialize a ConclusionScope.
    *
    * @param client - The Honcho client instance
    * @param workspaceId - The workspace ID
diff --git a/sdks/typescript/src/peer.ts b/sdks/typescript/src/peer.ts
index fd9b69d1..8623f749 100644
--- a/sdks/typescript/src/peer.ts
+++ b/sdks/typescript/src/peer.ts
@@ -614,7 +614,7 @@ export class Peer {
    * This property provides a convenient way to access conclusions that this peer
    * has made about themselves. Use this for self-conclusion scenarios.
    *
-   * @returns An ConclusionScope scoped to this peer's self-conclusions
+   * @returns A ConclusionScope scoped to this peer's self-conclusions
    *
    * @example
    * ```typescript
@@ -639,7 +639,7 @@ export class Peer {
    * observer and the target is the observed peer.
    *
    * @param target - The target peer (either a Peer object or peer ID string)
-   * @returns An ConclusionScope scoped to this peer's conclusions of the target
+   * @returns A ConclusionScope scoped to this peer's conclusions of the target
    *
    * @example
    * ```typescript