awesome-slash 4.1.0 → 4.2.0

package/.agnix.toml

@@ -12,6 +12,7 @@ exclude = [
 ]
 target = "ClaudeCode"
 tools = []
+locale = "en"
 
 [rules]
 skills = true
@@ -22,19 +23,25 @@ plugins = true
 xml = true
 mcp = true
 imports = true
-cross_platform = false  # Intentional - we document all 3 platform paths
+cross_platform = false # Intentional - we document all 3 platform paths
 agents_md = true
-copilot = false  # Not targeting Copilot
-cursor = false   # Not targeting Cursor
+copilot = false # Not targeting Copilot
+cursor = false # Not targeting Cursor
 prompt_engineering = true
 generic_instructions = true
 frontmatter_validation = true
 xml_balance = true
 import_references = true
 disabled_rules = [
-    "hardcoded-claude-path",   # Intentional - we document platform paths
-    "hardcoded-opencode-path", # Intentional - we document platform paths
-    "windows-path-separator",  # False positives on regex escape sequences (\n, \s, \d)
+    "XP-003",      # Intentional - we document all 3 platform paths (.claude/, .opencode/, .codex/)
+    "AS-014",      # False positives on regex escape sequences (\n, \s, \d)
+    "CC-AG-009",   # False positive - Skill, AskUserQuestion, LSP are valid Claude Code tools
+    "CC-MEM-009",  # Intentional - CLAUDE.md uses structured sections, size is necessary
+    "AGM-006",     # Intentional - root AGENTS.md (instructions) + docs/reference/AGENTS.md (reference)
+    "AGM-003",     # docs/reference/AGENTS.md is a comprehensive reference doc
+    "PE-001",      # Reference docs have structured layout; middle placement is intentional
+    "AS-012",      # enhance-hooks is a comprehensive hook reference (needs >500 lines)
+    "CC-SK-009",   # enhance-skills contains example injections for teaching purposes
 ]
 
 [tool_versions]

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-slash",
-  "description": "11 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, and agent config linting",
-  "version": "4.1.0",
+  "description": "12 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, agent config linting, and cross-tool AI consultation",
+  "version": "4.2.0",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"
@@ -26,78 +26,85 @@
       "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": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.0",
       "category": "development"
     },
     {
       "name": "audit-project",
       "source": "./plugins/audit-project",
       "description": "Multi-agent iterative code review until zero issues remain",
-      "version": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.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": "4.1.0",
+      "version": "4.2.0",
       "category": "development"
     },
     {
       "name": "perf",
       "source": "./plugins/perf",
       "description": "Rigorous performance investigation workflow with baselines, profiling, hypotheses, and evidence-backed decisions",
-      "version": "4.1.0",
+      "version": "4.2.0",
       "category": "development"
     },
     {
       "name": "learn",
       "source": "./plugins/learn",
       "description": "Research topics online and create comprehensive learning guides with RAG-optimized indexes",
-      "version": "4.1.0",
+      "version": "4.2.0",
       "category": "productivity"
     },
     {
       "name": "agnix",
       "source": "./plugins/agnix",
-      "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 100 rules",
-      "version": "4.1.0",
+      "description": "Lint agent configuration files (SKILL.md, CLAUDE.md, hooks, MCP) against 155 rules across 10+ AI tools",
+      "version": "4.2.0",
       "category": "development"
+    },
+    {
+      "name": "consult",
+      "source": "./plugins/consult",
+      "description": "Cross-tool AI consultation: get second opinions from Gemini CLI, Codex CLI, Claude Code, OpenCode, or Copilot CLI with model and thinking effort control",
+      "version": "4.2.0",
+      "category": "productivity"
     }
   ]
 }

package/.claude-plugin/plugin.json

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

package/AGENTS.md

@@ -11,7 +11,7 @@
    *WHY: Breaking changes affect all plugin users immediately.*
 
 2. **Plugin for OTHER projects** - Optimize for plugin users, not internal dev convenience.
-   *WHY: Every decision should improve the experience for developers using this in their repos.*
+   *WHY: Every decision MUST improve the experience for developers using this in their repos.*
 
 3. **Use CHANGELOG.md for completion tracking** - MUST use CHANGELOG.md for release notes. NEVER create `*_AUDIT.md`, `*_SUMMARY.md`, `*_COMPLETION.md` files.
    *WHY: Summary files clutter repos and add no value. Report completion verbally.*
@@ -39,7 +39,7 @@
    - Run the `/enhance` command on new or modified commands, agents, skills, hooks or prompts
    - Verify cross-platform compatibility (OpenCode + Codex)
    - Update `bin/cli.js` mappings if new command/agent added
-   - Don't mark complete until ALL checklist items are done
+   - Only mark complete after ALL checklist items are done
    *WHY: Checklists exist because we kept missing things. They are the definition of "done".*
 
 8. **Use plain text markers** - MUST use `[OK]`, `[ERROR]`, `[WARN]`, `[CRITICAL]` for status. NEVER use emojis or ASCII art boxes.
