1---
 2enabled: true
 3setting1: value1
 4setting2: value2
 5numeric_setting: 42
 6list_setting: ["item1", "item2"]
 7---
 8
 9# Additional Context
10
11This markdown body can contain:
12- Task descriptions
13- Additional instructions
14- Prompts to feed back to Claude
15- Documentation or notes

 1---
 2enabled: true
 3strict_mode: false
 4max_retries: 3
 5notification_level: info
 6coordinator_session: team-leader
 7---
 8
 9# Plugin Configuration
10
11This plugin is configured for standard validation mode.
12Contact @team-lead with questions.

 1#!/bin/bash
 2set -euo pipefail
 3
 4# Define state file path
 5STATE_FILE=".claude/my-plugin.local.md"
 6
 7# Quick exit if file doesn't exist
 8if [[ ! -f "$STATE_FILE" ]]; then
 9  exit 0  # Plugin not configured, skip
10fi
11
12# Parse YAML frontmatter (between --- markers)
13FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$STATE_FILE")
14
15# Extract individual fields
16ENABLED=$(echo "$FRONTMATTER" | grep '^enabled:' | sed 's/enabled: *//' | sed 's/^"\(.*\)"$/\1/')
17STRICT_MODE=$(echo "$FRONTMATTER" | grep '^strict_mode:' | sed 's/strict_mode: *//' | sed 's/^"\(.*\)"$/\1/')
18
19# Check if enabled
20if [[ "$ENABLED" != "true" ]]; then
21  exit 0  # Disabled
22fi
23
24# Use configuration in hook logic
25if [[ "$STRICT_MODE" == "true" ]]; then
26  # Apply strict validation
27  # ...
28fi

 1---
 2description: Process data with plugin
 3allowed-tools: ["Read", "Bash"]
 4---
 5
 6# Process Command
 7
 8Steps:
 91. Check if settings exist at `.claude/my-plugin.local.md`
102. Read configuration using Read tool
113. Parse YAML frontmatter to extract settings
124. Apply settings to processing logic
135. Execute with configured behavior

 1---
 2name: configured-agent
 3description: Agent that adapts to project settings
 4---
 5
 6Check for plugin settings at `.claude/my-plugin.local.md`.
 7If present, parse YAML frontmatter and adapt behavior according to:
 8- enabled: Whether plugin is active
 9- mode: Processing mode (strict, standard, lenient)
10- Additional configuration fields

1# Extract everything between --- markers
2FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$FILE")

1VALUE=$(echo "$FRONTMATTER" | grep '^field_name:' | sed 's/field_name: *//' | sed 's/^"\(.*\)"$/\1/')

1ENABLED=$(echo "$FRONTMATTER" | grep '^enabled:' | sed 's/enabled: *//')
2# Compare: if [[ "$ENABLED" == "true" ]]; then

1MAX=$(echo "$FRONTMATTER" | grep '^max_value:' | sed 's/max_value: *//')
2# Use: if [[ $MAX -gt 100 ]]; then

1# Get everything after closing ---
2BODY=$(awk '/^---$/{i++; next} i>=2' "$FILE")

 1#!/bin/bash
 2STATE_FILE=".claude/security-scan.local.md"
 3
 4# Quick exit if not configured
 5if [[ ! -f "$STATE_FILE" ]]; then
 6  exit 0
 7fi
 8
 9# Read enabled flag
10FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$STATE_FILE")
11ENABLED=$(echo "$FRONTMATTER" | grep '^enabled:' | sed 's/enabled: *//')
12
13if [[ "$ENABLED" != "true" ]]; then
14  exit 0  # Disabled
15fi
16
17# Run hook logic
18# ...

 1---
 2agent_name: auth-agent
 3task_number: 3.5
 4pr_number: 1234
 5coordinator_session: team-leader
 6enabled: true
 7dependencies: ["Task 3.4"]
 8---
 9
10# Task Assignment
11
12Implement JWT authentication for the API.
13
14**Success Criteria:**
15- Authentication endpoints created
16- Tests passing
17- PR created and CI green

