@hailer/mcp 0.1.5 → 0.1.8

package/.claude/agents/{ada.md → agent-ada-skill-builder.md}

@@ -1,5 +1,5 @@
 ---
-name: ada
+name: agent-ada-skill-builder
 description: Creates skills and updates agents based on failure patterns.\n\n<example>\nuser: "Viktor keeps getting JOIN syntax wrong"\nassistant: {"status":"success","result":{"skill_path":".claude/skills/join-patterns","agent_updated":"viktor"},"summary":"Created JOIN patterns skill"}\n</example>
 model: sonnet
 tools: Read, Write, Edit, Glob

package/.claude/agents/{alejandro.md → agent-alejandro-function-fields.md}

@@ -1,5 +1,5 @@
 ---
-name: alejandro
+name: agent-alejandro-function-fields
 description: Creates and manages calculated function fields in Hailer workflows via SDK v0.8.4. Designs JavaScript formulas, sets up field dependencies with functionVariables, and deploys through workspace TypeScript files.\n\n<example>\nuser: "Add a Total Cost field that multiplies quantity by unit price"\nassistant: {"status":"ready_to_push","result":{"function_created":true,"variables":2},"commands":["npm run fields-push:force"],"summary":"Created total_cost function"}\n</example>
 model: sonnet
 tools: Bash, Read, Edit, Write, Glob

package/.claude/agents/{bjorn.md → agent-bjorn-config-audit.md}

@@ -1,5 +1,5 @@
 ---
-name: bjorn
+name: agent-bjorn-config-audit
 description: Audits SDK v0.8.4 codebase configuration - docs/CLAUDE.md, agents, hooks, settings.json, workspace structure, and documentation alignment.\n\n<example>\nuser: "Check if docs/CLAUDE.md is accurate"\nassistant: {"status":"success","result":{"agents_found":12,"agents_documented":12,"issues":0},"summary":"Audit passed - all agents documented"}\n</example>
 model: haiku
 tools: Read, Glob, Bash

package/.claude/agents/{agent-builder.md → agent-builder-agent-creator.md}

@@ -1,5 +1,5 @@
 ---
-name: agent-builder
+name: agent-builder-agent-creator
 description: Creates lean, token-efficient Claude Code agents for SDK v0.8.4. Builds agents that work with Hailer workspace configuration, MCP tools, and SDK commands.\n\n<example>\nuser: "I need an agent for SQL reports"\nassistant: {"status":"success","result":{"agent":"viktor.md","lines":45},"summary":"Created viktor agent"}\n</example>
 model: sonnet
 tools: Read, Write, Glob
@@ -25,10 +25,21 @@ I am the Agent Builder. Lean agents, skill references, JSON output. SDK v0.8.4.
 6. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
 </rules>
 
