@leing2021/super-pi 0.18.0 → 0.18.2

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/extensions/ce-core/index.ts

@@ -124,7 +124,10 @@ const parallelSubagentTaskSchema = Type.Object({
 })
 
 const parallelSubagentParams = Type.Object({
-  tasks: Type.Array(parallelSubagentTaskSchema, { description: "Array of independent tasks to run concurrently" }),
+  tasks: Type.Union([
+    Type.Array(parallelSubagentTaskSchema),
+    Type.String({ description: "JSON stringified array of tasks" }),
+  ], { description: "Array of independent tasks to run concurrently (can be a JSON string)" }),
   inheritSkills: Type.Optional(Type.Boolean({ description: "Whether subagents should inherit skills. Default: false" })),
 })
 
@@ -396,12 +399,24 @@ export default function ceCoreExtension(pi: ExtensionAPI) {
   pi.registerTool({
     name: parallelSubagent.name,
     label: "Parallel Subagent",
-    description: "Run multiple skill-based subagent tasks concurrently.",
+    description: "Run multiple skill-based subagent tasks concurrently. IMPORTANT: Provide 'tasks' as a clean JSON array object. If the environment forces a string, provide a valid JSON array string.",
     parameters: parallelSubagentParams,
     async execute(_toolCallId, params, signal) {
+      let tasks: any[]
+      if (typeof params.tasks === "string") {
+        try {
+          const cleaned = params.tasks.replace(/^```json\s*|```$/g, "").trim()
+          tasks = JSON.parse(cleaned)
+        } catch (e) {
+          throw new Error(`Failed to parse tasks string as JSON: ${e instanceof Error ? e.message : String(e)}`)
+        }
+      } else {
+        tasks = params.tasks
+      }
+
       const result = await parallelSubagent.execute(
         {
-          tasks: params.tasks,
+          tasks,
           inheritSkills: params.inheritSkills,
         },
         createSubagentRunner(pi, signal),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leing2021/super-pi",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "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