1AGENT_NAME=$(echo "$FRONTMATTER" | grep '^agent_name:' | sed 's/agent_name: *//')
2COORDINATOR=$(echo "$FRONTMATTER" | grep '^coordinator_session:' | sed 's/coordinator_session: *//')
3
4# Send notification to coordinator
5tmux send-keys -t "$COORDINATOR" "Agent $AGENT_NAME completed task" Enter

 1---
 2validation_level: strict
 3max_file_size: 1000000
 4allowed_extensions: [".js", ".ts", ".tsx"]
 5enable_logging: true
 6---
 7
 8# Validation Configuration
 9
10Strict mode enabled for this project.
11All writes validated against security policies.

 1LEVEL=$(echo "$FRONTMATTER" | grep '^validation_level:' | sed 's/validation_level: *//')
 2
 3case "$LEVEL" in
 4  strict)
 5    # Apply strict validation
 6    ;;
 7  standard)
 8    # Apply standard validation
 9    ;;
10  lenient)
11    # Apply lenient validation
12    ;;
13esac

1# Setup Command
2
3Steps:
41. Ask user for configuration preferences
52. Create `.claude/my-plugin.local.md` with YAML frontmatter
63. Set appropriate values based on user input
74. Inform user that settings are saved
85. Remind user to restart Claude Code for hooks to recognize changes

 1## Configuration
 2
 3Create `.claude/my-plugin.local.md` in your project:
 4
 5\`\`\`markdown
 6---
 7enabled: true
 8mode: standard
 9max_retries: 3
10---
11
12# Plugin Configuration
13
14Your settings are active.
15\`\`\`
16
17After creating or editing, restart Claude Code for changes to take effect.

1if [[ ! -f "$STATE_FILE" ]]; then
2  # Use defaults
3  ENABLED=true
4  MODE=standard
5else
6  # Read from file
7  # ...
8fi

1MAX=$(echo "$FRONTMATTER" | grep '^max_value:' | sed 's/max_value: *//')
2
3# Validate numeric range
4if ! [[ "$MAX" =~ ^[0-9]+$ ]] || [[ $MAX -lt 1 ]] || [[ $MAX -gt 100 ]]; then
5  echo "⚠️  Invalid max_value in settings (must be 1-100)" >&2
6  MAX=10  # Use default
7fi

1## Changing Settings
2
3After editing `.claude/my-plugin.local.md`:
41. Save the file
52. Exit Claude Code
63. Restart: `claude` or `cc`
74. New settings will be loaded

1# Escape quotes in user input
2SAFE_VALUE=$(echo "$USER_INPUT" | sed 's/"/\\"/g')
3
4# Write to file
5cat > "$STATE_FILE" <<EOF
6---
7user_setting: "$SAFE_VALUE"
8---
9EOF

1FILE_PATH=$(echo "$FRONTMATTER" | grep '^data_file:' | sed 's/data_file: *//')
2
3# Check for path traversal
4if [[ "$FILE_PATH" == *".."* ]]; then
5  echo "⚠️  Invalid path in settings (path traversal)" >&2
6  exit 2
7fi

 1---
 2agent_name: auth-implementation
 3task_number: 3.5
 4pr_number: 1234
 5coordinator_session: team-leader
 6enabled: true
 7dependencies: ["Task 3.4"]
 8additional_instructions: Use JWT tokens, not sessions
 9---
10
11# Task: Implement Authentication
12
13Build JWT-based authentication for the REST API.
14Coordinate with auth-agent on shared types.

1---
2iteration: 1
3max_iterations: 10
4completion_promise: "All tests passing and build successful"
5---
6
7Fix all the linting errors in the project.
8Make sure tests pass after each fix.

1# Extract frontmatter
2FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$FILE")
3
4# Read field
5VALUE=$(echo "$FRONTMATTER" | grep '^field:' | sed 's/field: *//' | sed 's/^"\(.*\)"$/\1/')

1# Extract body (after second ---)
2BODY=$(awk '/^---$/{i++; next} i>=2' "$FILE")

1if [[ ! -f ".claude/my-plugin.local.md" ]]; then
2  exit 0  # Not configured
3fi