Merge pull request #58 from arvoreeducacao/ricardo-/-pi-orchestrator-neutral-agents-path

fix(pi): orchestrator prompt points to ./agents, not .kiro/agents

Author: ricardoraposo

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub-core",
-  "version": "0.23.2",
+  "version": "0.23.3",
   "description": "Core config loader, types, and prompt builders for hub workspaces",
   "main": "dist/index.js",
   "type": "module",

packages/core/src/index.ts

@@ -60,6 +60,7 @@ export {
   buildKiroPipelineSection,
   buildOpenCodePipelineSection,
   buildKiroOrchestratorRule,
+  buildOrchestratorPrompt,
   buildOrchestratorRule,
   buildOpenCodeOrchestratorRule,
   buildSkillsSection,

packages/core/src/prompt-builders.ts

@@ -1235,21 +1235,26 @@ If any validation agent leaves comments requiring fixes, call the relevant codin
   return parts.join("\n");
 }
 
-export function buildKiroOrchestratorRule(config: HubConfig): string {
+export function buildOrchestratorPrompt(
+  config: HubConfig,
+  options: { agentsDir?: string; assistantName?: string } = {},
+): string {
   const taskFolder = config.workflow?.task_folder || "./tasks/<TASK_ID>/";
   const steps = config.workflow?.pipeline || [];
   const prompt = config.workflow?.prompt;
   const enforce = config.workflow?.enforce_workflow ?? false;
+  const agentsDir = options.agentsDir || "./agents";
+  const assistantName = options.assistantName || "the agent";
 
   const sections: string[] = [];
 
   sections.push(`# Orchestrator
 
 ## Your Main Responsibility
 
-You are the development orchestrator. Your job is to ensure that any feature or task requested by the user is completed end-to-end by following a structured pipeline. You delegate specialized work to subagents defined in \`.kiro/agents/\`.
+You are the development orchestrator. Your job is to ensure that any feature or task requested by the user is completed end-to-end by following a structured pipeline. You delegate specialized work to subagents defined in \`${agentsDir}\`.
 
-> **Note:** This workspace has custom subagents in \`.kiro/agents/\`. Each pipeline step delegates to the appropriate subagent. Use \`/agent-name\` or instruct Kiro to "use the X subagent" to invoke them.`);
+> **Note:** This workspace has custom subagents in \`${agentsDir}\`. Each pipeline step delegates to the appropriate subagent. Use \`/agent-name\` or instruct ${assistantName} to "use the X subagent" to invoke them.`);
 
   if (enforce) {
     sections.push(`
@@ -1377,6 +1382,13 @@ For bug reports or unexpected behavior, follow the debugging process from the \`
   return sections.join("\n");
 }
 
+export function buildKiroOrchestratorRule(config: HubConfig): string {
+  return buildOrchestratorPrompt(config, {
+    agentsDir: ".kiro/agents/",
+    assistantName: "Kiro",
+  });
+}
+
 export function buildOrchestratorRule(config: HubConfig): string {
   const taskFolder = config.workflow?.task_folder || "./tasks/<TASK_ID>/";
   const steps = config.workflow?.pipeline || [];

packages/pi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arvoretech/hub-pi",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Pi runtime package for hub.yaml workspaces — interprets config at runtime with no static generation",
   "type": "module",
   "keywords": [

packages/pi/src/extensions/hub-runtime.ts

@@ -4,7 +4,7 @@ import { join, resolve } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import {
   loadHubConfig,
-  buildKiroOrchestratorRule,
+  buildOrchestratorPrompt,
   buildSkillsSection,
   stripFrontMatter,
   type HubConfig,
@@ -58,7 +58,10 @@ export function hubRuntime(pi: ExtensionAPI) {
       return;
     }
 
-    const orchestratorRule = buildKiroOrchestratorRule(config);
+    const orchestratorRule = buildOrchestratorPrompt(config, {
+      agentsDir: "./agents",
+      assistantName: "the agent",
+    });
     const skillsSection = await buildSkillsSection(hubDir, config);
 
     const sections: string[] = [orchestratorRule];