[DOCS] Plugin documentation missing `settings.json` default-configuration component

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/plugins-reference

Section/Topic

Plugin component model and plugin directory structure guidance.

Current Documentation

The reference currently defines plugin components as:

Plugin components include skills, agents, hooks, MCP servers, and LSP servers.

The plugin structure guide similarly lists component directories/files but no plugin-shipped settings.json defaults.

What's Wrong or Missing?

Claude Code v2.1.49 adds support for plugins shipping settings.json for default configuration.

Current plugin docs do not explain:

• where plugin settings.json should live,
• how defaults merge with user/project/local settings,
• precedence and override behavior.

Suggested Improvement

Add a new plugin settings component section to plugin docs that covers:

1. file location and schema,
2. merge/precedence rules,
3. example plugin with defaults,
4. security/managed-settings considerations.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/plugins-reference | 15 | Component list omits settings defaults component |
| https://code.claude.com/docs/en/plugins | 177-191 | Plugin structure table omits plugin-shipped settings.json |

Total scope: 2 pages affected