feat(agent-coder): extract coder director as a versioned package

Author: TheGreatAxios

agents/coder/README.md

@@ -0,0 +1,37 @@
+# @corbits/code-agent-coder
+
+## What this is
+
+Ready `@corbits/code-agent-coder` agent + independently importable components:
+`agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config`. Coder is
+the implementation specialist: minimal safe diffs, root-cause fixes at the proper
+layer, zero unnecessary abstractions, tests landed with changes, repo check gate.
+
+## Consume (runLocal)
+
+```ts
+import { agent } from "@corbits/code-agent-coder";
+const run = runLocal(defining(agent), env);
+```
+
+## Consume (deploy runWorkflow / hub / sidecar)
+
+Hand the same `AgentDefinition` to a workflow — the package never exports a
+workflow itself.
+
+## Remix components
+
+```ts
+import { director, tools, systemPrompt, config } from "@corbits/code-agent-coder";
+defineAgent({ director, ... }); // or swap tools / systemPrompt / config
+```
+
+Each of `agent`, `defineAgent`, `director`, `tools`, `systemPrompt`, `config` is a
+named, independently importable part.
+
+## Single authority
+
+`prompt.ts` `systemPrompt.build()` is byte-stable (the raw card, no formatting).
+`toolset.ts` `tools` literal equals the `BUILD_TOOLS` surface constant in
+`src/agent/directors/tool-sets.ts`; drift is enforced by the in-tree drift-guard
+`src/agent/directors/coder/package.test.ts`.

agents/coder/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@corbits/code-agent-coder",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  }
+}

agents/coder/src/agent.ts

@@ -0,0 +1,17 @@
+import {
+  defineAgent as coreDefineAgent,
+  type AgentDefinition,
+} from "@intx/agent";
+import { systemPrompt } from "./prompt.js";
+
+export const agent: AgentDefinition = defineAgent();
+
+export function defineAgent(): AgentDefinition {
+  return coreDefineAgent({
+    id: "coder",
+    systemPrompt: systemPrompt.build(),
+    tools: [], // tool mounting is consumer/app-side; surface enforced by drift-guard
+    capabilities: [],
+    inference: { sources: [] },
+  });
+}

agents/coder/src/config.ts

@@ -0,0 +1,9 @@
+export const config = {
+  spawn: { maySpawn: false },
+  tier: "leaf",
+  modelRole: "implement",
+} as const satisfies {
+  spawn: { maySpawn: boolean; allowlist?: readonly string[] };
+  tier: string;
+  modelRole: string;
+};

agents/coder/src/director.ts

@@ -0,0 +1,23 @@
+import { tools } from "./toolset.js";
+import { systemPrompt } from "./prompt.js";
+import { config } from "./config.js";
+
+export const director = {
+  id: "coder",
+  primaryIntent:
+    "Implement the brief in product code — minimal safe diffs, root-cause fixes, tests with change",
+  outOfLane: [
+    "inventing speculative architecture or unnecessary abstractions",
+    "expanding scope beyond the brief or chasing symptoms with workarounds",
+    "pure exploration maps without code",
+    "review-only verdicts",
+    "orchestrating or spawning other agents",
+  ],
+  description:
+    "Implementation specialist — minimal safe diffs, root-cause fixes, tests",
+  systemPrompt: systemPrompt.build(),
+  tools: { allow: [...tools] },
+  spawn: config.spawn,
+  tier: config.tier,
+  modelRole: config.modelRole,
+} as const;

agents/coder/src/index.ts

@@ -0,0 +1,5 @@
+export { agent, defineAgent } from "./agent.js";
+export { director } from "./director.js";
+export { tools } from "./toolset.js";
+export { systemPrompt } from "./prompt.js";
+export { config } from "./config.js";

src/agent/directors/coder/package.ts agents/coder/src/prompt.tssrc/agent/directors/coder/package.ts renamed to agents/coder/src/prompt.ts

@@ -1,32 +1,10 @@
-import type { DirectorPackage } from "../types.js";
-import { BUILD_TOOLS } from "../tool-sets.js";
+// Coder raw director card. Byte-stable, single authority — the app formats
+// the identity header via formatDirectorSystemPrompt.
 
-/**
- * Coder worker: implementation specialist.
- * Minimal safe diffs, root-cause fixes at the proper layer, zero unnecessary
- * abstractions, unit tests landed with changes, repo check gate.
- */
-export const coderPackage: DirectorPackage = {
-  id: "coder",
-  primaryIntent:
-    "Implement the brief in product code — minimal safe diffs, root-cause fixes, tests with change",
-  outOfLane: [
-    "inventing speculative architecture or unnecessary abstractions",
-    "expanding scope beyond the brief or chasing symptoms with workarounds",
-    "pure exploration maps without code",
-    "review-only verdicts",
-    "orchestrating or spawning other agents",
-  ],
-  description:
-    "Implementation specialist — minimal safe diffs, root-cause fixes, tests",
-  tools: { allow: BUILD_TOOLS },
-  spawn: { maySpawn: false },
-  tier: "leaf",
-  modelRole: "implement",
-  systemPrompt: `You are CoderDirector (Coder), a specialist in Corbits Code.
+const CARD = `You are CoderDirector (Coder), a specialist in Corbits Code.
 
 PRIMARY INTENT: implement the brief in product code. Edit, verify, report.
-You are the implement lane only — not Reviewer, not Explorer, not an orchestrator. Do not spawn specialists. Ship the product code and the tests that belong with this change; leave review, architecture judgment, and independent verification to the parent and peer specialists.
+You are a disciplined implementer worker (maySpawn: false) — not Reviewer, not Explorer, not an orchestrator. Ship the product code and the tests that belong with this change; leave review, architecture judgment, and independent verification to the parent and peer specialists.
 
 Discipline:
 1. Minimal safe diff: prefer the shortest clear change. Reuse existing helpers, patterns, and utilities; avoid drive-by refactors or gratuitous rewrites. Prune scope actively to what the brief asks for.
@@ -40,5 +18,10 @@ Ship the brief:
 3. Run the repo gate (\`bun run check\` or the gate specified by AGENTS.md / brief). Report exact verification commands, outcomes, and exit codes. Do not shortcut verification or declare success without command evidence. If pre-existing failures exist, isolate them under Blockers.
 4. Report envelope: use Summary / Findings / Blockers / Paths. In Findings, map each success_criteria item to pass, fail, or blocked with verification evidence. Paths must list every file touched. Do not commit unless the brief explicitly demands it.
 
-OUT OF LANE: pure exploration maps, speculative abstractions, review-only verdicts, mechanical command lists without implementing, fleet orchestration or spawning.`,
+OUT OF LANE: pure exploration maps, speculative abstractions, review-only verdicts, mechanical command lists without implementing, fleet orchestration or spawning.`;
+
+// Byte-stable (see prompt authority test).
+export const systemPrompt = {
+  theme: "coder",
+  build: (): string => CARD,
 };

agents/coder/src/toolset.ts

@@ -0,0 +1,17 @@
+// BUILD_TOOLS literal; drift-guarded against src/agent/directors/tool-sets.ts.
+
+export const tools = [
+  "read_file",
+  "grep",
+  "search_files",
+  "list_dir",
+  "lsp",
+  "run_shell",
+  "web_fetch",
+  "web_search",
+  "skill_search",
+  "use_skill",
+  "write_file",
+  "edit_file",
+  "delete_file",
+] as const;

agents/coder/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts"]
+}