fix: address PR review feedback

- Fix YAML indentation in github-actions.md nested example
- Correct Bash permission pattern from git:* to git * (space, not colon)
- Add explanation for why .local.md is lowest priority in memory hierarchy
- Deduplicate agent hook type content with cross-reference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: sjnims

plugins/plugin-dev/skills/plugin-settings/references/memory-rules-system.md

@@ -22,6 +22,8 @@ Memory files are loaded in priority order (highest first):
 
 Higher-priority instructions take precedence when there are conflicts.
 
+**Why local is lowest priority:** Unlike typical configuration systems where ".local" means "override", Claude Code's `.local.md` files are for personal, project-specific notes and preferences that shouldn't override team standards. The hierarchy ensures organizational policy (managed) > team standards (project) > personal preferences (user/local).
+
 ### Import Syntax
 
 CLAUDE.md files can import other files:

plugins/plugin-dev/skills/plugin-structure/references/advanced-topics.md

@@ -113,33 +113,9 @@ If your plugin's MCP server exposes resources, document the available resource U
 
 The `agent` hook type (covered briefly in the hook-development SKILL.md) spawns a full subagent for complex verification workflows.
 
-### Configuration
+For comprehensive coverage including configuration, behavior, supported events, when to use agent hooks, and detailed examples, see the hook-development skill's `references/advanced.md` file.
 
-```json
-{
-  "type": "agent",
-  "prompt": "Verify all code changes have tests and pass linting",
-  "timeout": 120
-}
-```
-
-### Behavior
-
-- Spawns a subagent with full tool access
-- The subagent can Read files, run Bash commands, use Grep, etc.
-- Returns a decision (approve/block) with reasoning
-- Significantly slower than command or prompt hooks (30-120 seconds)
-
-### Supported Events
-
-Only `Stop` and `SubagentStop` — agent hooks are too slow for PreToolUse or PostToolUse.
-
-### When to Use
-
-- Verification requires reading multiple files
-- Need to run commands and analyze output
-- Single-prompt evaluation is insufficient
-- Comprehensive completion criteria
+**Quick summary:** Agent hooks spawn a subagent with full tool access (Read, Bash, Grep, etc.) for multi-step verification. They're significantly slower (30-120 seconds) but more capable than command or prompt hooks. Only supported on `Stop` and `SubagentStop` events.
 
 ## Auto-Update Behavior
 

plugins/plugin-dev/skills/plugin-structure/references/headless-ci-mode.md

@@ -45,18 +45,18 @@ If the skill has `user-invocable: false` and is loaded via plugin, Claude can st
 Auto-approve specific tools without interactive prompts:
 
 ```bash
-claude -p "Fix the bug" --allowedTools "Read,Write,Edit,Bash(git:*)"
+claude -p "Fix the bug" --allowedTools "Read,Write,Edit,Bash(git *)"
 ```
 
 **Permission rule syntax:**
 
-| Pattern                | Matches                                                    |
-| ---------------------- | ---------------------------------------------------------- |
-| `Read`                 | All Read tool calls                                        |
-| `Bash(git:*)`          | Bash commands starting with "git" (note: space before `*`) |
-| `mcp__*`               | All MCP tool calls                                         |
-| `mcp__plugin_myplug_*` | Tools from a specific plugin's MCP server                  |
-| `Write,Edit`           | Multiple tools (comma-separated)                           |
+| Pattern                | Matches                                                      |
+| ---------------------- | ------------------------------------------------------------ |
+| `Read`                 | All Read tool calls                                          |
+| `Bash(git *)`          | Bash commands starting with "git " (prefix match with space) |
+| `mcp__*`               | All MCP tool calls                                           |
+| `mcp__plugin_myplug_*` | Tools from a specific plugin's MCP server                    |
+| `Write,Edit`           | Multiple tools (comma-separated)                             |
 
 **Plugin design tip:** Document recommended `--allowedTools` values in your plugin README for CI usage.