Plugin Settings

This documents the `.claude/plugin-name.local.md` pattern for storing per-project plugin configuration using YAML frontmatter plus markdown. You'd use this when building plugins that need user-configurable behavior, like toggleable hooks, validation levels, or agent coordination state. The pattern keeps settings out of git while making them readable from bash hooks, commands, and agents. Includes practical parsing snippets for extracting frontmatter fields in bash scripts. The trade-off is that changing these files requires restarting Claude Code for hooks to pick them up, which makes sense given how the plugin system loads but can feel clunky during active development.