@leing2021/super-pi 0.18.0 → 0.18.1

package/README.md

@@ -267,7 +267,14 @@ No rules are loaded when you brainstorm, check status, or do non-code tasks. Zer
 
 #### Customizing rules for your project
 
-Rules are plain Markdown files in the `rules/` directory. Edit them freely:
+Two rule sources exist, with project-level taking priority:
+
+| Source | Location | Survives `pi update`? |
+|--------|----------|----------------------|
+| **Project-level** | `{your-project-root}/rules/` | ✅ Yes |
+| Package-level | Inside `node_modules/@leing2021/super-pi/rules/` | ❌ No |
+
+To customize, create a `rules/` directory in your project root. `10-rules` checks it first — if a file exists there, it overrides the package default for that topic.
 
 **Add a language** — create a new directory with the 5 standard topics:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leing2021/super-pi",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "private": false,
   "type": "module",
   "description": "Pi-native Compound Engineering package for iterative development workflows",

package/skills/10-rules/SKILL.md

@@ -1,11 +1,16 @@
 ---
 name: 10-rules
-description: "Progressively load project coding rules on demand. Auto-triggered by plan, work, and review skills."
+description: "Progressively load project coding rules on demand. Auto-triggered by plan, work, and review skills, or run manually with /skill:10-rules."
 ---
 
 # Rules
 
-Project rules live under `rules/` in the super-pi package root (resolved as the skill directory's `../../rules/`).
+Rules are loaded from two locations with clear priority:
+
+1. **Project-level** `{repo-root}/rules/` — if it exists, takes priority. Users maintain this themselves; survives `pi update`.
+2. **Package-level** `rules/` in the super-pi package — built-in defaults, used when no project-level override exists.
+
+Detection: check `{repo-root}/rules/` first. If a file exists at the project level for the topic being loaded, use it. Otherwise fall back to the package-level copy.
 
 ## Core rule