perstack 0.0.130 → 0.0.131

package/dist/bin/cli.js

@@ -1172,6 +1172,51 @@ function printPerstackSchema() {
 	sections.push("- Delegates must be in-scope (same coordinator prefix)");
 	sections.push("- Delegates cannot delegate to their own coordinator");
 	sections.push("");
+	sections.push("## Example");
+	sections.push("");
+	sections.push("```toml");
+	sections.push("[experts.\"my-team\"]");
+	sections.push("version = \"1.0.0\"");
+	sections.push("defaultModelTier = \"high\"");
+	sections.push("description = \"Coordinates task execution and delegates to specialists\"");
+	sections.push("instruction = \"\"\"");
+	sections.push("Domain-specific constraints and coordination rules here.");
+	sections.push("\"\"\"");
+	sections.push("delegates = [\"@my-team/build\", \"@my-team/verify\"]");
+	sections.push("");
+	sections.push("[experts.\"my-team\".skills.\"@perstack/base\"]");
+	sections.push("type = \"mcpStdioSkill\"");
+	sections.push("command = \"npx\"");
+	sections.push("packageName = \"@perstack/base\"");
+	sections.push("pick = [\"readTextFile\", \"exec\", \"attemptCompletion\"]");
+	sections.push("");
+	sections.push("[experts.\"@my-team/build\"]");
+	sections.push("version = \"1.0.0\"");
+	sections.push("defaultModelTier = \"middle\"");
+	sections.push("description = \"Implements the core deliverable\"");
+	sections.push("instruction = \"\"\"");
+	sections.push("Domain constraints for this specialist.");
+	sections.push("\"\"\"");
+	sections.push("");
+	sections.push("[experts.\"@my-team/build\".skills.\"@perstack/base\"]");
+	sections.push("type = \"mcpStdioSkill\"");
+	sections.push("command = \"npx\"");
+	sections.push("packageName = \"@perstack/base\"");
+	sections.push("pick = [\"readTextFile\", \"writeTextFile\", \"editTextFile\", \"exec\", \"todo\", \"attemptCompletion\"]");
+	sections.push("```");
+	sections.push("");
+	sections.push("## Best Practices");
+	sections.push("");
+	sections.push("- Always set version, defaultModelTier, and description on every expert");
+	sections.push("- Always set an explicit pick list — omitting it grants ALL tools");
+	sections.push("- Instructions should contain only domain constraints the LLM cannot derive on its own");
+	sections.push("- Do not put implementation procedures, file paths, or data schemas in instructions");
+	sections.push("- Shorter instructions outperform longer ones — every line must earn its place");
+	sections.push("- Delegate names should describe function, not persona (/build, /verify, not /builder)");
+	sections.push("- Coordinators should have minimal pick lists (readTextFile, exec, attemptCompletion)");
+	sections.push("- Leaf experts doing file I/O need: readTextFile, writeTextFile, editTextFile, exec, todo, attemptCompletion");
+	sections.push("- Experts managing delegation need: addDelegateFromConfig, addDelegate, removeDelegate");
+	sections.push("");
 	return sections.join("\n");
 }
 //#endregion
@@ -21225,7 +21270,7 @@ async function expertVersionsHandler(scopeName, options) {
 }
 //#endregion
 //#region ../../packages/runtime/package.json
-var version$1 = "0.0.140";
+var version$1 = "0.0.141";
 //#endregion
 //#region ../../packages/runtime/src/helpers/usage.ts
 function createEmptyUsage() {
@@ -92649,8 +92694,8 @@ function getCoordinatorMetaInstruction() {
     6. Aggregate results and clean up the workspace.
 
     Delegation guidelines:
-    - Be specific: include context, file paths, constraints, and expected output format. No vague delegations.
-    - Break large subtasks into focused units rather than overloading a single delegate.
+    - Be specific: include context, constraints, and expected output format. No vague delegations.
+    - A single delegate can handle a broad task if the role is straightforward. Only split into multiple delegates when responsibilities are genuinely distinct — unnecessary subdivision adds overhead without improving quality.
     - If no suitable delegate exists, use createExpert to create one, then addDelegate to register it.
 
     Workspace cleanup:
@@ -124645,7 +124690,7 @@ async function startHandler(expertKey, query, options, handlerOptions) {
 //#endregion
 //#region package.json
 var name = "perstack";
-var version = "0.0.130";
+var version = "0.0.131";
 var description = "PerStack CLI";
 //#endregion
 //#region bin/cli.ts