@compilr-dev/sdk 0.9.25 → 0.9.27

package/dist/project-types/configs.js

@@ -106,6 +106,15 @@ Specialized agents may be available:
 - **Architect** — system design, technical decisions
 - **PM** — requirements, backlog management, priorities
 Suggest delegation when a task would benefit from focused expertise.`,
+    tagline: 'Build a web app, API, CLI, or library — from idea to running code.',
+    bestFor: 'you have an idea and want compilr.dev to help you ship it.',
+    produces: [
+        'Application model + entities',
+        'PRD + architecture',
+        'Working code (scaffolded)',
+        'Backlog of features',
+        'Session notes',
+    ],
 };
 // =============================================================================
 // General (blank slate)
@@ -134,6 +143,9 @@ You are assisting with a general-purpose project. Adapt your approach to whateve
 - Use work items to track tasks and progress
 - Use documents to store important artifacts
 - Suggest team agents if the project would benefit from specialization`,
+    tagline: 'An empty workspace — define your own workflow as you go.',
+    bestFor: "you don't see a fit above and want a blank slate.",
+    produces: ['Notes & documents', 'Conversations with agents', 'Whatever you build'],
 };
 // =============================================================================
 // Research Paper / Academic
@@ -288,6 +300,15 @@ Suggest delegation when a task would benefit from focused expertise. For example
 - \`/draft-section\` — write a section using outline + claims + sources (when available)
 - \`/peer-review\` — validate argument structure and consistency (when available)
 - \`/session-notes\` — summarize work done in this session`,
+    tagline: 'Write an academic paper, thesis, or research report — outline to bibliography.',
+    bestFor: "you're writing something with a literature review and citations.",
+    produces: [
+        'Outline + abstract',
+        'Literature review',
+        'Drafted sections',
+        'Bibliography (BibTeX-ready)',
+        'Session notes',
+    ],
 };
 // =============================================================================
 // Business Plan / Startup
@@ -401,6 +422,15 @@ You are assisting with a business plan or startup project. Your role is to help
 - **Analyst** — market research, competitive intelligence, data analysis
 - **Strategist** — business model, go-to-market, positioning
 - **Writer** — pitch narrative, executive summary, investor communication`,
+    tagline: 'Build a business plan, market analysis, and pitch deck — from idea to investor-ready.',
+    bestFor: "you're planning a venture, raising money, or entering a new market.",
+    produces: [
+        'Executive summary',
+        'Market & competitor analysis',
+        'Financial model',
+        'Positioning matrix',
+        'Pitch outline',
+    ],
 };
 // =============================================================================
 // Content / Blog / Marketing
@@ -528,6 +558,15 @@ This project uses a Brand Model that captures visual identity (logos, colors, fo
 - **Visual Director** — visual briefs from Brand Model guidelines
 - **Editor** — voice consistency, brand alignment, quality review
 Suggest delegation when a task benefits from focused expertise.`,
+    tagline: 'Plan and write articles, blog posts, and social content — at the pace of a publication.',
+    bestFor: "you're producing content on a calendar and want help shipping it.",
+    produces: [
+        'Editorial calendar',
+        'Article drafts',
+        'Headlines & social variants',
+        'SEO outlines',
+        'Style guide',
+    ],
 };
 // =============================================================================
 // Technical Documentation
@@ -613,6 +652,15 @@ You are assisting with a technical documentation project. Your role is to help t
 - **Writer** — drafting documentation, tutorials, guides
 - **Editor** — clarity, consistency, grammar, readability
 - **Reviewer** — technical accuracy, completeness, correctness`,
+    tagline: 'Write API docs, user guides, and tutorials that read like a real product.',
+    bestFor: 'your project needs docs, or docs ARE the project.',
+    produces: [
+        'Getting started guide',
+        'API reference',
+        'Tutorials',
+        'Concept explanations',
+        'Changelog drafts',
+    ],
 };
 // =============================================================================
 // Course / Training Material
@@ -725,6 +773,15 @@ This project uses a Curriculum Model that tracks the course structure: modules (
 - **Instructor** — curriculum design, sequencing, pedagogy
 - **Content Designer** — lesson planning, exercises, assessments
 - **Reviewer** — pedagogical quality, balance, difficulty calibration`,
+    tagline: 'Design a course, training program, or curriculum — from outcomes to assessments.',
+    bestFor: "you're teaching something and need to structure modules + lessons.",
+    produces: [
+        'Curriculum outline',
+        'Module + lesson plans',
+        'Exercises & worked examples',
+        'Assessments / quizzes',
+        'Instructor notes',
+    ],
 };
 // =============================================================================
 // Book
@@ -838,4 +895,13 @@ This project uses a Book Model that tracks: chapters (with scenes), characters (
 - **Plotter** — story architecture, beats, pacing, plot threads
 - **Character Dev** — characters, arcs, relationships, dialogue voice
 - **Scene Writer** — scene construction, setting, POV, transitions`,
+    tagline: 'Plan and write a book — fiction or non-fiction, outline to manuscript.',
+    bestFor: "you're writing a book and want help with structure, characters, or chapters.",
+    produces: [
+        'Outline + chapter map',
+        'Character profiles (fiction)',
+        'Drafted chapters',
+        'Beat-by-beat structure',
+        'Revision notes',
+    ],
 };

package/dist/project-types/types.d.ts

@@ -100,4 +100,15 @@ export interface ProjectTypeConfig {
     systemPromptContext: string;
     /** Rich multi-line system prompt section for the default agent. Takes precedence over systemPromptContext. */
     systemPromptSection?: string;
+    /** One-sentence value prop for the project-type picker. Punchier than
+     *  `description`, written for someone who doesn't know the term yet.
+     *  Used in the New Project / Import Project wizards. */
+    tagline?: string;
+    /** "Best when…" trigger phrase a user can self-recognize.
+     *  Example: "you're starting from a literature review and need a paper". */
+    bestFor?: string;
+    /** Concrete outputs the user will produce in this project type. 3-5 short
+     *  items shown as bullets in the picker's detail panel. Mined from
+     *  documentTemplates / projectActions / domain models. */
+    produces?: string[];
 }

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.25",
+  "version": "0.9.27",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",