Q41: one first-hire rule, and leaders get guidance that fits their rank

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/unit/agent-instructions.test.ts

@@ -11,6 +11,9 @@ import { ConnectorGrantsService } from "../../src/main/services/composio/connect
 import { TaskExecutionService } from "../../src/main/services/task-execution-service";
 import { RISK_LEVEL, TASK_PRIORITY, TASK_STATUS } from "../../src/shared/domain";
 import { buildAgentInstructions, type TaskExecutionAgentRow } from "../../src/main/services/task-prompts";
+import { AGENT_TOOLS } from "../../src/main/services/agent-tools";
+import { goalKickoffDescription } from "../../src/main/services/goal-kickoff";
+import { CEO_FIRST_HIRES } from "../../src/main/services/org-building";
 
 function agentRow(overrides: Partial<TaskExecutionAgentRow>): TaskExecutionAgentRow {
   return {
@@ -28,6 +31,24 @@ function agentRow(overrides: Partial<TaskExecutionAgentRow>): TaskExecutionAgent
 }
 
 describe("agent instructions", () => {
+  test("first-hire guidance is one rule everywhere, and new leaders get a leader's voice", () => {
+    const ceo = buildAgentInstructions({ agent: agentRow({ name: "CEO", role: "CEO", role_level: "c_suite", manager_agent_id: null }), companyName: "O", isCeo: true, hasReports: false, connectorNames: [], language: "en" });
+    const hireTool = AGENT_TOOLS.find((tool) => tool.name === "hire_agent");
+    for (const text of [ceo, goalKickoffDescription("O", "Ship", "Ship it.", { roleLevel: "c_suite", hasReports: false }), hireTool?.description ?? ""]) {
+      expect(text).toContain(CEO_FIRST_HIRES);
+    }
+    const voice = (role_level: string, hasReports: boolean) =>
+      buildAgentInstructions({ agent: agentRow({ role_level }), companyName: "O", isCeo: false, hasReports, connectorNames: [], language: "en" });
+    expect(voice("director", false)).toContain('Your department has no one in it yet: hire the managers (hire_agent, seniority "lead") and staff your department needs');
+    expect(voice("lead", false)).toContain("Your team has no one in it yet: hire the staff your team needs (hire_agent)");
+    expect(voice("lead", false)).toContain("You lead a team.");
+    expect(voice("lead", false)).not.toContain('managers (seniority "lead")');
+    expect(voice("director", true)).toContain("You lead a department.");
+    expect(voice("director", true)).not.toContain("no one in it yet");
+    expect(voice("staff", false)).toContain("You own your craft.");
+    expect(voice("staff", false)).not.toContain("You lead");
+  });
+
   test("the CEO is briefed on its grant authority over connectors and skills", () => {
     const text = buildAgentInstructions({
       agent: agentRow({ name: "CEO", role: "CEO", role_level: "c_suite", manager_agent_id: null }),
@@ -157,4 +178,53 @@ describe("agent instruction wiring", () => {
     await execution.runTask({ orgId, taskId });
     expect(capturedInstructions).toContain("公司的工作语言是简体中文");
   });
+
+  test("a new department head's task prompt tells them to staff their department, not to work as an IC", async () => {
+    const connection = new DatabaseConnection(join(tmpdir(), `ac-instr-${randomUUID()}.db`));
+    const organization = new OrganizationService(connection.db);
+    let capturedPrompt = "";
+    const fakeToolTurn = async (input: ProviderToolTurnInput): Promise<AgentTurnResult> => {
+      const first = input.messages[0];
+      if (first?.role !== "user") throw new Error("The run must open with the task prompt.");
+      capturedPrompt = first.text;
+      return { text: "done", toolCalls: [], rawResponseJson: JSON.stringify({ id: "resp-1" }) };
+    };
+    const providers = new ProviderService(connection.db, providerAdapters, testVault, undefined, fakeToolTurn);
+    const execution = new TaskExecutionService(connection.db, providers);
+    let orgId = "";
+    let taskId = "";
+    connection.transaction(() => {
+      orgId = organization.createOrganization({ organizationName: "OrbitOps", employeeName: "Yang", mission: "m", goal: "g" });
+      const providerId = (connection.db.prepare("select id from providers where org_id = ? and provider_key = 'openai'").get(orgId) as { id: string }).id;
+      providers.saveCredential({ orgId, providerId, secret: "sk-test", model: "gpt-5.4" });
+      const ceoId = organization.createAgent({
+        orgId, name: "CEO", role: "CEO", department: "Executive",
+        modelProviderId: providerId, modelId: "gpt-5.4", budgetCents: 1000, managerAgentId: null, roleLevel: "c_suite",
+      });
+      const ctoId = organization.createAgent({
+        orgId, name: "Cora", role: "CTO", department: "Engineering",
+        modelProviderId: providerId, modelId: "gpt-5.4", budgetCents: 1000, managerAgentId: ceoId, roleLevel: "director",
+      });
+      taskId = organization.createTask({
+        orgId, title: "Build engineering", description: "Own the platform.", status: TASK_STATUS.IN_PROGRESS,
+        assigneeAgentId: ctoId, risk: RISK_LEVEL.LOW, projectId: null, goalId: null,
+        workspaceId: null, priority: TASK_PRIORITY.NORMAL, requiresFilesystem: false,
+      });
+    });
+
+    await execution.runTask({ orgId, taskId });
+
+    // A goal owned by the CTO kicks off with department guidance, never the CEO's officer rule.
+    const ctoId = (connection.db.prepare("select id from agents where org_id = ? and name = 'Cora'").get(orgId) as { id: string }).id;
+    connection.transaction(() => organization.createGoal({ orgId, title: "Platform", description: "Stand up the platform.", ownerAgentId: ctoId }));
+    const kickoff = connection.db.prepare("select description from tasks where org_id = ? and title = 'Operationalize goal: Platform'").get(orgId) as { description: string };
+    expect(kickoff.description).toContain('Treat this goal as your objective. Build the team that can deliver it: hire the managers (hire_agent, seniority "lead") and staff your department needs');
+    expect(kickoff.description).not.toContain("chief officers");
+
+    expect(capturedPrompt).toContain('Your team is currently empty. First hire the managers (hire_agent, seniority "lead") and staff your department needs');
+    expect(capturedPrompt).toContain("Tell your manager the plan in a direct message.");
+    expect(capturedPrompt).not.toContain("#general");
+    expect(capturedPrompt).not.toContain("Then do the work: write real output");
+    connection.close();
+  });
 });