agents-united 1.3.0 → 1.4.0

package/README.md

@@ -107,11 +107,11 @@ This model gives you:
 ---
 
 
-Agents United provides **22 curated bundles**, **45 specialized agents** (7 Lead Orchestrators + 38 Sub-Agents), **90 skills**, and **63 workflows** across 8 department domains:
+Agents United provides **24 curated bundles**, **46 specialized agents** (8 Orchestrators — 7 Lead + 1 Prime + 38 Sub-Agents), **90 skills**, and **63 workflows** across 8 department domains:
 
 | Department Domain | Essentials Base | Specialized Addon Bundles | Lead Orchestrator |
 | :--- | :--- | :--- | :--- |
-| **🌐 Universal Department** | `universal-skills` ⭐ | `full` (Universal Suite) | Multi-Agent Coordination |
+| **🌐 Universal Department** | `universal-skills` ⭐ | `universal-orchestration` (guided routing), `full` (Universal Suite) | `orchestrator-universal` (Prime) |
 | **🛠️ Software Engineering & Delivery** | `software-engineering` | `ai-ml-engineering`, `mobile-development`, `frontend-engineering`, `backend-distributed-systems`, `qa-automation`, `devops-engineering` | `orchestrator-engineering` |
 | **🏛️ System Architecture & SRE** | `system-architecture` | `sysops-sre` | `orchestrator-system-architecture` |
 | **🎨 Product Design & UI/UX** | `product-design` | `design-systems-ops`, `design-research-testing` | `orchestrator-design` |
