diff --git a/docs/agents.md b/docs/agents.md
index d6b719824..635bd11fc 100644
--- a/docs/agents.md
+++ b/docs/agents.md
@@ -34,6 +34,7 @@ Agents are generic on their `context` type. Context is a dependency-injection to
 ```python
 @dataclass
 class UserContext:
+    name: str
     uid: str
     is_pro_user: bool
 
diff --git a/docs/ja/agents.md b/docs/ja/agents.md
index 3fec8b644..edab75997 100644
--- a/docs/ja/agents.md
+++ b/docs/ja/agents.md
@@ -38,6 +38,7 @@ agent = Agent(
 ```python
 @dataclass
 class UserContext:
+    name: str
     uid: str
     is_pro_user: bool
 
diff --git a/docs/scripts/generate_ref_files.py b/docs/scripts/generate_ref_files.py
index 9deef7528..84ecdf148 100644
--- a/docs/scripts/generate_ref_files.py
+++ b/docs/scripts/generate_ref_files.py
@@ -31,6 +31,7 @@ def md_target(py_path: Path) -> Path:
     rel = py_path.relative_to(SRC_ROOT).with_suffix(".md")
     return DOCS_ROOT / rel
 
+
 def pretty_title(last_segment: str) -> str:
     """
     Convert a module/file segment like 'tool_context' to 'Tool Context'.
@@ -39,6 +40,7 @@ def pretty_title(last_segment: str) -> str:
     cleaned = last_segment.replace("_", " ").replace("-", " ")
     return capwords(cleaned)
 
+
 # ---- Main ------------------------------------------------------------