@pify/subagent 0.2.0 → 0.3.0

package/README.md

@@ -9,7 +9,7 @@ Part of the [Pify suite](https://github.com/pifydev). Install with [`pify instal
 - **`agent_run`** — delegate a task to a child pi session (in-process, isolated in-memory transcript). Foreground blocks and returns the child's report; `background: true` returns an id immediately (up to 4 concurrent) with a live widget showing spinners, token counts, and elapsed time.
 - **`agent_result`** — collect a background run's report; completed results survive `/reload`.
 - **Three builtin agent types**: `reviewer` (read-only, thinking high — findings with evidence), `scout` (read-only exploration — paths + excerpts), `worker` (full tools — scoped implementation, verifies before finishing).
-- **Custom agent types**, Claude Code-compatible: drop `.pi/agents/<name>.md` (project) or `<agentDir>/agents/<name>.md` (global) with frontmatter — `description`, `tools`, `model` (`provider/id`), `thinking`, `max_turns` — and a system-prompt body. Project overrides global overrides builtin; a def without `tools:` defaults to read-only.
+- **Custom agent types**, Claude Code-compatible: drop `.pi/agents/<name>.md` (project) or `<agentDir>/agents/<name>.md` (global) with frontmatter — `description`, `tools`, `model` (`provider/id`), `thinking`, `max_turns`, and (v0.3) `system_prompt_mode` / `inherit_skills` — and a system-prompt body. Project overrides global overrides builtin; a def without `tools:` defaults to read-only.
 - **Guardrails**: tool allowlists are enforced at session creation; children are aborted at their turn cap; children cannot spawn children.
 - `/agents` lists types and this session's runs.
 
@@ -26,12 +26,16 @@ tools: read, grep, find, ls
 model: anthropic/claude-haiku-4-5-20251001
 thinking: low
 max_turns: 15
+system_prompt_mode: replace
+inherit_skills: false
 ---
 
 You are a security auditor. Scan for hardcoded secrets, injection flaws,
 and overly broad permissions. Report file:line with remediation notes.
 ```
 
+`system_prompt_mode: replace` (default `append`) drops the session's own system prompt, so a specialist is not also told to be this project's coding assistant. `inherit_skills: false` (default `true`) keeps a narrow child out of the project's whole skill surface. Both are unset in the builtins, which behave exactly as before.
+
 ## License
 
 MIT © [Pify maintainers](https://github.com/pifydev)

package/extensions/subagent.ts

@@ -129,9 +129,16 @@ export default function subagent(pi: ExtensionAPI) {
           noExtensions: true,
           noPromptTemplates: true,
           noThemes: true,
-          systemPrompt: promptOptions.customPrompt,
+          // system_prompt_mode: replace drops the parent's prompt so a
+          // specialist is not also told to be this project's coding
+          // assistant; inherit_skills: false keeps a focused child out of
+          // the project's whole skill surface.
+          noSkills: !def.inheritSkills,
+          ...(def.systemPromptMode === "replace" ? {} : { systemPrompt: promptOptions.customPrompt }),
           appendSystemPrompt: [
-            ...(promptOptions.appendSystemPrompt ? [promptOptions.appendSystemPrompt] : []),
+            ...(def.systemPromptMode === "replace" || !promptOptions.appendSystemPrompt
+              ? []
+              : [promptOptions.appendSystemPrompt]),
             def.systemPrompt,
             CHILD_FRAMING,
           ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pify/subagent",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Spawn scoped subagents from within a pi session: agent_run/agent_result tools, Claude Code-compatible agent types, turn caps and tool allowlists",
   "keywords": [
     "pi-package",

package/src/frontmatter.ts

@@ -44,6 +44,9 @@ export function parseAgentFile(
       : DEFAULT_MAX_TURNS;
 
   const model = fields.get("model") || null;
+  const promptMode = fields.get("system_prompt_mode")?.toLowerCase();
+  const systemPromptMode = promptMode === "replace" ? "replace" : "append";
+  const inheritSkills = !isFalse(fields.get("inherit_skills"));
 
   return {
     name: name.toLowerCase(),
@@ -53,10 +56,18 @@ export function parseAgentFile(
     thinking,
     maxTurns,
     systemPrompt: match[2]!.trim(),
+    systemPromptMode,
+    inheritSkills,
     source,
   };
 }
 
+/** Frontmatter booleans, written the handful of ways people write them. */
+function isFalse(raw: string | undefined): boolean {
+  if (raw === undefined) return false;
+  return ["false", "no", "off", "0"].includes(raw.trim().toLowerCase());
+}
+
 /** Read-only default keeps a def missing `tools:` from mutating anything. */
 function parseTools(raw: string | undefined): ValidTool[] {
   if (!raw) return ["read", "grep", "find", "ls"];

package/src/types.ts

@@ -38,6 +38,14 @@ export interface AgentDef {
   maxTurns: number;
   /** Markdown body appended to the child's system prompt. */
   systemPrompt: string;
+  /**
+   * "append" (default) puts the body after the session's own system prompt;
+   * "replace" drops the parent's prompt so a specialist is not also told to
+   * be this project's coding assistant.
+   */
+  systemPromptMode: "append" | "replace";
+  /** Whether the child loads the project's skills (default true). */
+  inheritSkills: boolean;
   source: "builtin" | "global" | "project";
 }