awesome-slash 3.3.3 → 3.4.0

package/.claude-plugin/marketplace.json

@@ -1,68 +1,88 @@
 {
   "name": "awesome-slash",
-  "description": "8 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, and repo mapping",
-  "version": "3.3.3",
+  "description": "9 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, and perf investigations",
+  "version": "3.4.0",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
   },
   "repository": "https://github.com/avifenesh/awesome-slash",
-  "keywords": ["ai", "llm", "agents", "agentic", "claude-code", "opencode", "codex", "mcp", "automation", "workflow", "code-review", "multi-agent"],
+  "keywords": [
+    "ai",
+    "llm",
+    "agents",
+    "agentic",
+    "claude-code",
+    "opencode",
+    "codex",
+    "mcp",
+    "automation",
+    "workflow",
+    "code-review",
+    "multi-agent"
+  ],
   "plugins": [
     {
       "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": "3.3.3",
+      "version": "3.4.0",
       "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": "3.3.3",
+      "version": "3.4.0",
       "category": "deployment"
     },
     {
       "name": "deslop",
       "source": "./plugins/deslop",
       "description": "3-phase AI slop detection: regex patterns (HIGH), multi-pass analyzers (MEDIUM), CLI tools (LOW)",
-      "version": "3.3.3",
+      "version": "3.4.0",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "3.3.3",
+      "version": "3.4.0",
       "category": "development"
     },
     {
       "name": "drift-detect",
       "source": "./plugins/drift-detect",
       "description": "Deep repository analysis to realign project plans with code reality - detects drift, gaps, and creates prioritized reconstruction plans",
-      "version": "3.3.3",
+      "version": "3.4.0",
       "category": "productivity"
     },
     {
       "name": "enhance",
       "source": "./plugins/enhance",
       "description": "Master enhancement orchestrator: parallel analyzer execution for plugins, agents, docs, CLAUDE.md, and prompts with unified reporting",
-      "version": "3.3.3",
+      "version": "3.4.0",
       "category": "development"
     },
     {
       "name": "sync-docs",
       "source": "./plugins/sync-docs",
       "description": "Standalone documentation sync: find outdated refs, update CHANGELOG, flag stale examples based on code changes",
-      "version": "3.3.3",
+      "version": "3.4.0",
       "category": "development"
     },
     {
       "name": "repo-map",
       "source": "./plugins/repo-map",
       "description": "AST-based repository map generation using ast-grep with incremental updates for faster drift analysis",
-      "version": "3.3.3",
+      "version": "3.4.0",
+      "category": "development"
+    },
+    {
+      "name": "perf",
+      "source": "./plugins/perf",
+      "description": "Rigorous performance investigation workflow with baselines, profiling, hypotheses, and evidence-backed decisions",
+      "version": "3.4.0",
       "category": "development"
     }
   ],
@@ -70,6 +90,16 @@
     "name": "awesome-slash",
     "source": "./mcp-server",
     "description": "Cross-platform MCP server with 3-phase slop detection pipeline and enhance analyzers",
-    "tools": ["workflow_status", "workflow_start", "workflow_resume", "workflow_abort", "task_discover", "review_code", "slop_detect", "enhance_analyze", "repo_map"]
+    "tools": [
+      "workflow_status",
+      "workflow_start",
+      "workflow_resume",
+      "workflow_abort",
+      "task_discover",
+      "review_code",
+      "slop_detect",
+      "enhance_analyze",
+      "repo_map"
+    ]
   }
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-slash",
-  "version": "3.3.3",
+  "version": "3.4.0",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

package/CHANGELOG.md

@@ -7,16 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [3.3.3] - 2026-01-29
+## [3.4.0] - 2026-01-29
+
+### Added
+- **Repo-map perf script** - Reusable benchmark runner for repo-map creation
+
+### Changed
+- **/perf benchmarking** - Added oneshot mode plus multi-run aggregation with duration/runs controls
+
+### Removed
+- **Repo-map docs analysis** - Dropped documentation scanning and legacy docs fields from repo-map output
+
+## [3.4.0-rc.1] - 2026-01-29
+
+### Added
+- **/perf Plugin** - Structured performance investigations with baselines, profiling, hypotheses, and evidence-backed decisions
+- **/perf Command** - Phase-based workflow for baselining, breaking points, constraints, profiling, and consolidation
+- **/perf Skills & Agents** - Baseline, benchmark, profiling, theory testing, code paths, and investigation logging
+- **/enhance Hooks Analyzer** - New hook checks for frontmatter completeness and safety cues
+- **/enhance Skills Analyzer** - New SKILL.md checks for frontmatter and trigger phrase clarity
+- **Enhance MCP Tool** - `enhance_analyze` now supports `hooks` and `skills` focus targets
+
+### Changed
+- **Enhance Orchestrator** - Expanded to run hooks/skills analyzers alongside existing enhancers
+- **Docs** - Expanded /perf usage, requirements, and architecture references
 
 ### Fixed
