ai-rulez 4.18.0 → 4.20.0

package/README.md

@@ -35,6 +35,8 @@ Write your rules, context, skills, agents, and commands once in `.ai-rulez/`. Ru
 npx ai-rulez@latest init && npx ai-rulez@latest generate
 ```
 
+Prefer the project-level [`.config/` convention](https://github.com/pi0/config-dir)? `ai-rulez` auto-discovers `.config/ai-rulez/` as well, and `ai-rulez init --config-dir .config/ai-rulez` scaffolds it.
+
 ai-rulez generates correct, tool-native output for **14 platforms**: Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Continue.dev, Codex, OpenCode, Hermes, Amp, Junie, Antigravity, and Xum. Each preset respects the target tool's conventions — proper frontmatter, directory structure, file extensions, agent formats.
 
 For a tool that isn't built in, a custom preset can point at a declarative **provider spec** (`provider = ".ai-rulez/providers/my-tool.toml"`) and get the same full feature set as a built-in — root instructions file, skills/agents/commands, per-agent frontmatter, and MCP sidecars. See [Custom Presets](docs/configuration.md#provider-backed-presets-full-parity).
@@ -239,6 +241,13 @@ command = "npx"
 args = ["-y", "ai-rulez@latest", "mcp"]
 ```
 
+Or let `generate` add it for you. With `[mcp] self_server = true` the entry is merged into the project `.mcp.json`, pinned to the running ai-rulez version, without touching hand-authored servers or `.claude/settings.json`:
+
+```toml
+[mcp]
+self_server = true
+```
+
 ## Installation
 
 No install needed — `npx ai-rulez@latest <command>` works out of the box. Pick a permanent option below:
@@ -307,7 +316,7 @@ Add to `.pre-commit-config.yaml`:
 ```yaml
 repos:
   - repo: https://github.com/Goldziher/ai-rulez
-    rev: v4.18.0
+    rev: v4.20.0
     hooks:
       - id: ai-rulez-recursive # generate outputs across the repo
       - id: ai-rulez-validate # dry-run validation
@@ -328,7 +337,7 @@ repository needs. This requires AI-Rulez 4.9.0+ and Poly 0.14.0+:
 [[hooks.sources]]
 id = "ai-rulez"
 git = "https://github.com/Goldziher/ai-rulez.git"
-revision = "v4.18.0"
+revision = "v4.20.0"
 hooks = ["ai-rulez-recursive", "ai-rulez-plugin-verify"]
 ```
 
@@ -362,6 +371,9 @@ pre-commit:
       run: ai-rulez generate --recursive
 ```
 
+In a monorepo, `ai-rulez generate --recursive` and `ai-rulez validate --recursive` (`-r`) process every nested
+`.ai-rulez/` root, report all failures, and exit non-zero if any root failed.
+
 Or run `ai-rulez init --setup-hooks` while initializing a repo to wire hooks in automatically.
 </details>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-rulez",
-  "version": "4.18.0",
+  "version": "4.20.0",
   "description": "Complete AI development workflow for 14 AI coding tools. Ships with builtin rules, agents, and conventions. Generate native configs for Claude, Cursor, Copilot, Windsurf, Gemini, Codex and more from a single source.",
   "keywords": [
     "agents",