@dzhechkov/skills-feature-adr 1.3.10 → 1.3.11

package/README.md

@@ -446,6 +446,46 @@ npx @dzhechkov/skills-feature-adr init     # Feature development
 
 ---
 
+## Troubleshooting
+
+### `sh: 1: skills-feature-adr: not found` — npx inside a monorepo with workspaces
+
+If you run `npx @dzhechkov/skills-feature-adr <command>` from **inside a monorepo** whose root
+`package.json` declares `"workspaces"` (npm/pnpm/yarn) and a local workspace package shadows this
+name (e.g. you vendored or forked this package, or you're developing it), npx resolves the **local
+workspace copy** instead of fetching from the registry. It then looks for the bin shim in
+`node_modules/.bin/` — which the workspace manager may never have created (pnpm links shims only
+for declared dependencies) — and falls back to running the bare command in your shell:
+
+```
+sh: 1: skills-feature-adr: not found
+```
+
+**Note:** pinning a version (`npx @dzhechkov/skills-feature-adr@x.y.z`) does **not** bypass
+workspace resolution — verified.
+
+**Fixes:**
+
+```bash
+# 1. Run it where it belongs — in the TARGET project (where .claude/ lives).
+#    That directory is normally not the package's own monorepo:
+cd /path/to/your-project
+npx @dzhechkov/skills-feature-adr update
+
+# 2. Developing inside the monorepo that contains this package? Invoke the
+#    workspace copy's bin directly:
+node <monorepo>/packages/@dzhechkov/skills-feature-adr/bin/cli.js update
+
+# 3. Or use a global install (resolves independently of any workspace):
+npm install -g @dzhechkov/skills-feature-adr
+skills-feature-adr update
+```
+
+Related: `init`/`update`/`remove` operate on the **current directory's** `.claude/` install — running
+them inside the package's own monorepo is almost never what you want anyway.
+
+---
+
 ## Requirements
 
 - **Claude Code CLI** — installed and configured ([installation guide](https://docs.anthropic.com/en/docs/claude-code))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/skills-feature-adr",
-  "version": "1.3.10",
+  "version": "1.3.11",
   "description": "Adaptive Feature Development skill pack for Claude Code — 11-step pipeline with Complexity Router (S/M/L/XL), ADR-driven architecture, 15 agentic-qe skills, multi-agent fleet QE. Supports --full-qe, --full-qe-extended, --with-learning, and --knowledge-extractor modes.",
   "bin": {
     "skills-feature-adr": "./bin/cli.js"