<!-- AUTO-GENERATED by scripts/gen-adapters.js - DO NOT EDIT -->
---
description: Analyze plugins, agents, prompts, docs, hooks, and skills for best-practice gaps
agent: general
---

> **OpenCode Note**: Invoke agents using `@agent-name` syntax.
> Available agents: task-discoverer, exploration-agent, planning-agent,
> implementation-agent, deslop-agent, delivery-validator, sync-docs-agent, consult-agent
> Example: `@exploration-agent analyze the codebase`


# /enhance - Master Enhancement Orchestrator

Run all enhancement analyzers in parallel and generate a unified report.

## Overview

The master `/enhance` command orchestrates 7 specialized enhancers:
- **plugin** - Plugin structures, MCP tools, security patterns
- **agent** - Agent prompts, frontmatter, tool restrictions
- **claudemd** - CLAUDE.md/AGENTS.md project memory files
- **docs** - Documentation structure and RAG optimization
- **prompt** - General prompt quality and clarity
- **hooks** - Hook definitions and frontmatter quality
- **skills** - SKILL.md structure and trigger clarity

## Arguments

Parse from $ARGUMENTS:
- **target-path**: Directory or file to analyze (default: current directory)
- **--apply**: Apply auto-fixes for HIGH certainty issues after report
- **--focus=TYPE**: Run only specified enhancer(s): plugin, agent, claudemd/claude-memory, docs, prompt, hooks, skills
- **--verbose**: Include LOW certainty issues in report
- **--show-suppressed**: Show what's being filtered by auto-learned suppressions
- **--no-learn**: Disable auto-learning for this run (analyze but don't save)
- **--reset-learned**: Clear all auto-learned suppressions for this project
- **--export-learned**: Export learned suppressions as JSON for team sharing

## Workflow

1. **Discovery** - Detect what content types exist in target path
2. **Load Suppressions** - Load auto-learned and manual suppressions for project
3. **Launch** - Start all relevant enhancers in parallel via Task()
4. **Aggregate** - Collect and deduplicate findings from all enhancers
5. **Report** - Generate unified report from aggregated findings
6. **Auto-Learn** - Detect false positives and save for future runs (unless --no-learn)
7. **Fix** - Apply auto-fixes if --apply flag is present

## Implementation

Execute the `enhance-orchestrator` skill directly. The skill workflow:

1. Parse arguments from $ARGUMENTS
2. Run discovery to find content types
3. Spawn enhancer agents in parallel via Task() for each content type
4. Aggregate results from all enhancers
5. Generate unified report

See `skills/enhance-orchestrator/SKILL.md` for detailed implementation.

## Output Format

```markdown
# Enhancement Analysis Report

**Target**: {targetPath}
**Date**: {timestamp}
**Enhancers Run**: plugin, agent, docs

## Executive Summary

| Enhancer | HIGH | MEDIUM | LOW | Auto-Fixable |
|----------|------|--------|-----|--------------|
| plugin | 2 | 3 | 1 | 1 |
| agent | 1 | 2 | 0 | 1 |
| docs | 0 | 4 | 2 | 0 |
| **Total** | **3** | **9** | **3** | **2** |

## HIGH Certainty Issues (3)

[Grouped by enhancer, sorted by file]

## MEDIUM Certainty Issues (9)

[...]

## Auto-Fix Summary

2 issues can be automatically fixed with `--apply` flag.
```

## Example Usage

```bash
# Full analysis of current directory
/enhance

# Focus on specific enhancer type
/enhance --focus=agent

# Apply auto-fixes for HIGH certainty issues
/enhance --apply

# Analyze specific path with verbose output
/enhance plugins/next-task --verbose

# Combined flags
/enhance --focus=plugin --apply --verbose

# Auto-Learning Suppression System
# See what's being filtered by auto-learned suppressions
/enhance --show-suppressed

# Run without auto-learning (analyze only, don't save new suppressions)
/enhance --no-learn

# Reset all learned suppressions for this project
/enhance --reset-learned

# Export learned suppressions for team sharing
/enhance --export-learned > suppressions-export.json
```

## Success Criteria

- All relevant enhancers run in parallel
- Findings deduplicated and sorted by certainty
- Clear executive summary with counts
- Auto-fixable issues highlighted
- Fixes applied only with explicit --apply flag
- Auto-learning detects false positives with 90%+ confidence
- Learned suppressions stored in cross-platform location (${STATE_DIR}/enhance/suppressions.json)
- Zero token waste on previously suppressed findings

---

# /plugin

Spawns `plugin-enhancer` agent which invokes `enhance-plugins` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /agent

Spawns `agent-enhancer` agent which invokes `enhance-agent-prompts` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /docs

Spawns `docs-enhancer` agent which invokes `enhance-docs` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /claudemd

Spawns `claudemd-enhancer` agent which invokes `enhance-claude-memory` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /prompt

Spawns `prompt-enhancer` agent which invokes `enhance-prompts` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /hooks

Spawns `hooks-enhancer` agent which invokes `enhance-hooks` skill.
See skill for patterns, detection logic, and auto-fix implementations.

---

# /skills

Spawns `skills-enhancer` agent which invokes `enhance-skills` skill.
See skill for patterns, detection logic, and auto-fix implementations.