-- **Windows Path Template Substitution** - Fixed plugin path template substitution across 18 command/agent files
-  - Replaced `'${CLAUDE_PLUGIN_ROOT}'.replace()` with runtime `process.env` access
-  - Pattern: `(process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/')`
-  - Supports both CLAUDE_PLUGIN_ROOT and PLUGIN_ROOT for cross-platform compatibility
-  - Added validation for missing environment variables in bash sections
-  - Bash pattern: `${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}` with explicit error handling
-  - Fixes: Template strings in require() paths were not being substituted at runtime on Windows
+- **/perf Path Safety** - Validate investigation ids and baseline versions to prevent path traversal
+- **/perf Optimization Runner** - Explicit warm-up before experiment capture
 
 ## [3.3.2] - 2026-01-29
 

package/README.md

@@ -14,9 +14,10 @@ AI models can write code. That's not the hard part anymore. The hard part is eve
 
 | Section | What's there |
 |---------|--------------|
-| [Commands](#commands) | All 8 commands with jump links |
+| [Commands](#commands) | All 9 commands with jump links |
 | [What This Does](#what-this-project-does) | The problem and how this solves it |
 | [What's Different](#what-makes-this-different) | Why this isn't just another AI tool |
+| [What's New](#whats-new-in-v340) | Latest release highlights |
 | [Design Philosophy](#design-philosophy) | The thinking behind the architecture |
 | [Command Details](#command-details) | Deep dive into each command |
 | [Installation](#installation) | Get started in 2 commands |
@@ -34,8 +35,17 @@ AI models can write code. That's not the hard part anymore. The hard part is eve
 | [`/audit-project`](#audit-project) | Multi-agent code review until issues resolved | [→](#audit-project) |
 | [`/drift-detect`](#drift-detect) | Compares your docs to actual code state | [→](#drift-detect) |
 | [`/repo-map`](#repo-map) | Builds a cached AST repo map for fast analysis | [→](#repo-map) |
-| [`/enhance`](#enhance) | Analyzes prompts, plugins, docs for improvements | [→](#enhance) |
+| [`/enhance`](#enhance) | Analyzes prompts, plugins, agents, docs, hooks, skills | [→](#enhance) |
 | [`/sync-docs`](#sync-docs) | Syncs documentation with code changes | [→](#sync-docs) |
+| [`/perf`](#perf) | Runs structured performance investigations | [→](#perf) |
+
+---
+
+## What's New in v3.4.0
+
+- **/perf benchmarking upgrades** with oneshot runs, multi-run aggregation, and configurable duration/runs
+- **Repo-map simplification** by removing documentation analysis and legacy docs fields
+- **Repo-map perf script** for consistent map creation benchmarks
 
 ---
 
@@ -433,7 +443,6 @@ Multi-agent collection wastes tokens on coordination. JavaScript collectors are
 
 - Cached file→symbols map (exports, functions, classes)
 - Import graph for dependency hints
-- Optional docs analysis (features, checkboxes)
 
 Output is cached at `{state-dir}/repo-map.json` and exposed via the MCP `repo_map` tool.
 
@@ -455,9 +464,9 @@ Tools like `/drift-detect` and planners can use the map instead of re-scanning t
 
 ### /enhance
 
-**Purpose:** Analyzes your prompts, plugins, agents, and docs for improvement opportunities.
+**Purpose:** Analyzes your prompts, plugins, agents, docs, hooks, and skills for improvement opportunities.
 
-**Five analyzers run in parallel:**
+**Seven analyzers run in parallel:**
 
 | Analyzer | What it checks |
 |----------|----------------|
@@ -466,6 +475,8 @@ Tools like `/drift-detect` and planners can use the map instead of re-scanning t
 | claudemd-enhancer | CLAUDE.md/AGENTS.md structure, token efficiency |
 | docs-enhancer | Documentation readability, RAG optimization |
 | prompt-enhancer | Prompt engineering patterns, clarity, examples |
+| hooks-enhancer | Hook frontmatter, structure, safety |
+| skills-enhancer | SKILL.md structure, trigger phrases |
 
 **Each finding includes:**
 - Certainty level (HIGH/MEDIUM/LOW)
@@ -484,6 +495,32 @@ Tools like `/drift-detect` and planners can use the map instead of re-scanning t
 
 ---
 
+### /perf
+
+**Purpose:** Run structured performance investigations with baselines, profiling, and evidence‑backed decisions.
+
+**Usage:**
+
+```bash
+/perf                 # Start new investigation
+/perf --resume        # Resume previous investigation
+```
+
+**Phase flags (advanced):**
+
+```bash
+/perf --phase baseline --command "npm run bench" --version v1.2.0
+/perf --phase breaking-point --command "npm run bench" --param-min 1 --param-max 500
+/perf --phase constraints --command "npm run bench" --cpu 1 --memory 1GB
+/perf --phase hypotheses --hypotheses-file perf-hypotheses.json
+/perf --phase code-paths
+/perf --phase optimization --change "reduce allocations"
+/perf --phase decision --verdict stop --rationale "no measurable improvement"
+/perf --phase consolidation --version v1.2.0
+```
+
+---
+
 ### /sync-docs
 
 **Purpose:** Sync documentation with actual code changes—find outdated refs, update CHANGELOG, flag stale examples.

package/adapters/opencode-plugin/index.ts

@@ -45,6 +45,8 @@ const AGENT_THINKING_CONFIG: Record<string, { budget: number; description: strin
   "docs-enhancer": { budget: 16000, description: "Docs improvement" },
   "claudemd-enhancer": { budget: 16000, description: "Project memory optimization" },
   "prompt-enhancer": { budget: 16000, description: "Prompt quality analysis" },
+  "hooks-enhancer": { budget: 16000, description: "Hook best-practices review" },
+  "skills-enhancer": { budget: 16000, description: "Skill prompt review" },
 }
 
 // Workflow phases where certain actions are blocked

package/bin/cli.js

@@ -135,7 +135,7 @@ function installForClaude() {
     }
 
     // PLUGINS_ARRAY - Install or update plugins
-    const plugins = ['next-task', 'ship', 'deslop', 'audit-project', 'drift-detect', 'enhance', 'sync-docs', 'repo-map'];
+    const plugins = ['next-task', 'ship', 'deslop', 'audit-project', 'drift-detect', 'enhance', 'sync-docs', 'repo-map', 'perf'];
     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, /audit-project, /drift-detect, /enhance');
+    console.log('Commands: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /perf');
     return true;
   } catch (err) {
     console.log('❌ Auto-install failed. Manual installation:');
@@ -249,7 +249,8 @@ function installForOpenCode(installDir, options = {}) {
     ['audit-project.md', 'audit-project', 'audit-project.md'],
     ['ship.md', 'ship', 'ship.md'],
     ['drift-detect.md', 'drift-detect', 'drift-detect.md'],
-    ['repo-map.md', 'repo-map', 'repo-map.md']
+    ['repo-map.md', 'repo-map', 'repo-map.md'],
+    ['perf.md', 'perf', 'perf.md']
   ];
 
   // Helper function to transform content for OpenCode
@@ -311,7 +312,7 @@ function installForOpenCode(installDir, options = {}) {
   fs.mkdirSync(agentsDir, { recursive: true });
 
   console.log('  Installing agents for OpenCode...');
-  const pluginDirs = ['next-task', 'enhance', 'audit-project', 'drift-detect', 'ship', 'deslop', 'repo-map'];
+  const pluginDirs = ['next-task', 'enhance', 'audit-project', 'drift-detect', 'ship', 'deslop', 'repo-map', 'perf'];
   let agentCount = 0;
 
   for (const pluginName of pluginDirs) {
@@ -388,7 +389,7 @@ function installForOpenCode(installDir, options = {}) {
   console.log(`   Commands: ${commandsDir}`);
   console.log(`   Agents: ${agentsDir}`);
   console.log(`   Plugin: ${pluginDir}`);
-  console.log('   Access via: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /sync-docs');
+  console.log('   Access via: /next-task, /ship, /deslop, /audit-project, /drift-detect, /enhance, /sync-docs, /perf');
   console.log('   MCP tools: workflow_status, workflow_start, workflow_resume, task_discover, review_code, slop_detect, enhance_analyze, repo_map');
   console.log('   Native features: Auto-thinking selection, workflow enforcement, session compaction\n');
   return true;
@@ -495,6 +496,8 @@ AI_STATE_DIR = ".codex"
       'Use when user asks to "check plan drift", "compare docs to code", "verify roadmap", "scan for reality gaps". Analyzes documentation vs actual code to detect drift and outdated plans.'],
     ['repo-map', 'repo-map', 'repo-map.md',
       'Use when user asks to "create repo map", "generate repo map", "update repo map", "repo map status", "map symbols". Builds and updates AST-based repo map using ast-grep.'],
+    ['perf', 'perf', 'perf.md',
+      'Use when user asks to "run perf", "performance investigation", "benchmark regression", "profiling workflow", "baseline performance". Runs structured perf investigations with baselines, profiling, hypotheses, and decisions.'],
     ['delivery-approval', 'next-task', 'delivery-approval.md',
       'Use when user asks to "validate delivery", "approve for shipping", "check if ready to ship", "verify task completion". Autonomous validation that tests pass, build succeeds, and requirements are met.'],
     ['sync-docs', 'sync-docs', 'sync-docs.md',

package/lib/enhance/hook-analyzer.js

@@ -0,0 +1,135 @@
+/**
+ * Hook analyzer for /enhance.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { hookPatterns } = require('./hook-patterns');
+const { parseMarkdownFrontmatter } = require('./agent-analyzer');
+
+function analyzeHook(hookPath) {
+  const results = {
+    hookName: path.basename(hookPath, '.md'),
+    hookPath,
+    structureIssues: []
+  };
+
+  if (!fs.existsSync(hookPath)) {
+    results.structureIssues.push({
+      issue: 'File not found',
+      file: hookPath,
+      certainty: 'HIGH',
+      patternId: 'file_not_found'
+    });
+    return results;
+  }
+
+  let content = '';
+  try {
+    content = fs.readFileSync(hookPath, 'utf8');
+  } catch (err) {
+    results.structureIssues.push({
+      issue: `Failed to read file: ${err.message}`,
+      file: hookPath,
+      certainty: 'HIGH',
+      patternId: 'read_error'
+    });
+    return results;
+  }
+
+  const missingFm = hookPatterns.missing_frontmatter.check(content);
+  if (missingFm) {
+    results.structureIssues.push({
+      ...missingFm,
+      file: hookPath,
+      certainty: hookPatterns.missing_frontmatter.certainty,
+      patternId: hookPatterns.missing_frontmatter.id
+    });
+  }
+
+  const { frontmatter } = parseMarkdownFrontmatter(content);
+  const missingName = hookPatterns.missing_name.check(frontmatter);
+  if (missingName) {
+    results.structureIssues.push({
+      ...missingName,
+      file: hookPath,
+      certainty: hookPatterns.missing_name.certainty,
+      patternId: hookPatterns.missing_name.id
+    });
+  }
+
+  const missingDescription = hookPatterns.missing_description.check(frontmatter);
+  if (missingDescription) {
+    results.structureIssues.push({
+      ...missingDescription,
+      file: hookPath,
+      certainty: hookPatterns.missing_description.certainty,
+      patternId: hookPatterns.missing_description.id
+    });
+  }
+
+  return results;
+}
+
+function analyzeAllHooks(hooksDir) {
+  const results = [];
+  if (!fs.existsSync(hooksDir)) return results;
+
+  const hookFiles = [];
+  const skipDirs = new Set(['node_modules', '.git', 'dist', 'build', 'out', 'target']);
+
+  function walk(dir) {
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch (err) {
+      return;
+    }
+
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isDirectory()) {
+        if (!skipDirs.has(entry.name)) {
+          walk(fullPath);
+        }
+        continue;
+      }
+
+      if (!entry.isFile() || !entry.name.endsWith('.md')) continue;
+      const parts = fullPath.split(path.sep);
+      if (parts.includes('hooks')) {
+        hookFiles.push(fullPath);
+      }
+    }
+  }
+
+  walk(hooksDir);
+
+  for (const file of hookFiles) {
+    results.push(analyzeHook(file));
+  }
+
+  return results;
+}
+
+function analyze(options = {}) {
+  const {
+    hook,
+    hooksDir = 'plugins/enhance/hooks'
+  } = options;
+
+  if (hook) {
+    const hookPath = hook.endsWith('.md')
+      ? hook
+      : path.join(hooksDir, `${hook}.md`);
+    return analyzeHook(hookPath);
+  }
+
+  return analyzeAllHooks(hooksDir);
+}
+
+module.exports = {
+  analyzeHook,
+  analyzeAllHooks,
+  analyze
+};

package/lib/enhance/hook-patterns.js

@@ -0,0 +1,40 @@
+/**
+ * Hook patterns for /enhance.
+ */
+
+const hookPatterns = {
+  missing_frontmatter: {
+    id: 'missing_frontmatter',
+    certainty: 'HIGH',
+    check(content) {
+      if (!content || !content.trim().startsWith('---')) {
+        return { issue: 'Missing YAML frontmatter in hook file' };
+      }
+      return null;
+    }
+  },
+  missing_name: {
+    id: 'missing_name',
+    certainty: 'HIGH',
+    check(frontmatter) {
+      if (!frontmatter || !frontmatter.name) {
+        return { issue: 'Missing name in hook frontmatter' };
+      }
+      return null;
+    }
+  },
+  missing_description: {
+    id: 'missing_description',
+    certainty: 'HIGH',
+    check(frontmatter) {
+      if (!frontmatter || !frontmatter.description) {
+        return { issue: 'Missing description in hook frontmatter' };
+      }
+      return null;
+    }
+  }
+};
+
+module.exports = {
+  hookPatterns
+};

package/lib/enhance/index.js

@@ -16,6 +16,8 @@ const projectmemoryAnalyzer = require('./projectmemory-analyzer');
 const projectmemoryPatterns = require('./projectmemory-patterns');
 const promptAnalyzer = require('./prompt-analyzer');
 const promptPatterns = require('./prompt-patterns');
+const hookAnalyzer = require('./hook-analyzer');
+const skillAnalyzer = require('./skill-analyzer');
 const reporter = require('./reporter');
 const fixer = require('./fixer');
 
@@ -26,6 +28,8 @@ module.exports = {
   docsAnalyzer,
   projectmemoryAnalyzer,
   promptAnalyzer,
+  hookAnalyzer,
+  skillAnalyzer,
 
   // Pattern modules
   pluginPatterns,
@@ -72,6 +76,16 @@ module.exports = {
   promptApplyFixes: promptAnalyzer.applyFixes,
   promptGenerateReport: promptAnalyzer.generateReport,
 
+  // Convenience exports - Hooks
+  analyzeHook: hookAnalyzer.analyzeHook,
+  analyzeAllHooks: hookAnalyzer.analyzeAllHooks,
+  hooksAnalyze: hookAnalyzer.analyze,
+
+  // Convenience exports - Skills
+  analyzeSkill: skillAnalyzer.analyzeSkill,
+  analyzeAllSkills: skillAnalyzer.analyzeAllSkills,
+  skillsAnalyze: skillAnalyzer.analyze,
+
   // Convenience exports - Orchestrator
   generateOrchestratorReport: reporter.generateOrchestratorReport,
   deduplicateOrchestratorFindings: reporter.deduplicateOrchestratorFindings

package/lib/enhance/reporter.js

@@ -1091,7 +1091,7 @@ function generateOrchestratorReport(aggregatedResults, options = {}) {
   lines.push('| Enhancer | HIGH | MEDIUM | LOW | Auto-Fixable |');
   lines.push('|----------|------|--------|-----|--------------|');
 
-  const enhancerTypes = ['plugin', 'agent', 'claudemd', 'docs', 'prompt'];
+  const enhancerTypes = ['plugin', 'agent', 'claudemd', 'docs', 'prompt', 'hooks', 'skills'];
   let totalHigh = 0, totalMedium = 0, totalLow = 0, totalAutoFix = 0;
 
   for (const enhancer of enhancerTypes) {