feat(agents): default agent template catalog

[vibegui]

Summary

• Adds a browsable catalog of 27 agent templates across 7 categories (Platform, E-Commerce, Content & SEO, Site Building, Marketing, Operations, Engineering)
• New Templates tab on agents page — defaults to it when org has no agents
• Each template shows required MCPs with green/red install status rings, ice breaker pills, and system prompt preview
• Missing MCPs deep-link to the Store for one-click installation
• Installing an agent navigates directly to its detail page
• Engineering agents inspired by gstack: Code Reviewer, Engineering Retro, Product Reviewer, Architecture Reviewer, Browser QA

Files changed

• apps/mesh/src/constants/default-agents.ts — 27 agent template specs
• apps/mesh/src/web/components/agents/agent-templates.tsx — template browser UI
• apps/mesh/src/web/routes/orgs/agents.tsx — tabs + empty state
• apps/mesh/src/mcp-clients/virtual-mcp/passthrough-client.ts — ice breaker injection
• packages/mesh-sdk/src/types/virtual-mcp.ts — metadata schema extension

Test plan

• Verify Templates tab renders with all 7 categories
• Search filters templates by title, description, and required app names
• MCP icons show green ring when installed, red when missing
• Clicking "Install from Store" navigates to correct store page with registryId/serverName
• Installing an agent creates it and navigates to the agent detail page
• Ice breakers display correctly in chat UI (not as __ice_breaker_0)
• Empty state defaults to Templates tab

🤖 Generated with Claude Code

---

Summary by cubic

Adds a browsable catalog of 27 agent templates with a new Templates tab on the Agents page to quickly bootstrap agents. Templates show required MCP install status, deep-link to the Store, and install flows that create the agent with ice-breakers and navigate to its detail page.

• New Features

  • Templates tab with category grouping and search; two-tab switcher (My Agents/Templates) and defaults to Templates when an org has no agents
  • Detail dialog shows required MCPs with green/red status rings, one-click Store links, conversation starters, system prompt preview; built-in connections listed when present
  • Installing a template creates the agent and routes to its detail page; ice breakers stored in metadata and shown as static prompts in chat
  • Engineering-focused templates included (e.g., Code Reviewer, Architecture Reviewer, Browser QA)

• Migration

  • No breaking changes; added optional metadata.ice_breakers and metadata.required_apps to VirtualMCP schemas in @decocms/mesh-sdk
  • Local dev: updated conductor.json run script to dev:local:conductor
  • Templates that require MCPs will prompt installation via the Store before use

^{Written for commit 224e998. Summary will update on new commits.}

[github-actions]

🧪 Benchmark

Should we run the Virtual MCP strategy benchmark for this PR?

React with 👍 to run the benchmark.

Reaction	Action
👍	Run quick benchmark (10 & 128 tools)

Benchmark will run on the next push after you react.

[github-actions]

Release Options

Should a new version be published when this PR is merged?

React with an emoji to vote on the release type:

Reaction	Type	Next Version
👍	Prerelease	2.168.1-alpha.1
🎉	Patch	2.168.1
❤️	Minor	2.169.0
🚀	Major	3.0.0

Current version: 2.168.0

Deployment

• Deploy to production (triggers ArgoCD sync after Docker image is published)

[cubic-dev-ai]

3 issues found across 5 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="apps/mesh/src/web/routes/orgs/agents.tsx">

<violation number="1" location="apps/mesh/src/web/routes/orgs/agents.tsx:769">
P2: Keep the selected tab in sync when the org has no agents. This initializer only runs once, so after deleting the last agent or switching to an empty org the page can stay on “My Agents” instead of defaulting to Templates.

(Based on your team's feedback about render-phase state reset for state derived from render conditions.) [FEEDBACK_USED]</violation>
</file>

<file name="apps/mesh/src/mcp-clients/virtual-mcp/passthrough-client.ts">

<violation number="1" location="apps/mesh/src/mcp-clients/virtual-mcp/passthrough-client.ts:661">
P2: These synthetic prompt names will still leak into the chat composer as `/__ice_breaker_n`, because prompt mentions render `prompt.name` rather than `title`. This doesn't satisfy the intended "not as __ice_breaker_0" behavior.</violation>
</file>

<file name="apps/mesh/src/constants/default-agents.ts">

<violation number="1" location="apps/mesh/src/constants/default-agents.ts:36">
P1: These built-in connection selections are never applied during install, so the affected templates are created without the tools they depend on.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

P1: These built-in connection selections are never applied during install, so the affected templates are created without the tools they depend on.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At apps/mesh/src/constants/default-agents.ts, line 36:

<comment>These built-in connection selections are never applied during install, so the affected templates are created without the tools they depend on.</comment>

<file context>
@@ -0,0 +1,1091 @@
+        "Manages your Studio workspace: creates agents, configures connections, sets up projects, and manages API keys.",
+      iconIndex: 11,
+      requiredApps: [],
+      builtinConnections: [
+        {
+          key: "self",
</file context>