Do I need to restart Claude Code after updating settings?

Yes. Because Claude Code hooks and configurations are loaded at the start of a session, a restart is required for changes to take effect.

Can I store long-form text in these settings files?

Yes, the pattern supports a Markdown body after the YAML frontmatter, which is ideal for storing task instructions, prompts, or documentation.

Where are plugin settings stored in Claude Code?

Settings are stored in the project root under the .claude/ directory, typically using the naming convention plugin-name.local.md.

Why use the .local.md extension for configurations?

The .local.md extension ensures settings are project-specific and can be easily targeted by .gitignore to prevent committing local or sensitive data to version control.

How do I parse YAML frontmatter in a Bash hook?

The skill provides specific sed and grep patterns to extract values between the triple-dash markers directly from the settings file.

Plugin Settings Pattern

Name: Plugin Settings Pattern
Author: micsapp

bymicsapp

0•

開発者ツール

Standardizes user-configurable plugin settings and state management using YAML frontmatter within local Markdown files.

The Plugin Settings Pattern provides a robust framework for Claude Code plugins to store per-project configurations without committing them to version control. By utilizing the .claude/*.local.md file structure, developers can implement structured YAML frontmatter for data and use the Markdown body for additional prompts or context. This skill streamlines the creation of configurable hooks, commands, and agents, offering reusable Bash patterns for parsing settings and managing plugin lifecycles effectively.

主な機能

01Standardized .claude/*.local.md file architecture

020 GitHub stars

03Secure per-project state management outside of Git

04Support for dynamic hook activation and agent coordination

05YAML frontmatter for structured configuration data

06Reusable Bash patterns for parsing settings and Markdown body

ユースケース

01Managing persistent state for multi-agent workflows

02Creating per-project configuration for Claude Code hooks

03Enabling or disabling plugin features without modifying source code

主な機能

01Standardized .claude/*.local.md file architecture

020 GitHub stars

03Secure per-project state management outside of Git

04Support for dynamic hook activation and agent coordination

05YAML frontmatter for structured configuration data

06Reusable Bash patterns for parsing settings and Markdown body

ユースケース

01Managing persistent state for multi-agent workflows

02Creating per-project configuration for Claude Code hooks

03Enabling or disabling plugin features without modifying source code