207 lines
4.5 KiB
Markdown
207 lines
4.5 KiB
Markdown
# 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% |
|