+<namespace>
+All agents MUST use the `agent-` prefix for consistent identification across marketplace and SDK.
+Format: `agent-<name>-<short-description>`
+Examples:
+- `agent-kenji-data-reader`
+- `agent-dmitri-activity-crud`
+- `agent-viktor-sql-insights`
+- `agent-helga-workflow-config`
+- `agent-giuseppe-app-builder`
+</namespace>
+
 <template>
 ```markdown
 ---
-name: lowercase-name
+name: agent-<name>-<short-description>
 description: What it does. For SDK agents: mention SDK v0.8.4.\n\n<example>\nuser: "request"\nassistant: {"status":"success","result":{},"summary":"max 50 chars"}\n</example>
 model: haiku|sonnet
 tools: tool_1, tool_2

package/.claude/agents/{dmitri.md → agent-dmitri-activity-crud.md}

@@ -1,5 +1,5 @@
 ---
-name: dmitri
+name: agent-dmitri-activity-crud
 description: Creates and updates Hailer activity data. WRITE-ONLY.\n\n<example>\nuser: "Create customer Acme Corp"\nassistant: {"status":"success","result":{"created_ids":["abc123"]},"summary":"Created 1 customer"}\n</example>
 model: haiku
 tools: mcp__hailer__create_activity, mcp__hailer__update_activity

package/.claude/agents/{giuseppe.md → agent-giuseppe-app-builder.md}

@@ -1,5 +1,5 @@
 ---
-name: giuseppe
+name: agent-giuseppe-app-builder
 description: Builds Hailer apps with @hailer/app-sdk - React/TypeScript/Chakra.\n\n<example>\nuser: "Build app showing customers"\nassistant: {"status":"success","result":{"app_path":"/apps/customers","build_passed":true},"summary":"Built customers-dashboard"}\n</example>
 model: sonnet
 tools: Bash, Read, Write, Edit, Glob, mcp__hailer__scaffold_hailer_app

package/.claude/agents/{gunther.md → agent-gunther-mcp-tools.md}

@@ -1,5 +1,5 @@
 ---
-name: gunther
+name: agent-gunther-mcp-tools
 description: Builds MCP tools for Hailer MCP server.\n\n<example>\nuser: "Create MCP tool for counting activities"\nassistant: {"status":"success","result":{"tool":"count_activities","registered":true,"build_passed":true},"summary":"Created count_activities tool"}\n</example>
 model: sonnet
 tools: Bash, Read, Write, Edit, Glob

package/.claude/agents/{helga.md → agent-helga-workflow-config.md}

@@ -1,5 +1,5 @@
 ---
-name: helga
+name: agent-helga-workflow-config
 description: Manages Hailer workspace configuration as infrastructure-as-code using SDK v0.8.4. Creates workflows, fields, phases, teams, groups, insights, and document templates via local TypeScript files and SDK commands.\n\n<example>\nuser: "Add a Due Date field to Tasks"\nassistant: {"status":"ready_to_push","result":{"files_edited":["fields.ts"]},"commands":["npm run fields-push:force"],"summary":"Added Due Date field"}\n</example>
 model: sonnet
 tools: Bash, Read, Edit, Write, Glob

package/.claude/agents/{ingrid.md → agent-ingrid-doc-templates.md}

@@ -1,5 +1,5 @@
 ---
-name: ingrid
+name: agent-ingrid-doc-templates
 description: Document template specialist for SDK v0.8.4. Creates and manages Hailer document templates (PDF/CSV) with precise field mappings and generation functions.\n\n<example>\nuser: "Create a PDF invoice template"\nassistant: {"status":"ready_to_push","result":{"template_added":true},"commands":["npm run templates-sync:force"],"summary":"Added Invoice template - run command"}\n</example>
 model: sonnet
 tools: Bash, Read, Edit, Write, Glob

package/.claude/agents/{kenji.md → agent-kenji-data-reader.md}

@@ -1,5 +1,5 @@
 ---
-name: kenji
+name: agent-kenji-data-reader
 description: LOCAL-FIRST data retrieval for SDK v0.8.4 - reads workspace/ before API. Knows about workflows, fields, phases, templates, functions, teams, groups, and insights.\n\n<example>\nuser: "What fields does Tasks have?"\nassistant: {"status":"success","result":{"fields":["taskName","project","dueDate"]},"source":"local","summary":"Read fields.ts"}\n</example>
 model: haiku
 tools: Read, Glob, mcp__hailer__list_workflows_minimal, mcp__hailer__count_activities, mcp__hailer__list_activities, mcp__hailer__list_workflow_phases

package/.claude/agents/{nora.md → agent-nora-name-functions.md}

@@ -1,5 +1,5 @@
 ---
-name: nora
+name: agent-nora-name-functions
 description: Creates and manages workflow nameFunction configurations via SDK v0.8.4. Designs JavaScript name generation functions with field dependencies for dynamic activity naming.\n\n<example>\nuser: "Add name function to Employees workflow"\nassistant: {"status":"ready_to_push","result":{"name_function_added":true,"variables":1},"commands":["npm run workflows-push"],"summary":"Added name function to Employees"}\n</example>
 model: haiku
 tools: Bash, Read, Edit, Glob

package/.claude/agents/{svetlana.md → agent-svetlana-code-review.md}

@@ -1,5 +1,5 @@
 ---
-name: svetlana
+name: agent-svetlana-code-review
 description: Reviews code for bugs, security, and best practices. READ-ONLY.\n\n<example>\nuser: "Review my changes before commit"\nassistant: {"status":"success","result":{"verdict":"REQUEST_CHANGES","critical":2,"warnings":3},"summary":"Found 2 critical issues"}\n</example>
 model: sonnet
 tools: Read, Glob, Grep, Bash

package/.claude/agents/{viktor.md → agent-viktor-sql-insights.md}

@@ -1,5 +1,5 @@
 ---
-name: viktor
+name: agent-viktor-sql-insights
 description: Creates and manages SQL-like insights over Hailer workflow data via SDK v0.8.4. Designs queries, defines data sources, and deploys through workspace TypeScript files.\n\n<example>\nuser: "Create report showing high priority tasks"\nassistant: {"status":"ready_to_push","result":{"insight_created":true,"sources":1},"commands":["npm run insights-push:force"],"summary":"Created Tasks by Priority insight"}\n</example>
 model: sonnet
 tools: Bash, Read, Edit, Write, Glob, mcp__hailer__preview_insight, mcp__hailer__get_insight_data, mcp__hailer__list_workflows, mcp__hailer__get_workflow_schema

package/.claude/agents/{yevgeni.md → agent-yevgeni-discussions.md}

@@ -1,5 +1,5 @@
 ---
-name: yevgeni
+name: agent-yevgeni-discussions
 description: Handles Hailer discussions - reading, posting, membership.\n\n<example>\nuser: "Post update to team discussion"\nassistant: {"status":"success","result":{"posted":true},"summary":"Posted to team discussion"}\n</example>
 model: haiku
 tools: mcp__hailer__list_my_discussions, mcp__hailer__fetch_discussion_messages, mcp__hailer__fetch_previous_discussion_messages, mcp__hailer__add_discussion_message, mcp__hailer__join_discussion, mcp__hailer__leave_discussion, mcp__hailer__invite_discussion_members, mcp__hailer__get_activity_from_discussion, mcp__hailer__search_workspace_users

package/.claude/hooks/sync-marketplace-agents.cjs

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+/**
+ * Sync Marketplace Agents Hook
+ * Watches installed_plugins.json for changes and updates CLAUDE.md
+ * with available marketplace agents when plugins are installed/uninstalled.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const crypto = require('crypto');
+
+const PLUGINS_DIR = path.join(os.homedir(), '.claude', 'plugins', 'marketplaces');
+const INSTALLED_PLUGINS = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
+const PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
+const CLAUDE_MD = path.join(PROJECT_DIR, 'CLAUDE.md');
+const PROJECT_SETTINGS = path.join(PROJECT_DIR, '.claude', 'settings.json');
+const USER_SETTINGS = path.join(os.homedir(), '.claude', 'settings.json');
+
+// Store sync state in user's home, keyed by project path hash
+const SYNC_STATE_DIR = path.join(os.homedir(), '.claude', 'sync-state');
+const PROJECT_HASH = crypto.createHash('md5').update(PROJECT_DIR).digest('hex').slice(0, 12);
+const SYNC_STATE = path.join(SYNC_STATE_DIR, `${PROJECT_HASH}.state`);
+
+/**
+ * Get hash of installed_plugins.json content
+ */
+function getInstalledPluginsHash() {
+  if (!fs.existsSync(INSTALLED_PLUGINS)) {
+    return 'empty';
+  }
+  const content = fs.readFileSync(INSTALLED_PLUGINS, 'utf-8');
+  return crypto.createHash('md5').update(content).digest('hex');
+}
+
+/**
+ * Check if plugins have changed since last sync
+ */
+function pluginsChanged() {
+  const currentHash = getInstalledPluginsHash();
+
+  if (!fs.existsSync(SYNC_STATE)) {
+    return true; // First run
+  }
+
+  const lastHash = fs.readFileSync(SYNC_STATE, 'utf-8').trim();
+  return currentHash !== lastHash;
+}
+
+/**
+ * Save current sync state
+ */
+function saveSyncState() {
+  const currentHash = getInstalledPluginsHash();
+  // Ensure sync state directory exists
+  if (!fs.existsSync(SYNC_STATE_DIR)) {
+    fs.mkdirSync(SYNC_STATE_DIR, { recursive: true });
+  }
+  fs.writeFileSync(SYNC_STATE, currentHash);
+}
+
+/**
+ * Get installed plugins from installed_plugins.json
+ * Returns Set of "plugin@marketplace" strings
+ */
+function getInstalledPlugins() {
+  const plugins = new Set();
+
+  if (!fs.existsSync(INSTALLED_PLUGINS)) {
+    return plugins;
+  }
+
+  try {
+    const data = JSON.parse(fs.readFileSync(INSTALLED_PLUGINS, 'utf-8'));
+    if (data.plugins) {
+      for (const pluginKey of Object.keys(data.plugins)) {
+        plugins.add(pluginKey);
+      }
+    }
+  } catch (e) {
+    // Ignore parse errors
+  }
+
+  return plugins;
+}
+
+/**
+ * Scan marketplace plugins for agents (all discovered plugins)
+ * Supports three structures:
+ * - Flat: {marketplace}/agents/ (when plugin name == marketplace name)
+ * - Root-level: {marketplace}/{plugin}/agents/ (plugin dirs at marketplace root)
+ * - Nested: {marketplace}/plugins/{plugin}/agents/
+ */
+function scanMarketplaceAgents(enabledPlugins) {
+  const agents = [];
+
+  if (!fs.existsSync(PLUGINS_DIR)) {
+    return agents;
+  }
+
+  const marketplaces = fs.readdirSync(PLUGINS_DIR);
+
+  for (const marketplace of marketplaces) {
+    const marketplacePath = path.join(PLUGINS_DIR, marketplace);
+    if (!fs.statSync(marketplacePath).isDirectory()) continue;
+
+    // Try flat structure first: {marketplace}/agents/
+    const flatAgentsPath = path.join(marketplacePath, 'agents');
+    if (fs.existsSync(flatAgentsPath)) {
+      // For flat structure, plugin name equals marketplace name
+      const pluginKey = `${marketplace}@${marketplace}`;
+      if (enabledPlugins.has(pluginKey)) {
+        const agentFiles = fs.readdirSync(flatAgentsPath).filter(f => f.endsWith('.md'));
+
+        for (const agentFile of agentFiles) {
+          const agentName = path.basename(agentFile, '.md');
+          const fullPath = path.join(flatAgentsPath, agentFile);
+          const content = fs.readFileSync(fullPath, 'utf-8');
+          const frontmatter = parseFrontmatter(content);
+
+          agents.push({
+            marketplace,
+            plugin: marketplace,
+            name: agentName,
+            fullName: `${marketplace}:${agentName}`,
+            description: frontmatter.description || '',
+            model: frontmatter.model || 'sonnet'
+          });
+        }
+      }
+    }
+
+    // Try root-level plugins: {marketplace}/{plugin}/agents/
+    // Each subdirectory with .claude-plugin is a plugin
+    const marketplaceContents = fs.readdirSync(marketplacePath);
+    for (const item of marketplaceContents) {
+      if (item === '.claude-plugin' || item === '.git' || item === 'plugins') continue;
+
+      const itemPath = path.join(marketplacePath, item);
+      if (!fs.statSync(itemPath).isDirectory()) continue;
+
+      const pluginJsonPath = path.join(itemPath, '.claude-plugin', 'plugin.json');
+
+      // Check if this is a plugin (has .claude-plugin/plugin.json)
+      if (fs.existsSync(pluginJsonPath)) {
+        const pluginKey = `${item}@${marketplace}`;
+        if (!enabledPlugins.has(pluginKey)) continue;
+
+        const agentsPath = path.join(itemPath, 'agents');
+        if (!fs.existsSync(agentsPath)) continue;
+
+        const agentFiles = fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'));
+
+        for (const agentFile of agentFiles) {
+          const agentName = path.basename(agentFile, '.md');
+          const fullPath = path.join(agentsPath, agentFile);
+          const content = fs.readFileSync(fullPath, 'utf-8');
+          const frontmatter = parseFrontmatter(content);
+
+          agents.push({
+            marketplace,
+            plugin: item,
+            name: agentName,
+            fullName: `${item}:${agentName}`,
+            description: frontmatter.description || '',
+            model: frontmatter.model || 'sonnet'
+          });
+        }
+      }
+    }
+
+    // Try nested structure: {marketplace}/plugins/{plugin}/agents/
+    const pluginsPath = path.join(marketplacePath, 'plugins');
+    if (fs.existsSync(pluginsPath)) {
+      const plugins = fs.readdirSync(pluginsPath);
+
+      for (const plugin of plugins) {
+        const pluginKey = `${plugin}@${marketplace}`;
+        if (!enabledPlugins.has(pluginKey)) {
+          continue;
+        }
+
+        const pluginPath = path.join(pluginsPath, plugin);
+        if (!fs.statSync(pluginPath).isDirectory()) continue;
+
+        const agentsPath = path.join(pluginPath, 'agents');
+        if (!fs.existsSync(agentsPath)) continue;
+
+        const agentFiles = fs.readdirSync(agentsPath).filter(f => f.endsWith('.md'));
+
+        for (const agentFile of agentFiles) {
+          const agentName = path.basename(agentFile, '.md');
+          const fullPath = path.join(agentsPath, agentFile);
+          const content = fs.readFileSync(fullPath, 'utf-8');
+          const frontmatter = parseFrontmatter(content);
+
+          agents.push({
+            marketplace,
+            plugin,
+            name: agentName,
+            fullName: `${plugin}:${agentName}`,
+            description: frontmatter.description || '',
+            model: frontmatter.model || 'sonnet'
+          });
+        }
+      }
+    }
+  }
+
+  return agents;
+}
+
+/**
+ * Parse frontmatter from markdown
+ */
+function parseFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+
+  const frontmatter = {};
+  const lines = match[1].split('\n');
+
+  for (const line of lines) {
+    const colonIndex = line.indexOf(':');
+    if (colonIndex > 0) {
+      const key = line.slice(0, colonIndex).trim();
+      let value = line.slice(colonIndex + 1).trim();
+      // Clean up description
+      if (key === 'description') {
+        value = value.replace(/\\n.*/g, '').slice(0, 100);
+      }
+      frontmatter[key] = value;
+    }
+  }
+
+  return frontmatter;
+}
+
+/**
+ * Generate marketplace agents table
+ */
+function generateAgentTable(agents) {
+  if (agents.length === 0) {
+    return 'No marketplace agents installed.';
+  }
+
+  let table = '| Agent | Plugin | Model | Description |\n';
+  table += '|-------|--------|-------|-------------|\n';
+
+  for (const agent of agents) {
+    const desc = agent.description.slice(0, 50) + (agent.description.length > 50 ? '...' : '');
+    table += `| \`${agent.fullName}\` | ${agent.plugin} | ${agent.model} | ${desc} |\n`;
+  }
+
+  return table;
+}
+
+/**
+ * Update CLAUDE.md with marketplace agents
+ */
+function updateClaudeMd(agents) {
+  if (!fs.existsSync(CLAUDE_MD)) {
+    return { updated: false, reason: 'CLAUDE.md not found' };
+  }
+
+  let content = fs.readFileSync(CLAUDE_MD, 'utf-8');
+
+  const agentTable = generateAgentTable(agents);
+
+  // Find and update plugin-marketplace section
+  const sectionRegex = /(<plugin-marketplace>[\s\S]*?)(No marketplace agents installed\.|(\| Agent \|[\s\S]*?\n)(?=\n\*\*|<\/plugin-marketplace>))/;
+
+  if (sectionRegex.test(content)) {
+    content = content.replace(sectionRegex, `$1${agentTable}\n`);
+    fs.writeFileSync(CLAUDE_MD, content);
+    return { updated: true, count: agents.length };
+  }
+
+  return { updated: false, reason: 'plugin-marketplace section not found' };
+}
+
+/**
+ * Main
+ */
+function main() {
+  // Skip if installed_plugins.json hasn't changed
+  if (!pluginsChanged()) {
+    process.exit(0);
+  }
+
+  try {
+    // Get actually installed plugins from installed_plugins.json
+    const installedPlugins = getInstalledPlugins();
+
+    // Scan agents only from installed plugins
+    const agents = scanMarketplaceAgents(installedPlugins);
+    const result = updateClaudeMd(agents);
+
+    // Save sync state
+    saveSyncState();
+
+    // Output info
+    console.error(`[sync-agents] Detected plugin changes, found ${agents.length} marketplace agents`);
+    if (result.updated) {
+      console.error(`[sync-agents] Updated CLAUDE.md`);
+    }
+
+    process.exit(0);
+  } catch (error) {
+    console.error(`[sync-agents] Error: ${error.message}`);
+    process.exit(0); // Don't block on errors
+  }
+}
+
+main();