@@ -128,7 +128,8 @@ Agents United provides **22 curated bundles**, **45 specialized agents** (7 Lead
 
 #### 🌐 Universal Autonomous Department
 - **Baseline**: `universal-skills` ⭐ *(Recommended Baseline — Socratic grilling, PRD generation, ADRs, session handoff)*
-- **Universal Suite**: `full` *(Complete enterprise suite containing all 22 bundles, 45 agents, 90 skills, 63 workflows)*
+- **Guided Routing (optional)**: `universal-orchestration` *(Prime Orchestrator front door — grills ambiguous requests, routes to the correct department Essentials bundle via its Domain Atlas, installs with consent, and hands off. An optional way to use Agents United without the full suite.)*
+- **Universal Suite**: `full` *(Complete enterprise suite containing all bundles, agents, skills, workflows)*
 
 #### 🛠️ Software Engineering & Delivery
 - **Lead Orchestrator**: `orchestrator-engineering`

package/dist/cli.js

@@ -2282,7 +2282,8 @@ var ClineLauncher = class _ClineLauncher {
       prompt,
       teamName: customTeamName,
       allowAddons,
-      headless
+      headless,
+      orchestrator
     } = options;
     const command = report.command || {
       executable: "cline",
@@ -2300,7 +2301,8 @@ var ClineLauncher = class _ClineLauncher {
     }
     const strategy = report.namedTeams ? "named-team" : "adaptive-session";
     const manifestRel = scope === "global" ? `~/.cline/agents-united/teams/${bundleName}.yaml` : `.cline/agents-united/teams/${bundleName}.yaml`;
-    const coordinatorCanonical = `.agents/agents/orchestrator-engineering.md`;
+    const coordinatorFile = (orchestrator || "orchestrator-engineering.md").replace(/\.md$/, "");
+    const coordinatorCanonical = `.agents/agents/${coordinatorFile}.md`;
     const addonPolicyText = allowAddons ? "Addon auto-installation is pre-authorized for this session." : `Before installing any recommended addon, explain the requirement to the user and request explicit confirmation to run: agents add <addon> -t cline ${scope === "global" ? "-g " : ""}-y.`;
     const taskText = prompt && prompt.trim().length > 0 ? `User task: ${prompt.trim()}` : "Please introduce your coordinator role to the user and ask for their first task.";
     const bootstrapPrompt = [
@@ -2716,6 +2718,10 @@ var BUNDLE_DISPLAY_NAMES = {
     title: "Digital Agency (TBA soon)",
     summary: "Full-service digital product agency with web dev, mobile, design, SEO, and growth marketing"
   },
+  "universal-orchestration": {
+    title: "Universal Orchestration",
+    summary: "Prime Orchestrator front door: routes to the correct department Essentials bundle and hands off"
+  },
   "universal-skills": {
     title: "Universal Meta-Skills",
     summary: "Domain-agnostic Socratic grilling, spec generation, handoff, and domain modeling"
@@ -2963,6 +2969,8 @@ cli.command("add [identifier]", "Add a bundle, agent, skill, or workflow to proj
         });
       }
       const sortedBundles = [...domainBundles].sort((a, b) => {
+        if (a.name === "universal-orchestration") return -1;
+        if (b.name === "universal-orchestration") return 1;
         if (a.name === "universal-skills") return -1;
         if (b.name === "universal-skills") return 1;
         if (!a.parentBundle && b.parentBundle) return -1;
@@ -2973,7 +2981,7 @@ cli.command("add [identifier]", "Add a bundle, agent, skill, or workflow to proj
         const isLast = idx === sortedBundles.length - 1;
         const branch = sortedBundles.length > 1 ? isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 " : "";
         const meta = BUNDLE_DISPLAY_NAMES[b.name];
-        const isEssentials = !b.parentBundle && b.name !== "full" && b.tier !== "organization" && b.name !== "universal-skills";
+        const isEssentials = !b.parentBundle && b.name !== "full" && b.tier !== "organization" && b.name !== "universal-skills" && b.name !== "universal-orchestration";
         const title = meta ? meta.title : b.name;
         let statusBadge = "";
         if (b.name === "universal-skills") statusBadge = pc.green(" \u2B50 [Recommended Baseline]");
@@ -3196,11 +3204,13 @@ ${renderProjections(result.projections)}` : ""),
           const probe = new ClineCapabilityProbe();
           const probeReport = await probe.probe();
           if (probeReport.installed) {
+            const targetBundleDef2 = await registry.getBundle(bundleName);
             const plan = launcher.planActivation({
               bundleName,
               workspace: process.cwd(),
               scope,
-              report: probeReport
+              report: probeReport,
+              orchestrator: targetBundleDef2?.orchestrator
             });
             await launcher.launch(plan);
           } else {
@@ -3221,11 +3231,13 @@ ${renderProjections(result.projections)}` : ""),
           const probe = new ClineCapabilityProbe();
           const probeReport = await probe.probe();
           if (probeReport.installed) {
+            const targetBundleDef2 = await registry.getBundle(bundleName);
             const plan = launcher.planActivation({
               bundleName,
               workspace: process.cwd(),
               scope,
-              report: probeReport
+              report: probeReport,
+              orchestrator: targetBundleDef2?.orchestrator
             });
             await launcher.launch(plan);
           } else {
@@ -3491,7 +3503,7 @@ function renderBundleDetailTree(bundle) {
     return lines2.join("\n");
   }
   const meta = BUNDLE_DISPLAY_NAMES[bundle.name];
-  const isEssentials = !bundle.parentBundle && bundle.name !== "full" && bundle.name !== "universal-skills" && bundle.tier !== "organization";
+  const isEssentials = !bundle.parentBundle && bundle.name !== "full" && bundle.name !== "universal-skills" && bundle.name !== "universal-orchestration" && bundle.tier !== "organization";
   const titleSuffix = isEssentials ? pc.cyan(" (Essentials Base)") : "";
   const parentTag = bundle.parentBundle ? pc.gray(` [inherits: ${bundle.parentBundle}]`) : "";
   const aliasesTag = bundle.aliases && bundle.aliases.length > 0 ? pc.gray(` [alias: ${bundle.aliases.join(", ")}]`) : "";
@@ -3621,7 +3633,7 @@ ${pc.bold(pc.magenta(header))} ${pc.dim(`(${items.length} bundle${items.length >
       const bBranch = isLastBundle ? "\u2514\u2500\u2500" : "\u251C\u2500\u2500";
       const subIndent = isLastBundle ? "    " : "\u2502   ";
       const meta = BUNDLE_DISPLAY_NAMES[b.name];
-      const isEssentials = !b.parentBundle && b.name !== "full" && b.name !== "universal-skills";
+      const isEssentials = !b.parentBundle && b.name !== "full" && b.name !== "universal-skills" && b.name !== "universal-orchestration";
       const titleSuffix = isEssentials ? pc.cyan(" (Essentials)") : "";
       const parentTag = b.parentBundle ? pc.gray(` [inherits: ${b.parentBundle}]`) : "";
       const aliasesTag = b.aliases && b.aliases.length > 0 ? pc.gray(` [alias: ${b.aliases.join(", ")}]`) : "";
@@ -3988,6 +4000,8 @@ cli.command("list", "List available bundles grouped by department domain").alias
     }
     const domainBundles = bundles.filter((b) => b.domain === activeDomain || activeDomain === "organization" && b.tier === "organization");
     const sortedBundles = [...domainBundles].sort((a, b) => {
+      if (a.name === "universal-orchestration") return -1;
+      if (b.name === "universal-orchestration") return 1;
       if (a.name === "universal-skills") return -1;
       if (b.name === "universal-skills") return 1;
       if (!a.parentBundle && b.parentBundle) return -1;
@@ -3998,7 +4012,7 @@ cli.command("list", "List available bundles grouped by department domain").alias
       const isLast = idx === sortedBundles.length - 1;
       const branch = sortedBundles.length > 1 ? isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 " : "";
       const meta = BUNDLE_DISPLAY_NAMES[b.name];
-      const isEssentials = !b.parentBundle && b.name !== "full" && b.name !== "universal-skills" && b.tier !== "organization";
+      const isEssentials = !b.parentBundle && b.name !== "full" && b.name !== "universal-skills" && b.name !== "universal-orchestration" && b.tier !== "organization";
       const titleSuffix = isEssentials ? pc.cyan(" (Essentials Base)") : "";
       const parentTag = b.parentBundle ? pc.gray(` [inherits: ${b.parentBundle}]`) : "";
       let badge = "";
@@ -4150,6 +4164,7 @@ cli.command("start <bundle> [prompt]", "Start an installed bundle team in its ho
       outro(pc.red(`Cline executable was not found on PATH or via CLINE_BIN_PATH. Please install Cline CLI or ensure it is accessible.`));
       process.exit(1);
     }
+    const bundleDef = await registry.getBundle(bundle);
     const plan = launcher.planActivation({
       bundleName: bundle,
       workspace: resolution.workspace,
@@ -4158,7 +4173,8 @@ cli.command("start <bundle> [prompt]", "Start an installed bundle team in its ho
       prompt,
       teamName: options.team,
       allowAddons: options.allowAddons,
-      headless: options.headless
+      headless: options.headless,
+      orchestrator: bundleDef?.orchestrator
     });
     if (options.dryRun) {
       note(
@@ -4197,7 +4213,7 @@ cli.command("doctor", "Verify health of installed agents, frontmatter schemas, a
     console.log(pc.bold(pc.cyan("\u{1F4A1} Get Started:")));
     console.log(`  \u{1F449} ${pc.bold("agents add")}                      Launch the interactive installation wizard`);
     console.log(`  \u{1F449} ${pc.bold("agents add software-engineering")} Install the engineering essentials team`);
-    console.log(`  \u{1F449} ${pc.bold("agents list")}                     Browse all 18 bundles and 8 departments
+    console.log(`  \u{1F449} ${pc.bold("agents list")}                     Browse all 23 bundles and 8 departments
 `);
     if (report.clineCapability) {
       console.log(pc.bold(pc.cyan("Cline Runtime & Compound Projection Audit:")));