@compilr-dev/sdk 0.9.26 → 0.9.27

package/dist/team/types.d.ts

@@ -60,6 +60,19 @@ export interface RoleMetadata {
     /** Default model tier for this role */
     defaultModelTier?: ModelTier;
 }
+/**
+ * User-facing copy for the agent picker (Agent Workshop in Desktop, /agent
+ * in CLI). Stored as a separate map from RoleMetadata so we can iterate on
+ * the copy without touching the long defaultSystemPromptAddition blocks.
+ */
+export interface RoleCopy {
+    /** One-sentence value prop, punchier than `description`. */
+    tagline: string;
+    /** "Best when…" trigger phrase a user can self-recognize. */
+    bestFor: string;
+    /** Other role IDs this one complements — rendered as a "pairs with" row. */
+    pairsWith: AgentRole[];
+}
 /**
  * Role expertise keywords for team awareness
  * Used in the team roster to help agents understand each other's strengths
@@ -214,3 +227,10 @@ export interface TeamEvent {
  * Team event handler
  */
 export type TeamEventHandler = (event: TeamEvent) => void;
+/**
+ * User-facing copy for each predefined role, surfaced in the Agent Workshop
+ * picker and the CLI /agent flow. Maintained as a separate map from
+ * ROLE_METADATA (which carries long system-prompt blocks) so the copy can
+ * be iterated without touching agent behavior.
+ */
+export declare const ROLE_COPY: Partial<Record<AgentRole, RoleCopy>>;

package/dist/team/types.js

@@ -909,3 +909,81 @@ You are the **Instructor** in this multi-agent team. You specialize in education
         defaultModelTier: 'balanced',
     },
 };
+/**
+ * User-facing copy for each predefined role, surfaced in the Agent Workshop
+ * picker and the CLI /agent flow. Maintained as a separate map from
+ * ROLE_METADATA (which carries long system-prompt blocks) so the copy can
+ * be iterated without touching agent behavior.
+ */
+export const ROLE_COPY = {
+    pm: {
+        tagline: 'Plans the work — requirements, backlog, priorities, dependencies.',
+        bestFor: 'you need scope clarified, priorities ordered, or a roadmap built.',
+        pairsWith: ['arch', 'dev', 'qa'],
+    },
+    arch: {
+        tagline: 'Designs systems — choosing tech, structuring data, mapping boundaries.',
+        bestFor: "you're picking a stack, designing a schema, or mapping services.",
+        pairsWith: ['dev', 'pm', 'ops'],
+    },
+    qa: {
+        tagline: 'Tests, reviews, and stress-tests code before it ships.',
+        bestFor: 'you want testing strategy, code review, or quality checks.',
+        pairsWith: ['dev', 'pm'],
+    },
+    dev: {
+        tagline: 'Writes, debugs, and refactors code in any language your project speaks.',
+        bestFor: 'you need code written, fixed, or restructured.',
+        pairsWith: ['arch', 'qa'],
+    },
+    ops: {
+        tagline: 'Handles deployment, infrastructure, CI/CD, and observability.',
+        bestFor: "you're shipping to production, debugging an outage, or hardening infra.",
+        pairsWith: ['arch', 'dev'],
+    },
+    docs: {
+        tagline: 'Writes API docs, user guides, and tutorials that read like a real product.',
+        bestFor: 'your project needs docs — getting started, API reference, or tutorials.',
+        pairsWith: ['dev', 'arch'],
+    },
+    ba: {
+        tagline: 'Turns business needs into clear requirements and acceptance criteria.',
+        bestFor: 'you have a fuzzy ask and need it sharpened into testable user stories.',
+        pairsWith: ['pm', 'arch'],
+    },
+    researcher: {
+        tagline: 'Analyzes sources, synthesizes literature, evaluates evidence.',
+        bestFor: 'you have questions to investigate or sources to summarize.',
+        pairsWith: ['reviewer', 'editor'],
+    },
+    reviewer: {
+        tagline: 'Validates arguments, checks consistency, surfaces gaps.',
+        bestFor: "you have a draft and want to know what's missing or weak.",
+        pairsWith: ['researcher', 'editor'],
+    },
+    editor: {
+        tagline: 'Polishes prose — clarity, voice, grammar, flow.',
+        bestFor: 'you have a draft and want it to read well.',
+        pairsWith: ['researcher', 'writer'],
+    },
+    writer: {
+        tagline: 'Drafts long-form text — articles, plans, narratives.',
+        bestFor: 'you need words on the page that match a clear voice.',
+        pairsWith: ['editor', 'strategist'],
+    },
+    analyst: {
+        tagline: 'Reads data, runs comparisons, surfaces patterns.',
+        bestFor: 'you have numbers (or competitors) to interpret.',
+        pairsWith: ['strategist', 'pm'],
+    },
+    strategist: {
+        tagline: 'Frames positioning, business models, go-to-market plans.',
+        bestFor: "you're choosing a path forward in business or product.",
+        pairsWith: ['analyst', 'pm'],
+    },
+    instructor: {
+        tagline: 'Designs curriculum — modules, lessons, assessments.',
+        bestFor: "you're teaching something and need it structured for learners.",
+        pairsWith: ['reviewer', 'writer'],
+    },
+};

package/dist/team/workshop-data.d.ts

@@ -14,6 +14,12 @@ export interface WorkshopRoleDef {
     expertise: string[];
     defaultToolProfile: string;
     defaultModelTier: string;
+    /** One-sentence value prop from ROLE_COPY (optional — falls back to description in the UI). */
+    tagline?: string;
+    /** "Best when…" trigger phrase. */
+    bestFor?: string;
+    /** Other role IDs this one complements, used for the "pairs with" strip. */
+    pairsWith?: string[];
 }
 export interface WorkshopToolProfile {
     id: string;

package/dist/team/workshop-data.js

@@ -5,7 +5,7 @@
  * Used by both Desktop (via IPC) and CLI (direct import).
  * Single source of truth — no hardcoded data in UI components.
  */
-import { PREDEFINED_ROLE_IDS, ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, } from './types.js';
+import { PREDEFINED_ROLE_IDS, ROLE_METADATA, ROLE_EXPERTISE, ROLE_GROUPS, ROLE_COPY, } from './types.js';
 import { PROFILE_INFO } from './tool-config.js';
 import { SKILL_REQUIREMENTS, getSkillsByCategory } from './skill-requirements.js';
 // =============================================================================
@@ -52,6 +52,7 @@ export function buildAgentWorkshopData(suggestedRolesMap) {
     // Roles (exclude 'default' — it's the coordinator, not selectable)
     const roles = PREDEFINED_ROLE_IDS.filter((id) => id !== 'default').map((id) => {
         const meta = ROLE_METADATA[id];
+        const copy = ROLE_COPY[id];
         return {
             id,
             displayName: meta.displayName,
@@ -61,6 +62,9 @@ export function buildAgentWorkshopData(suggestedRolesMap) {
             expertise: ROLE_EXPERTISE[id],
             defaultToolProfile: meta.defaultToolProfile ?? 'full',
             defaultModelTier: meta.defaultModelTier ?? 'balanced',
+            tagline: copy?.tagline,
+            bestFor: copy?.bestFor,
+            pairsWith: copy?.pairsWith ? [...copy.pairsWith] : undefined,
         };
     });
     // Role groups in display order

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.9.26",
+  "version": "0.9.27",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",