feat: initial open marketplace with llm-security, config-audit, ultraplan-local

plugins/config-audit/knowledge/gap-closure-templates.md

@@ -0,0 +1,207 @@
+# Gap Closure Templates
+
+Config-specific templates for closing feature gaps. Each template targets specific gap IDs, with effort estimate and expected utilization gain.
+
+## CLAUDE.md Optimization
+
+### Modular CLAUDE.md with @imports
+**Closes:** t2_2 (CLAUDE.md not modular)
+**Effort:** Low (15 min)
+**Gain:** +5% utilization
+
+Split large CLAUDE.md into focused modules:
+1. Create `.claude/rules/` directory
+2. Move topic-specific sections to individual `.md` files
+3. Use `@.claude/rules/topic.md` imports in CLAUDE.md
+
+### Path-Scoped Rules
+**Closes:** t2_3 (No path-scoped rules)
+**Effort:** Low (10 min)
+**Gain:** +5% utilization
+
+Add context-specific rules that only apply to matching files:
+```yaml
+---
+paths: src/**/*.ts
+---
+# TypeScript Rules
+Use strict TypeScript. No `any` types.
+```
+
+## Hook Automation
+
+### Multi-Event Hook Setup
+**Closes:** t1_3 (No hooks), t2_5 (Low hook diversity)
+**Effort:** Medium (30 min)
+**Gain:** +12% utilization
+
+Configure hooks across 3+ events:
+1. `PreToolUse` — security checks on Bash/Write
+2. `Stop` — session summaries, state reminders
+3. `SessionStart` — load context, check state
+
+### Hooks in settings.json
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [{"type": "command", "command": "echo ok", "timeout": 5000}]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [{"type": "prompt", "prompt": "Summarize session progress."}]
+      }
+    ]
+  }
+}
+```
+
+## MCP Integration
+
+### Basic MCP Setup
+**Closes:** t1_5 (No MCP), t4_1 (No project .mcp.json in git)
+**Effort:** Low (15 min)
+**Gain:** +10% utilization
+
+Create `.mcp.json` at project root:
+```json
+{
+  "mcpServers": {
+    "memory": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-memory"],
+      "trust": "workspace"
+    }
+  }
+}
+```
+Commit to git for team sharing.
+
+## Skill & Command Development
+
+### Custom Skills
+**Closes:** t1_4 (No custom skills/commands)
+**Effort:** Medium (30 min)
+**Gain:** +7% utilization
+
+Create project-specific skills in `.claude/commands/`:
+```markdown
+---
+name: project:build
+description: Build and test the project
+allowed-tools: Bash, Read
+model: sonnet
+---
+Run: `npm run build && npm test`
+Report results.
+```
+
+### Advanced Skill Frontmatter
+**Closes:** t3_5 (No advanced skill frontmatter), t3_7 (No dynamic skill context)
+**Effort:** Low (15 min)
+**Gain:** +5% utilization
+
+Add dynamic context and fork mode:
+```yaml
+---
+name: project:deploy
+context: fork
+argument-hint: "[environment]"
+---
+Current branch: !`git branch --show-current`
+```
+
+## Agent Architecture
+
+### Custom Subagents
+**Closes:** t2_6 (No custom subagents)
+**Effort:** Medium (45 min)
+**Gain:** +5% utilization
+
+Create specialized agents in `.claude/agents/`:
+```yaml
+---
+name: reviewer
+description: |
+  Code review agent for pull requests.
+model: sonnet
+color: blue
+tools: ["Read", "Glob", "Grep"]
+---
+```
+
+### Subagent Isolation
+**Closes:** t3_6 (No subagent isolation)
+**Effort:** Low (5 min)
+**Gain:** +2% utilization
+
+Add `isolation: worktree` to agents that modify files:
+```yaml
+---
+isolation: worktree
+---
+```
+
+## Plugin Architecture
+
+### Custom Plugin
+**Closes:** t4_2 (No custom plugin)
+**Effort:** High (2-4 hours)
+**Gain:** +2% utilization
+
+Package reusable skills, agents, and hooks:
+```
+.claude-plugin/
+├── plugin.json
+├── commands/
+├── agents/
+└── hooks/
+    └── hooks.json
+```
+
+## Settings Optimization
+
+### Multi-Scope Settings
+**Closes:** t2_1 (Settings only at one scope)
+**Effort:** Low (10 min)
+**Gain:** +5% utilization
+
+Use all 3 settings scopes:
+- `~/.claude/settings.json` — global defaults
+- `.claude/settings.json` — project (committed)
+- `.claude/settings.local.json` — personal overrides (gitignored)
+
+### Model Configuration
+**Closes:** t2_7 (No model configuration)
+**Effort:** Low (5 min)
+**Gain:** +5% utilization
+
+Set model preferences in settings:
+```json
+{
+  "model": "sonnet",
+  "modelOverrides": {
+    "planMode": "opus"
+  }
+}
+```
+
+## Impact Summary
+
+| Template | Gaps Closed | Effort | Gain |
+|----------|-------------|--------|------|
+| Modular CLAUDE.md | t2_2 | Low | +5% |
+| Path-Scoped Rules | t2_3 | Low | +5% |
+| Multi-Event Hooks | t1_3, t2_5 | Medium | +12% |
+| MCP Setup | t1_5, t4_1 | Low | +10% |
+| Custom Skills | t1_4 | Medium | +7% |
+| Advanced Frontmatter | t3_5, t3_7 | Low | +5% |
+| Custom Subagents | t2_6 | Medium | +5% |
+| Subagent Isolation | t3_6 | Low | +2% |
+| Custom Plugin | t4_2 | High | +2% |
+| Multi-Scope Settings | t2_1 | Low | +5% |
+| Model Configuration | t2_7 | Low | +5% |