package/.claude/settings.json

@@ -16,6 +16,11 @@
             "type": "command",
             "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/interactive-mode.cjs\"",
             "timeout": 5
+          },
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/sync-marketplace-agents.cjs\"",
+            "timeout": 5
           }
         ]
       }

package/CHANGELOG.md

@@ -4,6 +4,69 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.8] - 15-12-2025
+
+### Fixed
+
+- Corrected marketplace git URL to `git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+
+## [0.1.7] - 15-12-2025
+
+### Changed
+
+- **Marketplace Sync Hook**:
+  - Changed from session-based to hash-based sync (tracks `installed_plugins.json` changes)
+  - Added support for root-level plugin structure: `{marketplace}/{plugin}/agents/`
+  - Per-project sync state to avoid unnecessary re-syncs
+  - Improved logging when plugin changes detected
+
+- **Plugin Documentation**:
+  - Restructured CLAUDE.md with separate `<plugin-setup>` and `<plugin-contributing>` sections
+  - Clearer instructions for marketplace installation and contribution
+
+## [0.1.5] - 12-12-2025
+
+### Added
+
+- **Marketplace System**:
+  - `sync-marketplace-agents.cjs` hook - Syncs installed marketplace agents to CLAUDE.md
+  - Support for flat and nested plugin structures
+  - Individual plugin installation support
+
+### Changed
+
+- **Agent Namespace Convention**:
+  - All agents renamed to `agent-<name>-<description>` format
+  - Examples: `agent-kenji-data-reader`, `agent-viktor-sql-insights`
+  - Agent builder updated with namespace template
+
+- Updated agents with SDK v0.8.4 compatibility
+- Added `agent-nora-name-functions` for workflow name functions
+- Updated CLAUDE.md marketplace URL
+
+## [0.1.4] - 11-12-2025
+
+### Changed
+
+- XML tag format for skills
+- XML tag updates for hooks and client improvements
+- Fixed stale hook reference
+
+## [0.1.3] - 10-12-2025
+
+### Changed
+
+- **Agent System Refactor**:
+  - XML tag format for agents
+  - Multi-agent hook system
+  - Replaced skills system with specialized agents
+
+## [0.0.6] - 02-12-2025
+
+### Changed
+
+- Updated scaffold-hailer-app skill with improved patterns
+
 ## [0.0.5] - 01-12-2025
 
 ### Added

package/CLAUDE.md

@@ -22,19 +22,20 @@ Agents return JSON. You interpret it for the user.
 <agents>
 | Pattern | Agent | Model |
 |---------|-------|-------|
-| Read data/schema | `kenji` | haiku |
-| Activity CRUD | `dmitri` | haiku |
-| Discussions/chat | `yevgeni` | haiku |
-| Config audit | `bjorn` | haiku |
-| Workflows, fields, phases | `helga` | sonnet |
-| SQL insights | `viktor` | sonnet |
-| Function fields | `alejandro` | sonnet |
-| MCP tools | `gunther` | sonnet |
-| Hailer apps | `giuseppe` | sonnet |
-| Code review | `svetlana` | sonnet |
-| New agents | `agent-builder` | sonnet |
-| Skills, agent improvements | `ada` | sonnet |
-| Document templates | `ingrid` | sonnet |
+| Read data/schema | `agent-kenji-data-reader` | haiku |
+| Activity CRUD | `agent-dmitri-activity-crud` | haiku |
+| Discussions/chat | `agent-yevgeni-discussions` | haiku |
+| Config audit | `agent-bjorn-config-audit` | haiku |
+| Workflows, fields, phases | `agent-helga-workflow-config` | sonnet |
+| SQL insights | `agent-viktor-sql-insights` | sonnet |
+| Function fields | `agent-alejandro-function-fields` | sonnet |
+| MCP tools | `agent-gunther-mcp-tools` | sonnet |
+| Hailer apps | `agent-giuseppe-app-builder` | sonnet |
+| Code review | `agent-svetlana-code-review` | sonnet |
+| New agents | `agent-builder-agent-creator` | sonnet |
+| Skills, agent improvements | `agent-ada-skill-builder` | sonnet |
+| Document templates | `agent-ingrid-doc-templates` | sonnet |
+| Name functions | `agent-nora-name-functions` | sonnet |
 </agents>
 
 <delegation-protocol>
@@ -52,7 +53,7 @@ OUTPUT (JSON only, no prose):
 { "status": "success|error|ready_to_push|needs_confirmation", "result": {}, "summary": "max 50 chars" }
 ```
 
