awesome-slash 2.7.1 → 2.8.1

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-slash",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support (OpenCode, Codex CLI)",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -13,35 +13,35 @@
       "name": "next-task",
       "source": "./plugins/next-task",
       "description": "Master workflow orchestrator: autonomous workflow with model optimization (opus/sonnet/haiku), two-file state management, workflow enforcement gates, 14 specialist agents",
-      "version": "2.7.1",
+      "version": "2.8.1",
       "category": "productivity"
     },
     {
       "name": "ship",
       "source": "./plugins/ship",
       "description": "Complete PR workflow: commit to production, skips review when called from next-task, removes task from registry on cleanup, automatic rollback",
-      "version": "2.7.1",
+      "version": "2.8.1",
       "category": "deployment"
     },
     {
       "name": "deslop-around",
       "source": "./plugins/deslop-around",
       "description": "3-phase AI slop detection: regex patterns (HIGH), multi-pass analyzers (MEDIUM), CLI tools (LOW)",
-      "version": "2.7.1",
+      "version": "2.8.1",
       "category": "development"
     },
     {
       "name": "project-review",
       "source": "./plugins/project-review",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "2.7.1",
+      "version": "2.8.1",
       "category": "development"
     },
     {
       "name": "reality-check",
       "source": "./plugins/reality-check",
       "description": "Deep repository analysis to realign project plans with code reality - detects drift, gaps, and creates prioritized reconstruction plans",
-      "version": "2.7.1",
+      "version": "2.8.1",
       "category": "productivity"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-slash",
-  "version": "2.7.1",
+  "version": "2.8.1",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "author": {
     "name": "Avi Fenesh",

package/CHANGELOG.md

@@ -5,6 +5,106 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+## [2.8.1] - 2025-01-23
+
+### Fixed
+- **CLI Installer** - Added missing `enhance` plugin to Claude Code installation
+
+## [2.8.0] - 2025-01-23
+
+### Added
+- **Master /enhance Orchestrator** - New `/enhance` command runs all enhancers in parallel (#118)
+  - Orchestrates 5 enhancers: plugin, agent, claudemd, docs, prompt
+  - Parallel execution via Task() for efficiency
+  - Unified report with executive summary table
+  - Deduplication of overlapping findings
+  - Sorted by certainty (HIGH > MEDIUM > LOW)
+  - Auto-fix coordination with `--apply` flag
+  - Focus filtering with `--focus=TYPE` flag
+  - New agents: `enhancement-orchestrator.md` (opus), `enhancement-reporter.md` (sonnet)
+  - New lib functions: `generateOrchestratorReport()`, `deduplicateOrchestratorFindings()`
+
+### Improved
+- **Enhancer Agent XML Compatibility** - Added cross-model XML structure to all 4 enhancer agents
+  - `agent-enhancer.md`: Added `<constraints>`, `<examples>` sections (unrestricted Bash, missing role examples)
+  - `docs-enhancer.md`: Added `<constraints>`, `<examples>` sections (verbose phrases, RAG chunking examples)
+  - `plugin-enhancer.md`: Added `<constraints>`, `<examples>`, quality multiplier section
+  - `claudemd-enhancer.md`: Added `<examples>` section (WHY explanations, cross-platform paths examples)
+  - All agents now properly structured for cross-model compatibility (Claude, GPT, Gemini)
+
+### Added
+- **Cross-Platform Validation** - Internal tooling for Claude Code, OpenCode, Codex compatibility
+  - New `npm run validate:cross-platform` script scans all plugins for platform-specific code
+  - 4 new cross-platform patterns in agent-analyzer: hardcoded state dirs, plugin root paths, instruction file references
+  - Agents now use `${STATE_DIR}/` placeholder instead of hardcoded `.claude/` paths
+  - `scripts/validate-cross-platform.js` for CI integration
+
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (3 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (45 tests)
+  - Uses opus model for quality multiplier effect
+
+
+- **Project Memory Optimizer** - New `/enhance:claudemd` command (#121)
+  - Analyzes CLAUDE.md/AGENTS.md project memory files for optimization opportunities
+  - 14 detection patterns across 5 categories: structure, reference, efficiency, quality, cross-platform
+  - Validates file and command references against filesystem
+  - Measures token efficiency and detects README duplication
+  - Checks for critical rules, architecture overview, key commands sections
+  - Detects hardcoded state directories and Claude-only terminology
+  - Validates WHY explanations for rules
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - No auto-fix (requires human judgment for documentation)
+  - New lib/enhance/projectmemory-analyzer.js and projectmemory-patterns.js
+  - Comprehensive test suite (30+ tests)
+  - Extended reporter.js with generateProjectMemoryReport()
+  - Searches for CLAUDE.md, AGENTS.md, .github/CLAUDE.md, .github/AGENTS.md
+- **Plugin Structure Analyzer** - New `/enhance:plugin` command (#119)
+  - Analyzes plugin.json structure and required fields
+  - Validates MCP tool definitions against best practices
+  - Detects security patterns in agent/command files
+  - HIGH/MEDIUM/LOW certainty levels following slop-patterns model
+  - Auto-fix capability for HIGH certainty issues
+  - New lib/enhance/ module with pattern matching, reporter, fixer
+  - Comprehensive test suite (21 tests)
+
+- **Documentation Enhancement Analyzer** - New `/enhance:docs` command (#123)
+  - Analyzes documentation for readability and RAG optimization
+  - Two modes: `--ai` (AI-only, aggressive optimization) and `--both` (default, balanced)
+  - 14 documentation optimization patterns: links, structure, efficiency, RAG
+  - Categories: link validation, structure, token efficiency, RAG optimization, balance suggestions
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for 2 HIGH certainty issues (inconsistent headings, verbose explanations)
+  - New lib/enhance/docs-analyzer.js and docs-patterns.js modules
+  - New plugins/enhance/agents/docs-enhancer.md agent (opus model)
+  - Comprehensive test suite
+
+- **General Prompt Analyzer** - New `/enhance:prompt` command (#122)
+  - Analyzes general prompts for prompt engineering best practices
+  - Differentiates from `/enhance:agent` (prompt quality vs agent config)
+  - 16 detection patterns across 6 categories: clarity, structure, examples, context, output, anti-patterns
+  - Clarity patterns: vague instructions, negative-only constraints, aggressive emphasis
+  - Structure patterns: missing XML structure, inconsistent sections, critical info buried
+  - Example patterns: missing examples, suboptimal count, lack of good/bad contrast
+  - Context patterns: missing WHY explanations, missing instruction priority
+  - Output patterns: missing format specification, JSON without schema
+  - Anti-patterns: redundant CoT, overly prescriptive, prompt bloat
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for 1 HIGH certainty issue (aggressive emphasis)
+  - New lib/enhance/prompt-analyzer.js and prompt-patterns.js modules
+  - New plugins/enhance/agents/prompt-enhancer.md agent (opus model)
+  - Comprehensive test suite (30+ tests)
+  - Extended reporter.js with generatePromptReport() and generatePromptSummaryReport()
 ## [2.7.1] - 2026-01-22
 
 ### Security
@@ -155,6 +255,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **CLI Installer** - `npm install -g awesome-slash@latest && awesome-slash`
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - Multi-select: choose one or more platforms (Claude Code, OpenCode, Codex)
   - Uses npm package files directly (no git clone)
   - Claude Code: Uses GitHub marketplace for plugin installation
@@ -200,6 +312,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Platform-Aware State Directories** - State files now stored in platform-specific directories
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - Claude Code: `.claude/`
   - OpenCode: `.opencode/`
   - Codex CLI: `.codex/`
@@ -221,6 +345,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Multi-Source Task Discovery** - Support for GitHub, GitLab, local files, custom CLI tools
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - **Source Preference Caching** - Last-used source cached in `sources/preference.json`
 - **Large Backlog Handling** - Pagination and priority filtering for repos with many issues
 
@@ -319,6 +455,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **PR Auto-Review Process** - Added mandatory workflow for 4 auto-reviewers (Copilot, Claude, Gemini, Codex)
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - **Agent Responsibilities** - Documented required tools and MUST-CALL agents for /next-task and /ship
 - **CLAUDE.md Enhancement** - Comprehensive agent workflow documentation with tool restrictions
 
@@ -330,6 +478,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **CLAUDE.md** - Project guidelines with release process and PR auto-review workflow
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - **npm installation option** - Added npm as primary installation method to INSTALLATION.md
 
 ### Fixed
@@ -357,6 +517,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Published to npm as `awesome-slash` for easier installation
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - Added `.npmignore` and `files` field for optimized package size (191KB → 143KB)
 
 ### Changed
@@ -367,6 +539,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Reality Check Plugin**: Deep repository analysis to detect plan drift and gaps
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - Multi-agent parallel scanning architecture (issue-scanner, doc-analyzer, code-explorer, plan-synthesizer)
   - Detects drift: plan stagnation, priority neglect, documentation lag, scope overcommit
   - Identifies gaps: missing tests, outdated docs, overdue milestones
@@ -403,6 +587,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **CI & Review Monitor Loop** for `/ship` command (#79)
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - Continuous monitoring loop waits for CI AND addresses ALL PR feedback
   - Auto-waits 3 minutes on first iteration for review bots (Gemini, CodeRabbit)
   - Configurable via `SHIP_INITIAL_WAIT` environment variable
@@ -445,6 +641,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Two-File State Management** to prevent workflow collisions
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - `tasks.json` in main repo: Shared registry of claimed tasks
   - `workflow-status.json` in worktree: Local step tracking with timestamps
   - Resume by task ID, branch name, or worktree path
@@ -506,6 +714,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Quality Gate Agents** for fully autonomous workflow after plan approval
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - `deslop-work.md` - Clean AI slop from committed but unpushed changes
   - `test-coverage-checker.md` - Validate new work has test coverage
   - `delivery-validator.md` - Autonomous delivery validation (NOT manual approval)
@@ -533,6 +753,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Master Workflow Orchestrator** - Complete task-to-production automation
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - **State Management** - `.claude/workflow-state.json` for workflow persistence
 - **8 Specialist Agents** - Opus for complex tasks, Sonnet for operations
 - **Cross-Platform MCP Server** - Integration with OpenCode and Codex CLI
@@ -546,6 +778,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - **Test Infrastructure**: Jest test suite with 103 unit tests covering all core modules
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
   - `detect-platform.test.js` - Platform detection tests
   - `verify-tools.test.js` - Tool verification tests
   - `slop-patterns.test.js` - Pattern matching and secret detection tests
@@ -588,6 +832,18 @@ Initial release with full feature set.
 
 ### Added
 - `/ship` command for complete PR workflow with deployment
+- **Agent Prompt Optimizer** - New `/enhance:agent` command (#120)
+  - Analyzes agent prompt files for prompt engineering best practices
+  - 14 detection patterns across 6 categories: structure, tools, XML, CoT, examples, anti-patterns
+  - Validates frontmatter (name, description, tools, model)
+  - Checks tool restrictions (unrestricted Bash detection)
+  - Evaluates chain-of-thought appropriateness for task complexity
+  - Detects anti-patterns: vague language, prompt bloat, example count
+  - HIGH/MEDIUM/LOW certainty levels for findings
+  - Auto-fix capability for HIGH certainty issues (4 patterns)
+  - New lib/enhance/agent-analyzer.js and agent-patterns.js
+  - Comprehensive test suite (21 tests)
+  - Uses opus model for quality multiplier effect
 - `/next-task` command for intelligent task prioritization
 - `/deslop-around` command for AI slop cleanup
 - `/project-review` command for multi-agent code review (with Phase 8 GitHub issue creation)

package/README.md

@@ -6,7 +6,7 @@ A cross-platform plugin providing powerful, zero-configuration slash commands fo
 
 [![npm](https://img.shields.io/npm/v/awesome-slash?color=red)](https://www.npmjs.com/package/awesome-slash)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-2.7.0-blue)](https://github.com/avifenesh/awesome-slash/releases)
+[![Version](https://img.shields.io/badge/version-2.8.1-blue)](https://github.com/avifenesh/awesome-slash/releases)
 [![GitHub stars](https://img.shields.io/github/stars/avifenesh/awesome-slash?style=flat&color=yellow)](https://github.com/avifenesh/awesome-slash/stargazers)
 [![Claude Code](https://img.shields.io/badge/Claude-Code%20Plugin-blue)](https://docs.anthropic.com/en/docs/claude-code)
 [![Codex CLI](https://img.shields.io/badge/Codex-CLI%20Compatible-green)](https://developers.openai.com/codex/cli)
@@ -16,6 +16,13 @@ A cross-platform plugin providing powerful, zero-configuration slash commands fo
 
 > **💡 Model Recommendation**: Using **Opus** as the main agent model produces significantly better results and follows workflow phases more tightly. While Sonnet works for simpler tasks, Opus is recommended for complex multi-step workflows.
 
+## What's New in v2.8.0
+
+- **Complete /enhance Suite** - 7 enhancement analyzers for plugins, agents, prompts, docs, and project memory
+- **Master /enhance Orchestrator** - Run all enhancers in parallel with unified reporting and deduplication
+- **Cross-Platform Validation** - New `npm run validate:cross-platform` for Claude Code, OpenCode, Codex compatibility
+- **21 Specialist Agents** - Up from 16, including 7 new enhancement agents
+
 ## What's New in v2.7.0
 
 - **GitHub Issue Progress Comments** - Workflow posts status updates to GitHub issues (start, plan, completion)
@@ -262,6 +269,132 @@ Deep repository analysis to identify where documented plans diverge from actual
 - **Single Opus call** - Deep semantic analysis with full context
 - **~77% token reduction** - Efficient compared to multi-agent approach
 
+
+### `/enhance` - Master Enhancement Orchestrator
+
+Run all enhancement analyzers in parallel and generate a unified report.
+
+```bash
+/enhance                          # Full analysis of current directory
+/enhance --focus=agent            # Run specific enhancer only
+/enhance --apply                  # Apply auto-fixes for HIGH certainty issues
+/enhance plugins/ --verbose       # Analyze with all issues shown
+```
+
+**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
+
+**Output:**
+- Unified report with findings from all enhancers
+- Deduplicated issues sorted by certainty level
+- Auto-fixable issues highlighted
+- Clear executive summary with counts
+
+---
+
+### Focused Enhancers
+
+> **Note:** Individual enhancers can be run via `/enhance --focus=TYPE` or the shorthand `/enhance:TYPE`. Both are equivalent.
+
+#### `/enhance:plugin` - Plugin Structure Analyzer
+
+Analyze plugin structures, MCP tools, and security patterns against best practices.
+
+```bash
+/enhance --focus=plugin           # Via master command (recommended)
+/enhance:plugin                   # Shorthand syntax
+/enhance:plugin next-task         # Analyze specific plugin
+/enhance:plugin --fix             # Apply HIGH certainty auto-fixes
+```
+
+**Checks:**
+- plugin.json structure and version consistency
+- MCP tool definitions
+- Security patterns
+- Tool over-exposure
+
+#### `/enhance:agent` - Agent Prompt Optimizer
+
+Analyze agent prompt files for prompt engineering best practices.
+
+```bash
+/enhance --focus=agent            # Via master command (recommended)
+/enhance:agent                    # Shorthand syntax
+/enhance:agent exploration-agent  # Analyze specific agent
+/enhance:agent --fix              # Apply auto-fixes
+```
+
+**Detects:**
+- Missing frontmatter (name, description, tools, model)
+- Unrestricted tool access
+- Chain-of-thought appropriateness
+- Anti-patterns and prompt bloat
+
+#### `/enhance:docs` - Documentation Optimizer
+
+Analyze documentation for readability and RAG optimization.
+
+```bash
+/enhance --focus=docs             # Via master command (recommended)
+/enhance:docs                     # Shorthand syntax
+/enhance:docs --ai                # AI-only mode (aggressive RAG optimization)
+/enhance:docs docs/ --fix         # Apply fixes to docs directory
+```
+
+**Modes:**
+- `--both` (default) - Balance readability with AI-friendliness
+- `--ai` - Aggressive RAG optimization for agent-docs
+
+**Checks:**
+- Broken links and inconsistent headings
+- RAG chunking (AI mode)
+- Token efficiency (AI mode)
+- Structure and organization
+
+#### `/enhance:claudemd` - Project Memory Optimizer
+
+Analyze CLAUDE.md/AGENTS.md for optimization opportunities.
+
+```bash
+/enhance --focus=claudemd         # Via master command (recommended)
+/enhance:claudemd                 # Shorthand syntax
+/enhance:claudemd /path/to/proj   # Analyze specific project
+/enhance:claudemd --verbose       # Show all issues
+```
+
+**Checks:**
+- Critical rules, architecture, key commands sections
+- File and command reference validation
+- Token efficiency and README duplication
+- Cross-platform compatibility
+- WHY explanations for rules
+
+#### `/enhance:prompt` - Prompt Quality Analyzer
+
+Analyze general prompts for prompt engineering best practices.
+
+```bash
+/enhance --focus=prompt           # Via master command (recommended)
+/enhance:prompt                   # Shorthand syntax
+/enhance:prompt my-prompt.md      # Analyze specific prompt
+/enhance:prompt prompts/ --fix    # Apply fixes to prompts directory
+```
+
+**Differentiation:**
+- Use `/enhance:prompt` for general prompts, system prompts, templates
+- Use `/enhance:agent` for agent files with YAML frontmatter
+
+**Detects:**
+- Vague instructions and negative-only constraints
+- Missing XML structure and examples
+- Context gaps (WHY explanations, priority order)
+- Output format issues
+- Anti-patterns (redundant CoT, prompt bloat)
+
 ---
 
 ## Cross-Platform Integration
@@ -330,7 +463,7 @@ Override with `AI_STATE_DIR` environment variable.
 }
 ```
 
-### Specialist Agents (14 Total)
+### Specialist Agents (21 Total)
 
 **Core Workflow (Opus - Complex Tasks):**
 | Agent | Purpose |
@@ -364,6 +497,18 @@ Override with `AI_STATE_DIR` environment variable.
 
 *Data collection handled by JavaScript collectors (lib/reality-check/collectors.js)*
 
+**Enhancement (Mixed Models):**
+| Agent | Model | Purpose |
+|-------|-------|---------|
+| enhancement-orchestrator | opus | Coordinate parallel enhancer execution and aggregate results |
+| enhancement-reporter | sonnet | Generate unified reports with deduplication |
+| plugin-enhancer | sonnet | Analyze plugin structures and MCP tools |
+| agent-enhancer | opus | Analyze agent prompts and frontmatter |
+| docs-enhancer | sonnet | Analyze documentation for RAG optimization |
+| claudemd-enhancer | sonnet | Analyze CLAUDE.md/AGENTS.md files |
+| prompt-enhancer | opus | Analyze general prompts for quality |
+
+
 ---
 
 ## Repository Structure

package/bin/cli.js

@@ -135,7 +135,7 @@ function installForClaude() {
     }
 
     // Install or update plugins
-    const plugins = ['next-task', 'ship', 'deslop-around', 'project-review', 'reality-check'];
+    const plugins = ['next-task', 'ship', 'deslop-around', 'project-review', 'reality-check', 'enhance'];
     for (const plugin of plugins) {
       console.log(`  Installing ${plugin}...`);
       try {
@@ -152,7 +152,7 @@ function installForClaude() {
     }
 
     console.log('\n✅ Claude Code installation complete!\n');
-    console.log('Commands: /next-task, /ship, /deslop-around, /project-review, /reality-check:scan');
+    console.log('Commands: /next-task, /ship, /deslop-around, /project-review, /reality-check:scan, /enhance');
     return true;
   } catch (err) {
     console.log('❌ Auto-install failed. Manual installation:');
@@ -217,6 +217,7 @@ function installForOpenCode(installDir) {
   // Sync command files (matching install.sh mappings)
   const commandMappings = [
     ['deslop-around.md', 'deslop-around', 'deslop-around.md'],
+    ['enhance.md', 'enhance', 'enhance.md'],
     ['next-task.md', 'next-task', 'next-task.md'],
     ['delivery-approval.md', 'next-task', 'delivery-approval.md'],
     ['update-docs-around.md', 'next-task', 'update-docs-around.md'],
@@ -326,6 +327,7 @@ AI_STATE_DIR = ".codex"
   // Skill mappings: [skillName, plugin, sourceFile, description]
   // Codex skills require SKILL.md with name and description in YAML frontmatter
   const skillMappings = [
+    ['enhance', 'enhance', 'enhance.md', 'Master enhancement orchestrator with parallel analyzer execution'],
     ['next-task', 'next-task', 'next-task.md', 'Master workflow orchestrator with autonomous task-to-production automation'],
     ['ship', 'ship', 'ship.md', 'Complete PR workflow from commit to production with validation'],
     ['deslop-around', 'deslop-around', 'deslop-around.md', 'AI slop cleanup with minimal diffs and behavior preservation'],