diff --git a/src/schemas/json/claude-code-settings.json b/src/schemas/json/claude-code-settings.json
index cb002d793e3..9957f96e8a8 100644
--- a/src/schemas/json/claude-code-settings.json
+++ b/src/schemas/json/claude-code-settings.json
@@ -249,7 +249,7 @@
     },
     "model": {
       "type": "string",
-      "description": "Override the default model used by Claude Code"
+      "description": "Override the default model used by Claude Code. See https://code.claude.com/docs/en/model-config"
     },
     "enableAllProjectMcpServers": {
       "type": "boolean",
@@ -262,7 +262,7 @@
         "type": "string",
         "minLength": 1
       },
-      "description": "List of approved MCP servers from .mcp.json",
+      "description": "List of approved MCP servers from .mcp.json. See https://code.claude.com/docs/en/mcp",
       "examples": [["memory", "github"]]
     },
     "disabledMcpjsonServers": {
@@ -271,7 +271,7 @@
         "type": "string",
         "minLength": 1
       },
-      "description": "List of rejected MCP servers from .mcp.json",
+      "description": "List of rejected MCP servers from .mcp.json. See https://code.claude.com/docs/en/mcp",
       "examples": [["filesystem"]]
     },
     "allowedMcpServers": {
@@ -288,7 +288,7 @@
         "required": ["serverName"],
         "additionalProperties": false
       },
-      "description": "Enterprise allowlist of MCP servers that can be used. Applies to all scopes including enterprise servers from managed-mcp.json. If undefined, all servers are allowed. If empty array, no servers are allowed. Denylist takes precedence - if a server is on both lists, it is denied."
+      "description": "Enterprise allowlist of MCP servers that can be used. Applies to all scopes including enterprise servers from managed-mcp.json. If undefined, all servers are allowed. If empty array, no servers are allowed. Denylist takes precedence - if a server is on both lists, it is denied. See https://code.claude.com/docs/en/mcp#managed-mcp-configuration"
     },
     "deniedMcpServers": {
       "type": "array",
@@ -304,7 +304,7 @@
         "required": ["serverName"],
         "additionalProperties": false
       },
-      "description": "Enterprise denylist of MCP servers that are explicitly blocked. If a server is on the denylist, it will be blocked across all scopes including enterprise. Denylist takes precedence over allowlist - if a server is on both lists, it is denied."
+      "description": "Enterprise denylist of MCP servers that are explicitly blocked. If a server is on the denylist, it will be blocked across all scopes including enterprise. Denylist takes precedence over allowlist - if a server is on both lists, it is denied. See https://code.claude.com/docs/en/mcp#managed-mcp-configuration"
     },
     "hooks": {
       "type": "object",
@@ -343,14 +343,14 @@
         },
         "PostToolUseFailure": {
           "type": "array",
-          "description": "UNDOCUMENTED. Hooks that run after a tool fails",
+          "description": "Hooks that run after a tool fails",
           "items": {
             "$ref": "#/$defs/hookMatcher"
           }
         },
         "PermissionRequest": {
           "type": "array",
-          "description": "UNDOCUMENTED. Hooks that run when a permission is requested",
+          "description": "Hooks that run when a permission dialog appears",
           "items": {
             "$ref": "#/$defs/hookMatcher"
           }
@@ -376,6 +376,13 @@
             "$ref": "#/$defs/hookMatcher"
           }
         },
+        "SubagentStart": {
+          "type": "array",
+          "description": "Hooks that run when a subagent is spawned",
+          "items": {
+            "$ref": "#/$defs/hookMatcher"
+          }
+        },
         "SubagentStop": {
           "type": "array",
           "description": "Hooks that run when subagents finish responding",
@@ -390,6 +397,13 @@
             "$ref": "#/$defs/hookMatcher"
           }
         },
+        "Setup": {
+          "type": "array",
+          "description": "Hooks that run during repository initialization (--init, --init-only) or maintenance (--maintenance)",
+          "items": {
+            "$ref": "#/$defs/hookMatcher"
+          }
+        },
         "SessionStart": {
           "type": "array",
           "description": "Hooks that run when a new session starts",
@@ -910,7 +924,7 @@
         },
         "additionalProperties": false
       },
-      "description": "Per-plugin configuration including MCP server user configs, keyed by plugin ID (plugin@marketplace format)"
+      "description": "Per-plugin configuration including MCP server user configs, keyed by plugin ID (plugin@marketplace format). See https://code.claude.com/docs/en/plugins"
     }
   },
   "title": "Claude Code Settings"