@@ -56,14 +56,27 @@
    - Hooks catch problems before they reach the repo
    - Fix the root cause, then retry
    *WHY: Hooks are safety nets. Bypassing them defeats their purpose.*
+
+11. **Fix all test failures** - NEVER skip or ignore a failing test because it's "out of scope" or "pre-existing". Always fix it.
+   - If a test fails during your work, fix it before proceeding
+   - No test is someone else's problem
+   *WHY: Skipping failures erodes test trust. Every green run must mean everything works.*
+
+12. **Report script failures before manual fallback** - When any project script fails (npm test/run/build, scripts/*, awesome-slash-dev, node bin/dev-cli.js), you MUST:
+   - Report the failure with exact error output to the user
+   - Diagnose the root cause of the failure
+   - Fix the script/tooling issue, not work around it manually
+   - NEVER silently fall back to doing the work by hand
+   *WHY: Silent fallbacks mask broken tooling. A failed script needs fixing, not bypassing.*
 </critical-rules>
 
 <architecture>
 ## Architecture
 
+<!-- GEN:START:claude-architecture -->
 ```
-lib/          → Shared library (canonical source)
-plugins/      → 9 plugins, 39 agents (29 file-based + 10 role-based), 25 skills
+lib/          → Shared library (published as @awesome-slash/lib, vendored to plugins)
+plugins/      → 12 plugins, 41 agents (31 file-based + 10 role-based), 27 skills
 adapters/     → Platform adapters (opencode-plugin/, opencode/, codex/)
 checklists/   → Action checklists (9 files)
 bin/cli.js    → npm CLI installer
@@ -71,15 +84,19 @@ bin/cli.js    → npm CLI installer
 
 | Plugin | Agents | Skills | Purpose |
 |--------|--------|--------|---------|
-| next-task | 10 | 3 | Master workflow orchestration |
-| enhance | 9 | 9 | Code quality analyzers |
-| ship | 0 | 0 | PR creation and deployment |
-| perf | 6 | 8 | Performance investigation |
+| agnix | 1 | 1 | Agent config linting |
 | audit-project | 10 | 0 | Multi-agent code review |
+| consult | 1 | 1 | Cross-tool AI consultation |
 | deslop | 1 | 1 | AI slop cleanup |
 | drift-detect | 1 | 1 | Plan drift detection |
+| enhance | 8 | 9 | Code quality analyzers |
+| learn | 1 | 1 | Topic research and learning guides |
+| next-task | 10 | 3 | Master workflow orchestration |
+| perf | 6 | 8 | Performance investigation |
 | repo-map | 1 | 1 | AST repo mapping |
+| ship | 0 | 0 | PR creation and deployment |
 | sync-docs | 1 | 1 | Documentation sync |
+<!-- GEN:END:claude-architecture -->
 
 **Pattern**: `Command → Agent → Skill` (orchestration → invocation → implementation)
 </architecture>
@@ -104,9 +121,39 @@ bin/cli.js    → npm CLI installer
 
 ### Dev Commands
 ```bash
+npx awesome-slash-dev status           # Project health (version, counts, branch)
+npx awesome-slash-dev validate         # Run all validators
+npx awesome-slash-dev validate plugins # Run single validator
+npx awesome-slash-dev bump <version>   # Bump all version files (e.g., 3.7.3)
+npx awesome-slash-dev sync-lib         # Sync lib/ to plugins/
+npx awesome-slash-dev test             # Run test suite
+npx awesome-slash-dev preflight         # Change-aware checklist enforcement
+npx awesome-slash-dev preflight --all   # Run all checks
+npx awesome-slash-dev preflight --release # All checks + release extras
+npx awesome-slash-dev gen-docs          # Auto-generate doc sections
+npx awesome-slash-dev gen-docs --check  # Validate docs are fresh (CI)
+npx awesome-slash-dev new plugin <name>  # Scaffold new plugin
+npx awesome-slash-dev new agent <name> --plugin=<plugin>  # Scaffold new agent
+npx awesome-slash-dev new skill <name> --plugin=<plugin>  # Scaffold new skill
+npx awesome-slash-dev new command <name> --plugin=<plugin>  # Scaffold new command
+npx awesome-slash-dev --help           # Show all commands
+
+# Or invoke directly:
+node bin/dev-cli.js <command>
+
+# npm aliases still work:
 npm test                     # Run tests (do before commits)
-npm run bump <version>       # Bump all version files (e.g., 3.7.3)
-./scripts/sync-lib.sh        # Sync lib/ to plugins/
+npm run validate             # All validators via dev-cli
+npm run preflight            # Change-aware preflight checks
+npm run preflight:all        # All preflight checks
+npm run preflight:release    # Release preflight
+npm run gen-docs             # Auto-generate documentation
+npm run gen-docs:check       # Check if docs are stale
+npm run new:plugin           # Scaffold new plugin
+npm run new:agent            # Scaffold new agent
+npm run new:skill            # Scaffold new skill
+npm run new:command          # Scaffold new command
+npm run bump <version>       # Bump versions via dev-cli
 npm pack                     # Build package
 awesome-slash                # Run installer
 ```