@compilr-dev/sdk 0.7.24 → 0.7.25

package/dist/system-prompt/modules.js

@@ -243,21 +243,31 @@ Project documents (drafts, outlines, analyses, plans) are stored in the **databa
 export const DELEGATION_MODULE = {
     id: 'delegation',
     name: 'Token Efficiency & Delegation',
-    estimatedTokens: 200,
-    content: `## Token Efficiency & Delegation
-
-Use the **task** tool (sub-agent) for:
-- **File exploration**: "find files", "what's in this directory", "explore codebase"
-- **Code search**: "where is X defined", "find usages of Y"
-- **Analysis**: "analyze module", "understand architecture", "review code"
-- **Multi-file operations**: Tasks touching 5+ files
-
-### Rules
-1. Exploration/search questions → task(explore)
-2. Code review → task(code-review)
-3. Planning → task(plan)
-4. Simple answers (no file access) → respond directly
-5. Code edits → do it yourself (never delegate edits)`,
+    estimatedTokens: 350,
+    content: `## CRITICAL: Subagent Delegation
+
+The **task** tool spawns a subagent that works in isolated context and returns a summary. This is your primary tool for exploration, search, and analysis.
+
+**Why this matters:** Reading 5 files directly costs ~25,000 tokens in YOUR context. Delegating to a subagent costs ~200 tokens (tool call + summary). The subagent sees the full content but only the summary enters your history. This 100x reduction keeps your context clean for the actual work.
+
+### ALWAYS delegate these:
+- **File exploration**: "find files", "what's in this directory", "explore the codebase" → \`task(explore)\`
+- **Code search**: "where is X defined", "find usages of Y", "how does Z work" → \`task(explore)\`
+- **Analysis**: "analyze this module", "understand the architecture", "review this code" → \`task(code-review)\`
+- **Multi-file reads**: Any task requiring 3+ file reads → \`task(explore)\`
+- **Research**: web searches, documentation lookups → \`task(explore)\`
+
+### NEVER delegate these:
+- **Code edits**: Writing/editing files — do it yourself
+- **Simple answers**: Questions you can answer from memory
+- **User interaction**: Asking the user questions
+- **Single file reads**: Reading 1-2 specific files the user pointed to
+
+### Examples
+- User: "What files implement the auth system?" → \`task({ type: "explore", message: "Find all files related to authentication..." })\`
+- User: "How does the payment module work?" → \`task({ type: "explore", message: "Analyze the payment module..." })\`
+- User: "Fix the bug in login.tsx" → Read login.tsx yourself, then edit it
+- User: "Add a logout button" → Read the relevant file yourself, then edit it`,
 };
 /**
  * Git safety module - only if hasGit=true
@@ -326,9 +336,9 @@ export const IMPORTANT_RULES_MODULE = {
 4. Use todo_write for multi-step tasks (3+ steps)
 5. Don't over-engineer - implement exactly what was asked
 6. Check for security issues - fix insecure code immediately
-7. **DELEGATE exploration to sub-agents** - use task(explore) for file searches, code navigation, and analysis. NEVER accumulate exploration results in your own context.
-8. Call suggest tool after completing tasks (don't write "suggest:" as text)
-9. When user asks "what files...", "where is...", "find..." - ALWAYS use task(explore), not direct tool calls`,
+7. **DELEGATE exploration to sub-agents** - use task(explore) for searches, analysis, and multi-file reads. Each file you read directly costs thousands of tokens in YOUR context. A subagent reads files in isolation and returns a compact summary.
+8. When user asks "what files...", "where is...", "find...", "how does X work..." → ALWAYS use task(explore), never read files directly to answer
+9. Call suggest tool after completing tasks (don't write "suggest:" as text)`,
 };
 /**
  * Environment module - always included

package/dist/team/tool-config.js

@@ -431,6 +431,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'git_read',
         'project',
@@ -444,6 +445,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'project',
         'search',
@@ -460,6 +462,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'git_read',
         'git_write',
@@ -476,6 +479,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'git_read',
         'project',
@@ -490,6 +494,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'git_read',
         'project',
@@ -511,6 +516,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'git_read',
         'project',
@@ -532,6 +538,7 @@ export const TOOL_PROFILES = {
         'interaction',
         'handoff',
         'guide',
+        'subagents',
         'meta',
         'project',
         'backlog_read',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.7.24",
+  "version": "0.7.25",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",