@roulabs/mx 1.10.1 → 1.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roulabs/mx",
-  "version": "1.10.1",
+  "version": "1.11.0",
   "description": "mx — run several features in parallel across shared repos using git worktrees",
   "type": "module",
   "bin": {

package/templates/CLAUDE.md

@@ -20,10 +20,22 @@ Every read command takes `--porcelain` for stable JSON; parse that instead of sc
 ## What this runtime is for
 
 `mx/` is where **feature work** happens. Sessions launched here implement a feature inside a
-`works/<feature>/` folder. mx *itself* — this template, the `mx` CLI — is maintained in a separate
-**mx source checkout** (the `github.com/roulabs/mx` repo), outside this tree. If you were opened
-here to change how mx works, you're in the wrong place: switch to that repo. Don't edit `repos/`,
-`works/`, or the runtime files from here.
+`works/<feature>/` folder. mx *itself* — this template, the `mx` CLI — is maintained in the
+`github.com/roulabs/mx` source repo. There are two valid setups for that source:
+
+1. **It lives elsewhere** (the default): if you were opened here to change how mx works, you're in
+   the wrong place — switch to that repo. Don't edit `repos/`, `works/`, or the runtime files from
+   here.
+
+2. **It's hosted as a work in this runtime** (self-hosting / dogfooding): someone has run
+   `mx repo add git@github.com:roulabs/mx.git` and created one or more `works/<feature>/mx/`
+   worktrees for parallel mx development. In that case, working inside one of those worktrees IS
+   valid — follow that worktree's own `CLAUDE.md` for the developer rules. The runtime rule that
+   still applies here: **never run the worktree's locally-built mx CLI against this runtime**.
+   Locally-built mx (`pnpm mx`, `node npm/bin/mx.js`) must be pointed at a sandbox (`$PWD/.mx` or
+   `/tmp/...`) for any testing — otherwise it may re-stamp this `CLAUDE.md` with a work-in-progress
+   template. The published `mx` on `$PATH` (from `npm i -g @roulabs/mx`) is the safe one against
+   this runtime.
 
 ## Layout