ktg-plugin-marketplace/plugins/config-audit/knowledge/gap-closure-templates.md

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:

---
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

{
  "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:

{
  "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/:

---
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:

---
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/:

---
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:

---
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:

{
  "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%