awesome-slash 3.3.0 → 3.3.3

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "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.0",
+  "version": "3.3.3",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -13,56 +13,56 @@
       "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.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "3.3.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "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.0",
+      "version": "3.3.3",
       "category": "development"
     }
   ],

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.3.3] - 2026-01-29
+
+### 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
+
+## [3.3.2] - 2026-01-29
+
+### Fixed
+- **sync-docs Plugin Manifest** - Removed invalid `commands` field that caused "Invalid input" validation error during plugin installation
+- **/ship Hook Response** - Added JSON response at workflow completion for SubagentStop hook compatibility
+
 ## [3.3.0] - 2026-01-28
 
 ### Changed

package/mcp-server/index.js

@@ -1018,7 +1018,7 @@ async function main() {
 const server = new Server(
     {
       name: 'awesome-slash',
-      version: '3.3.0',
+      version: '3.3.3',
     },
     {
       capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-slash",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "8 specialized plugins for AI workflow automation (drift detection + AST repo maps) - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",

package/plugins/audit-project/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "audit-project",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Multi-agent iterative code review until zero issues remain",
   "author": {
     "name": "Avi Fenesh",

package/plugins/audit-project/commands/audit-project-agents.md

@@ -32,7 +32,9 @@ Create a temporary review queue file in the platform state dir. Review passes ap
 ```javascript
 const path = require('path');
 const fs = require('fs');
-const { getStateDirPath } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/platform/state-dir.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { getStateDirPath } = require(`${pluginPath}/lib/platform/state-dir.js`);
 
 const stateDirPath = getStateDirPath(process.cwd());
 if (!fs.existsSync(stateDirPath)) {

package/plugins/audit-project/commands/audit-project.md

@@ -38,8 +38,10 @@ Otherwise create a new queue file. See `audit-project-agents.md` for queue handl
 ### Platform Detection
 
 ```bash
-PLATFORM=$(node ${CLAUDE_PLUGIN_ROOT}/lib/platform/detect-platform.js)
-TOOLS=$(node ${CLAUDE_PLUGIN_ROOT}/lib/platform/verify-tools.js)
+PLUGIN_PATH="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}"
+if [ -z "$PLUGIN_PATH" ]; then echo "Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set"; exit 1; fi
+PLATFORM=$(node "$PLUGIN_PATH/lib/platform/detect-platform.js")
+TOOLS=$(node "$PLUGIN_PATH/lib/platform/verify-tools.js")
 
 PROJECT_TYPE=$(echo $PLATFORM | jq -r '.projectType')
 PACKAGE_MGR=$(echo $PLATFORM | jq -r '.packageManager')

package/plugins/deslop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deslop",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "AI slop cleanup with minimal diffs and behavior preservation",
   "author": {
     "name": "Avi Fenesh",

package/plugins/deslop/commands/deslop.md

@@ -81,13 +81,17 @@ For **diff-based cleanup** of new work only, use the `deslop-work` agent via `/n
 Run the detection script to scan for slop patterns:
 
 ```bash
-node "${CLAUDE_PLUGIN_ROOT}/scripts/detect.js" <scope> --compact
+PLUGIN_PATH="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}"
+if [ -z "$PLUGIN_PATH" ]; then echo "Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set"; exit 1; fi
+node "$PLUGIN_PATH/scripts/detect.js" <scope> --compact
 ```
 
 For deep analysis with all multi-pass analyzers:
 
 ```bash
-node "${CLAUDE_PLUGIN_ROOT}/scripts/detect.js" <scope> --deep --compact
+PLUGIN_PATH="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}"
+if [ -z "$PLUGIN_PATH" ]; then echo "Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set"; exit 1; fi
+node "$PLUGIN_PATH/scripts/detect.js" <scope> --deep --compact
 ```
 
 Parse the output to identify top 10 hotspots, sorted by:
@@ -109,7 +113,9 @@ Present findings as a prioritized cleanup plan:
 Run detection with apply flag for auto-fixable patterns:
 
 ```bash
-node "${CLAUDE_PLUGIN_ROOT}/scripts/detect.js" <scope> --apply --max <max-changes> --compact
+PLUGIN_PATH="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}"
+if [ -z "$PLUGIN_PATH" ]; then echo "Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set"; exit 1; fi
+node "$PLUGIN_PATH/scripts/detect.js" <scope> --apply --max <max-changes> --compact
 ```
 
 Then implement remaining manual fixes one changeset at a time:

package/plugins/drift-detect/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "drift-detect",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Deep repository analysis to realign project plans with actual code reality - discovers drift, gaps, and produces prioritized reconstruction plans",
   "author": {
     "name": "Avi Fenesh",

package/plugins/drift-detect/commands/drift-detect.md

@@ -33,7 +33,11 @@ Example: `/drift-detect --sources github,docs --depth quick --output file`
 
 ```javascript
 // Normalize path for Windows (backslashes break in require strings)
-const pluginPath = '${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) {
+  console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT environment variable not set');
+  process.exit(1);
+}
 const collectors = require(`${pluginPath}/lib/drift-detect/collectors.js`);
 const repoMap = require(`${pluginPath}/lib/repo-map`);
 
@@ -116,7 +120,7 @@ console.log(`
 
 ${collectedData.github?.available ? `- **GitHub**: ${collectedData.github.issues.length} issues, ${collectedData.github.prs.length} PRs` : '- **GitHub**: Not available'}
 ${collectedData.docs ? `- **Documentation**: ${Object.keys(collectedData.docs.files).length} files analyzed` : '- **Documentation**: Skipped'}
-${collectedData.code ? `- **Code**: ${Object.keys(collectedData.code.structure).length} directories scanned` : '- **Code**: Skipped'}
+${collectedData.code?.summary?.totalDirs ? `- **Code**: ${collectedData.code.summary.totalDirs} directories scanned` : '- **Code**: Skipped'}
 
 → Sending to semantic analyzer...
 `);

package/plugins/enhance/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "enhance",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Plugin structure and tool use analyzer - validates plugin.json, MCP tools, and security patterns",
   "author": {
     "name": "Avi Fenesh",

package/plugins/enhance/agents/claudemd-enhancer.md

@@ -195,7 +195,9 @@ Generate a structured markdown report:
 ## Implementation
 
 ```javascript
-const { projectmemoryAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { projectmemoryAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Find and analyze project memory
 const results = await projectmemoryAnalyzer.analyze(projectPath, {

package/plugins/enhance/commands/enhance.md

@@ -181,7 +181,9 @@ Parse from $ARGUMENTS:
 ## Implementation
 
 ```javascript
-const { pluginAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { pluginAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Parse arguments
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);
@@ -319,7 +321,9 @@ Parse from $ARGUMENTS:
 ## Implementation
 
 ```javascript
-const { agentAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { agentAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Parse arguments
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);
@@ -500,7 +504,9 @@ For user-facing documentation:
 ## Implementation
 
 ```javascript
-const { docsAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { docsAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Parse arguments
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);
@@ -695,7 +701,9 @@ Note: Reference validation (file paths, npm commands) is always enabled.
 ## Implementation
 
 ```javascript
-const { projectmemoryAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { projectmemoryAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Parse arguments
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);
@@ -871,7 +879,9 @@ Parse from $ARGUMENTS:
 ## Implementation
 
 ```javascript
-const { promptAnalyzer } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/enhance');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { promptAnalyzer } = require(`${pluginPath}/lib/enhance`);
 
 // Parse arguments
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);

package/plugins/next-task/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "next-task",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Master workflow orchestrator with autonomous task-to-production automation, quality gates, and multi-agent review",
   "author": {
     "name": "Avi Fenesh",

package/plugins/next-task/agents/ci-monitor.md

@@ -42,7 +42,9 @@ const SUBSEQUENT_WAIT = 120000;  // 2 min between checks
 const MAX_WAIT_TIME = 1800000;   // 30 min max
 const MAX_FIX_ITERATIONS = 5;
 
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const PR_NUMBER = workflowState.readState().pr.number;
 ```
 

package/plugins/next-task/agents/delivery-validator.md

@@ -41,7 +41,9 @@ NO human in the loop - either pass validation or fail and return to implementati
 ## Phase 1: Get Task Context
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 
 const state = workflowState.readFlow();
 const task = state.task;

package/plugins/next-task/agents/docs-updater.md

@@ -25,7 +25,9 @@ on documentation related to the files modified in the current workflow.
 ## Phase 1: Get Context
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 
 const state = workflowState.readState();
 const task = state.task;

package/plugins/next-task/agents/exploration-agent.md

@@ -13,7 +13,9 @@ This requires careful investigation and connecting disparate pieces of informati
 ## Phase 1: Load Task Context
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const state = workflowState.readState();
 
 const task = state.task;
@@ -26,7 +28,9 @@ console.log(`Description: ${task.description}`);
 Use the cached repo-map for faster symbol discovery and dependency hints:
 
 ```javascript
-const repoMap = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/repo-map');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const repoMap = require(`${pluginPath}/lib/repo-map`);
 const map = repoMap.load(process.cwd());
 
 if (!map) {

package/plugins/next-task/agents/implementation-agent.md

@@ -44,7 +44,9 @@ Before implementation:
 ## Phase 1: Load Approved Plan
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const state = workflowState.readFlow();
 
 if (!state.plan?.approved) {
@@ -59,7 +61,9 @@ console.log(`Steps: ${plan.steps.length}`);
 ## Phase 1.5: Use Repo Map for Symbol Locations (If Available)
 
 ```javascript
-const repoMap = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/repo-map');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const repoMap = require(`${pluginPath}/lib/repo-map`);
 const map = repoMap.load(process.cwd());
 
 if (map) {

package/plugins/next-task/agents/planning-agent.md

@@ -34,7 +34,9 @@ Before planning, you should have:
 ## Phase 1: Load Context
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const state = workflowState.readFlow();
 
 const task = state.task;
@@ -49,7 +51,9 @@ console.log(`Key files identified: ${explorationResults?.keyFiles?.join(', ')}`)
 Use repo-map to identify dependencies and exports before writing the plan:
 
 ```javascript
-const repoMap = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/repo-map');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const repoMap = require(`${pluginPath}/lib/repo-map`);
 const map = repoMap.load(process.cwd());
 
 if (!map) {

package/plugins/next-task/agents/task-discoverer.md

@@ -15,7 +15,9 @@ and present prioritized recommendations to the user.
 ## Phase 1: Load Policy from State
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const state = workflowState.readState();
 const policy = state.policy;
 
@@ -63,7 +65,9 @@ The source configuration comes from policy. It can be:
 ### Parse Source Configuration
 
 ```javascript
-const { sources } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { sources } = require(`${pluginPath}/lib`);
 
 // Source can be string or object
 const sourceConfig = typeof policy.taskSource === 'string'

package/plugins/next-task/agents/worktree-manager.md

@@ -271,7 +271,9 @@ createWorktreeStatus(state.task, state.workflow, BRANCH_NAME, MAIN_REPO_PATH);
 Update the workflow state with git information:
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 
 workflowState.updateState({
   git: {

package/plugins/next-task/commands/delivery-approval.md

@@ -27,7 +27,9 @@ const taskId = taskIdArg ? args[args.indexOf(taskIdArg) + 1] : null;
 ## Phase 1: Get Context
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 
 let task;
 let changedFiles;

package/plugins/next-task/commands/next-task.md

@@ -311,7 +311,9 @@ Parse from $ARGUMENTS:
 ## Pre-flight: Handle Arguments
 
 ```javascript
-const workflowState = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
 const args = '$ARGUMENTS'.split(' ').filter(Boolean);
 
 // ⛔ CRITICAL CHECK: If no flags provided, DO NOT check for existing tasks here
@@ -425,7 +427,9 @@ function mapStepToPhase(step) {
 No agent needed - call `sources.getPolicyQuestions()` and use AskUserQuestion.
 
 ```javascript
-const { sources } = require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+const { sources } = require(`${pluginPath}/lib`);
 
 // Get questions with cache-aware options (cached preference shown first if exists)
 const { questions, cachedPreference } = sources.getPolicyQuestions();

package/plugins/repo-map/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-map",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "AST-based repository map generator using ast-grep for symbol and import extraction with incremental updates",
   "author": {
     "name": "Avi Fenesh",

package/plugins/repo-map/commands/repo-map.md

@@ -29,7 +29,8 @@ Examples:
 ### 1) Load Repo Map Module
 
 ```javascript
-const pluginPath = '${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/');
+const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
 const repoMap = require(`${pluginPath}/lib/repo-map`);
 ```
 

package/plugins/ship/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ship",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Complete PR workflow from commit to production with validation",
   "author": {
     "name": "Avi Fenesh",

package/plugins/ship/commands/ship.md

@@ -46,7 +46,12 @@ Parse from $ARGUMENTS:
 ```javascript
 const args = '$ARGUMENTS'.split(' ');
 const stateIdx = args.indexOf('--state-file');
-const workflowState = stateIdx >= 0 ? require('${CLAUDE_PLUGIN_ROOT}'.replace(/\\/g, '/') + '/lib/state/workflow-state.js') : null;
+let workflowState = null;
+if (stateIdx >= 0) {
+  const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\/g, '/');
+  if (!pluginPath) { console.error('Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set'); process.exit(1); }
+  workflowState = require(`${pluginPath}/lib/state/workflow-state.js`);
+}
 
 function updatePhase(phase, result) {
   if (!workflowState) return;
@@ -59,8 +64,10 @@ function updatePhase(phase, result) {
 
 ```bash
 # Detect platform and project configuration
-PLATFORM=$(node ${CLAUDE_PLUGIN_ROOT}/lib/platform/detect-platform.js)
-TOOLS=$(node ${CLAUDE_PLUGIN_ROOT}/lib/platform/verify-tools.js)
+PLUGIN_PATH="${CLAUDE_PLUGIN_ROOT:-$PLUGIN_ROOT}"
+if [ -z "$PLUGIN_PATH" ]; then echo "Error: CLAUDE_PLUGIN_ROOT or PLUGIN_ROOT not set"; exit 1; fi
+PLATFORM=$(node "$PLUGIN_PATH/lib/platform/detect-platform.js")
+TOOLS=$(node "$PLUGIN_PATH/lib/platform/verify-tools.js")
 
 # Extract critical info
 CI_PLATFORM=$(echo $PLATFORM | jq -r '.ci')
@@ -287,7 +294,7 @@ git checkout $MAIN_BRANCH
 git pull origin $MAIN_BRANCH
 
 # Update repo-map if it exists (non-blocking)
-node -e "const pluginPath = '${CLAUDE_PLUGIN_ROOT}'.replace(/\\\\/g, '/'); const repoMap = require(`${pluginPath}/lib/repo-map`); if (repoMap.exists(process.cwd())) { repoMap.update(process.cwd(), {}).then(() => console.log('✓ Repo-map updated')).catch((e) => console.log('⚠️ Repo-map update failed: ' + e.message)); } else { console.log('Repo-map not found, skipping'); }" || true
+node -e "const pluginPath = (process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT || '').replace(/\\\\/g, '/'); const repoMap = require(\`\${pluginPath}/lib/repo-map\`); if (repoMap.exists(process.cwd())) { repoMap.update(process.cwd(), {}).then(() => console.log('✓ Repo-map updated')).catch((e) => console.log('⚠️ Repo-map update failed: ' + e.message)); } else { console.log('Repo-map not found, skipping'); }" || true
 MERGE_SHA=$(git rev-parse HEAD)
 echo "✓ Merged PR #$PR_NUMBER at $MERGE_SHA"
 ```
@@ -391,6 +398,16 @@ ${WORKFLOW === 'dev-prod' ?
 ✓ Successfully shipped!
 ```
 
+### Workflow Hook Response
+
+After displaying the completion report, output JSON for the SubagentStop hook:
+
+```json
+{"ok": true, "nextPhase": "completed", "status": "shipped"}
+```
+
+This allows the `/next-task` workflow to detect that `/ship` completed successfully.
+
 ## Error Handling
 
 See `ship-error-handling.md` for detailed error handling:

package/plugins/sync-docs/.claude-plugin/plugin.json

@@ -1,6 +1,20 @@
 {
   "name": "sync-docs",
-  "version": "3.3.0",
+  "version": "3.3.3",
   "description": "Sync documentation with code changes. Find outdated refs, update CHANGELOG, flag stale examples.",
-  "commands": ["commands/sync-docs.md"]
+  "author": {
+    "name": "Avi Fenesh",
+    "email": "[email protected]",
+    "url": "https://github.com/avifenesh"
+  },
+  "homepage": "https://github.com/avifenesh/awesome-slash#sync-docs",
+  "repository": "https://github.com/avifenesh/awesome-slash",
+  "license": "MIT",
+  "keywords": [
+    "documentation",
+    "changelog",
+    "sync",
+    "maintenance",
+    "code-docs"
+  ]
 }