-FLOW: Get IDs first (kenji) → pass to execution agents (dmitri, helga, etc.)
+FLOW: Get IDs first (agent-kenji-data-reader) → pass to execution agents (agent-dmitri-activity-crud, agent-helga-workflow-config, etc.)
 </delegation-protocol>
 
 <push-commands>
@@ -154,6 +155,54 @@ DISABLE: Move to `docs/agents/`
 WITHOUT AGENTS: Use MCP tools directly
 </customization>
 
+<plugin-marketplace>
+Community agents are shared via the Hailer Agent Marketplace (separate git repo).
+
+**Marketplace URL:** `git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+
+**Installed marketplace agents:**
+No marketplace agents installed.
+
+**Use plugin agents:**
+```
+Task(subagent_type="plugin:agent-name", prompt="...", model="haiku|sonnet")
+```
+
+**Agent sources:**
+- Default agents: `.claude/agents/` (shipped via npm)
+- Community agents: Plugin marketplace (installed separately)
+</plugin-marketplace>
+
+<plugin-setup>
+When user asks to install plugins or set up the marketplace:
+
+1. Tell user to run these slash commands:
+   ```
+   /plugin marketplace add git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git
+   /plugin install <plugin-name>
+   ```
+
+2. Tell user: "Restart Claude Code to load the new agents."
+
+Available plugins: `permissions-handler`, `hailer-agents`
+
+After restart, sync hook updates this file automatically with installed agents.
+</plugin-setup>
+
+<plugin-contributing>
+To contribute agents to the marketplace:
+
+1. Clone: `git clone git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+2. Create plugin structure:
+   ```
+   my-plugin/
+     .claude-plugin/plugin.json
+     agents/agent-my-agent.md
+   ```
+3. Follow agent structure from `<agent-structure>` section
+4. Push to repo
+</plugin-contributing>
+
 <directory>
 ```
 workspace/              # Local config (check FIRST)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hailer/mcp",
-  "version": "0.1.5",
+  "version": "0.1.8",
   "config": {
     "docker": {
       "registry": "registry.gitlab.com/hailer-repos/hailer-mcp"