@monoes/monomindcli 2.16.1 → 2.16.3

package/.claude/skills/mastermind-research/SKILL.md

@@ -105,18 +105,20 @@ SCOPE: [sources to consult, search queries to run, depth of analysis]
 CONSTRAINTS: [recency requirements, geographic scope, data reliability thresholds]
 SUCCESS CRITERIA:
 - [ ] [checkable item — e.g. \"top 5 competitors identified with pricing\"]
-AGENT: [researcher | Trend Researcher | UX Researcher | Analytics Reporter]
+AGENT: [specialist picked in STEP 3]
 SWARM: mesh 4 gossip
 DEPENDENCIES: [task IDs or \"none\"]
 OUTPUT FORMAT: unified output schema"
 ```
 
 STEP 3 — EXECUTE
-Spawn one Task agent per research stream (mesh topology — findings cross-pollinate):
-- Web and market research: subagent_type "researcher"
-- Trend and signal analysis: subagent_type "Trend Researcher"
-- User behavior and UX signals: subagent_type "UX Researcher"
-- Data and metrics analysis: subagent_type "Analytics Reporter"
+Spawn one Task agent per research stream (mesh topology — findings cross-pollinate).
+Pick one specialist per research stream from the shared agent index (the Jev decision model when configured, keyword ranking otherwise); it only returns agents that exist. In order: the prompt's `[PICK]` line when it fits this research stream; else `mcp__monomind__pick({ task: "<research stream>: <scope>", kind: "agents", top: 1 })` → `agents.ranked[0].name`; else the local CLI through the version-checked `mmpick` helper from `mastermind-agent-select/SKILL.md` (never npx):
+```bash
+mmpick -t "<research stream>: <scope>" --top 1 | jq -r '.agents.ranked[0].name // empty'
+```
+Use the returned name as that research stream's subagent_type. If nothing is returned, use the default below.
+- Any stream: "researcher"
 
 Also run /mastermind:do --board <board_id> to track execution.
 
@@ -163,6 +165,6 @@ For simple tasks (single researcher, single question):
 |---|---|---|
 | Full competitive analysis | researcher + trend + UX | mesh 4 gossip balanced |
 | Market sizing | researcher | hierarchical 3 raft specialized |
-| Trend scan | Trend Researcher | single agent |
-| User research synthesis | UX Researcher | hierarchical 3 raft specialized |
+| Trend scan | researcher | single agent |
+| User research synthesis | researcher + Monodesign | hierarchical 3 raft specialized |
 | Quick factual lookup | researcher | single agent |

package/.claude/skills/mastermind-review/SKILL.md

@@ -39,7 +39,7 @@ Assess the prompt to determine execution mode:
 **Simple (direct execution):** Single file or single artifact:
 - "Review this function for bugs"
 - "Check this paragraph for clarity"
-→ Use a single Code Reviewer or content reviewer agent. Skip manager delegation.
+→ Use a single `reviewer` agent (for code or content). Skip manager delegation.
 
 **Complex (spawn Review Manager agent):** Any of these:
 - Full codebase or module audit
@@ -116,19 +116,24 @@ SCOPE: [exact files, URLs, documents, or system surfaces in scope]
 CONSTRAINTS: [known acceptable risks, existing decisions not to revisit, standards to apply]
 SUCCESS CRITERIA:
 - [ ] [checkable item — e.g. \"all critical issues documented\"]
-AGENT: [Code Reviewer | Security Engineer | analyst | Accessibility Auditor | UX Researcher]
+AGENT: [specialist picked in STEP 3]
 SWARM: mesh 4 gossip
 DEPENDENCIES: [task IDs or \"none\"]
 OUTPUT FORMAT: unified output schema"
 ```
 
 STEP 3 — EXECUTE
-Spawn one Task agent per review angle (mesh topology — reviewers share findings):
-- Code quality: subagent_type "Code Reviewer"
-- Security: subagent_type "Security Engineer"
-- Architecture: subagent_type "Software Architect"
-- Analytics/metrics: subagent_type "Analytics Reporter"
-- Accessibility: subagent_type "Accessibility Auditor"
+Spawn one Task agent per review angle (mesh topology — reviewers share findings).
+Pick one specialist per review angle from the shared agent index (the Jev decision model when configured, keyword ranking otherwise); it only returns agents that exist. In order: the prompt's `[PICK]` line when it fits this review angle; else `mcp__monomind__pick({ task: "<review angle>: <scope>", kind: "agents", top: 1 })` → `agents.ranked[0].name`; else the local CLI through the version-checked `mmpick` helper from `mastermind-agent-select/SKILL.md` (never npx):
+```bash
+mmpick -t "<review angle>: <scope>" --top 1 | jq -r '.agents.ranked[0].name // empty'
+```
+Use the returned name as that review angle's subagent_type. If nothing is returned, use the default below.
+- Code quality: "reviewer"
+- Security: "Security Engineer"
+- Architecture: "Software Architect"
+- Accessibility: "Accessibility Auditor"
+- Any other angle: "reviewer"
 
 **If `monofence_check = true`** — add a monofence-ai self-validation step to the Security Engineer's briefing:
 ```
@@ -227,7 +232,7 @@ For simple tasks (single reviewer, single artifact):
 | Task Type | Agent | Swarm |
 |---|---|---|
 | Full multi-angle review | reviewer + specialists | mesh 4 gossip balanced |
-| Security audit | Security Engineer + Code Reviewer | hive-mind hierarchical-mesh byzantine 6 |
-| Code review only | Code Reviewer | hierarchical 3 raft specialized |
+| Security audit | Security Engineer + reviewer | hive-mind hierarchical-mesh byzantine 6 |
+| Code review only | reviewer | hierarchical 3 raft specialized |
 | Strategy review | analyst + researcher | mesh 3 gossip balanced |
-| Content review | Code Reviewer (content) | single agent |
+| Content review | reviewer (content) | single agent |

package/.claude/skills/mastermind-routine-detail/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-routine-detail
 description: Mastermind routine-detail — deep inspection and management of a single routine: trigger config (schedule/webhook), variables, concurrency/catchup policies, run history, webhook rotation, and revision tracking.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 # Mastermind Routine Detail
 
-This skill is invoked by `mastermind:routine-detail` or directly via `/mastermind:routine-detail`.
+This skill is invoked by `mastermind:routine-detail` or directly via `/mastermind-routine-detail`.
 
 ---
 

package/.claude/skills/mastermind-routines/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-routines
 description: Mastermind routines — schedule recurring tasks that trigger agent heartbeats on a cron-like schedule within a running org. Configure concurrency policy and catch-up behavior.
 type: domain-skill
 default_mode: confirm
+pick: low
 ---
 
 # Mastermind Routines
 
-This skill is invoked by `mastermind:routines` or directly via `/mastermind:routines`.
+This skill is invoked by `mastermind:routines` or directly via `/mastermind-routines`.
 
 ---
 
@@ -103,7 +104,7 @@ echo "Routine added: $routine_id"
 echo "Schedule: $schedule"
 echo ""
 echo "NOTE: To activate this routine, use ScheduleWakeup with:"
-echo "  prompt: '/mastermind:routines --action trigger --org $org_name --routine-id $routine_id'"
+echo "  prompt: '/mastermind-routines --action trigger --org $org_name --routine-id $routine_id'"
 echo "  delaySeconds: <seconds until next scheduled run>"
 ```
 

package/.claude/skills/mastermind-search/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-search
 description: Mastermind search — fuzzy cross-org search across tasks, goals, agents, approvals, routines, projects, and activity log. Returns ranked results with org context.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 # Mastermind Search
 
-This skill is invoked by `mastermind:search` or directly via `/mastermind:search`.
+This skill is invoked by `mastermind:search` or directly via `/mastermind-search`.
 
 ---
 

package/.claude/skills/mastermind-secrets/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-secrets
 description: Mastermind secrets — manage org-scoped API keys and secrets consumed by agents. Store, rotate, list, and audit secrets without exposing values in logs or state files.
 type: domain-skill
 default_mode: confirm
+pick: low
 ---
 
 # Mastermind Secrets
 
-This skill is invoked by `mastermind:secrets` or directly via `/mastermind:secrets`.
+This skill is invoked by `mastermind:secrets` or directly via `/mastermind-secrets`.
 
 ---
 
@@ -91,7 +92,7 @@ chmod 700 "$secretDir"
 
 # Write value from env var reference — NEVER inline
 if [ -z "${secret_value}" ]; then
-  echo "ERROR: Pass the secret value as an env var: secret_value=\$MY_VAR /mastermind:secrets --action set"
+  echo "ERROR: Pass the secret value as an env var: secret_value=\$MY_VAR /mastermind-secrets --action set"
   exit 1
 fi
 

package/.claude/skills/mastermind-skills/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-skills
 description: Mastermind skills — list, sync, and map skills available to org agents. Scans .claude/skills/ directory and shows which roles have access to which skill domains.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 # Mastermind Skills
 
-This skill is invoked by `mastermind:skills` or directly via `/mastermind:skills`.
+This skill is invoked by `mastermind:skills` or directly via `/mastermind-skills`.
 
 ---
 

package/.claude/skills/mastermind-stoporg/SKILL.md

@@ -3,6 +3,7 @@ name: mastermind-stoporg
 description: Mastermind stoporg — stop a running scheduled org loop by setting its status to "stopped". The next scheduled wakeup will read the status, skip all work, and not reschedule. Loop dies within one interval — no orphaned wakeups.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 # Mastermind Stop Org

package/.claude/skills/mastermind-tasks/SKILL.md

@@ -3,16 +3,17 @@ name: mastermind-tasks
 description: Mastermind tasks — view, create, assign, and move tasks on an org's task board. Supports parent-child chains, goal linkage, and status filtering.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 > **LEGACY-ORG-V1 — writes to a monotask board, not to `<org>-issues.json`.** This skill's
 > `parent_id`, `status` (`todo | doing | done`), and card model belong to the pre-v2
 > board-backed runner. For v2 issue tracking — including sub-issues — use
-> `/mastermind:issues --action create --parent-id <id>`.
+> `/mastermind-issues --action create --parent-id <id>`.
 
 # Mastermind Tasks
 
-This skill is invoked by `mastermind:tasks` or directly via `/mastermind:tasks`.
+This skill is invoked by `mastermind:tasks` or directly via `/mastermind-tasks`.
 
 ---
 

package/.claude/skills/mastermind-threads/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-threads
 description: Mastermind threads — list, view, and create conversation threads within an org. Threads are human-or-agent discussions attached to issues, goals, or the org itself. Reads from -threads.jsonl org state files.
 type: domain-skill
 default_mode: auto
+pick: low
 ---
 
 # Mastermind Threads
 
-This skill is invoked by `mastermind:threads` or directly via `/mastermind:threads`.
+This skill is invoked by `mastermind:threads` or directly via `/mastermind-threads`.
 
 ---
 
@@ -54,7 +55,7 @@ echo "────────────────────────
 if [ ! -f "$threadsFile" ] || [ ! -s "$threadsFile" ]; then
   echo "  No threads found."
   echo ""
-  echo "  Create: /mastermind:threads --org $org_name --action create --message 'Hello team'"
+  echo "  Create: /mastermind-threads --org $org_name --action create --message 'Hello team'"
   exit 0
 fi
 
@@ -94,7 +95,7 @@ else:
         created = (t.get("createdAt") or "-")[:10]
         print(f"  {tid:<28} {subj:<32} {author:<20} {msgs:<6} {created}")
 
-print(f"\n  {len(threads)} thread(s). View: /mastermind:threads --org <org> --action view --thread-id <id>")
+print(f"\n  {len(threads)} thread(s). View: /mastermind-threads --org <org> --action view --thread-id <id>")
 PYEOF
 ```
 

package/.claude/skills/mastermind-tree-control/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-tree-control
 description: Mastermind tree-control — pause, hold, release, or preview recovery for an issue/task tree in an org. Lets board members stop runaway loops, hold trees during review, and resume work when ready. Mirrors Paperclip's issue-tree-control API.
 type: domain-skill
 default_mode: confirm
+pick: low
 ---
 
 # Mastermind Tree Control
 
-This skill is invoked by `mastermind:tree-control` or directly via `/mastermind:tree-control`.
+This skill is invoked by `mastermind:tree-control` or directly via `/mastermind-tree-control`.
 
 ---
 
@@ -94,8 +95,8 @@ print()
 print(f"  Active issues in subtree: {len(active)}")
 print(f"  Holding root would affect all {len(active)} active issue(s).")
 print()
-print("  To hold: /mastermind:tree-control --org <org> --action hold --issue-id <id> --reason 'Review needed'")
-print("  To cancel: /mastermind:tree-control --org <org> --action cancel --issue-id <id> --reason 'No longer needed'")
+print("  To hold: /mastermind-tree-control --org <org> --action hold --issue-id <id> --reason 'Review needed'")
+print("  To cancel: /mastermind-tree-control --org <org> --action cancel --issue-id <id> --reason 'No longer needed'")
 PYEOF
 ```
 
@@ -140,7 +141,7 @@ print(f"  Reason: {reason}")
 print(f"  Applied: {ts}")
 print()
 print("  Active agents should detect the hold and pause execution.")
-print(f"  To release: /mastermind:tree-control --org <org> --action release --issue-id {rootId}")
+print(f"  To release: /mastermind-tree-control --org <org> --action release --issue-id {rootId}")
 PYEOF
 ```
 

package/.claude/skills/mastermind-workspace-detail/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-workspace-detail
 description: Mastermind workspace-detail — deep per-execution-workspace inspection and runtime control. Manage services, provision/teardown/cleanup commands, linked issues and routines, runtime logs, and configuration for a single execution workspace.
 type: domain-skill
 default_mode: confirm
+pick: low
 ---
 
 # Mastermind Workspace Detail
 
-This skill is invoked by `mastermind:workspace-detail` or directly via `/mastermind:workspace-detail`.
+This skill is invoked by `mastermind:workspace-detail` or directly via `/mastermind-workspace-detail`.
 
 ---
 
@@ -54,7 +55,7 @@ orgFile=".monomind/orgs/${org_name}.json"
 [ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
 
 wsFile=".monomind/orgs/${org_name}-workspaces.json"
-[ ! -f "$wsFile" ] && { echo "ERROR: No workspaces file for org '$org_name'. Create workspaces via /mastermind:workspaces."; exit 1; }
+[ ! -f "$wsFile" ] && { echo "ERROR: No workspaces file for org '$org_name'. Create workspaces via /mastermind-workspaces."; exit 1; }
 
 wsDef=$(jq -r --arg id "$workspace_id" '(.workspaces // [])[] | select(.id == $id)' "$wsFile")
 [ -z "$wsDef" ] && { echo "ERROR: Workspace '$workspace_id' not found in org '$org_name'."; exit 1; }
@@ -256,7 +257,7 @@ else
 fi
 
 echo ""
-echo "To run a routine with workspace vars: /mastermind:routine-detail --org $org_name --routine-id <id> --action variables"
+echo "To run a routine with workspace vars: /mastermind-routine-detail --org $org_name --routine-id <id> --action variables"
 ```
 
 ### config

package/.claude/skills/mastermind-workspaces/SKILL.md

@@ -3,11 +3,12 @@ name: mastermind-workspaces
 description: Mastermind workspaces — manage isolated git worktree workspaces per project. List, attach, detach, stop, and prune workspaces. Grouped by project with running service counts and agent assignments.
 type: domain-skill
 default_mode: confirm
+pick: low
 ---
 
 # Mastermind Workspaces
 
-This skill is invoked by `mastermind:workspaces` or directly via `/mastermind:workspaces`.
+This skill is invoked by `mastermind:workspaces` or directly via `/mastermind-workspaces`.
 
 ---
 

package/.claude/skills/monoswarm/SKILL.md

@@ -99,11 +99,13 @@ Common assignments (see `doc/concepts/monoswarm.md` for the full routing table):
 | Task | Recommended agents |
 |---|---|
 | Bug fix | coordinator, researcher, coder, tester |
-| Feature | coordinator, architect, coder, tester, reviewer |
-| Refactor | coordinator, architect, coder, reviewer |
-| Performance | coordinator, performance-engineer, coder |
-| Security | coordinator, security-architect, security-auditor |
-| Docs | researcher, documenter |
+| Feature | coordinator, Software Architect, coder, tester, reviewer |
+| Refactor | coordinator, Software Architect, coder, reviewer |
+| Performance | coordinator, Performance Benchmarker, coder |
+| Security | coordinator, Security Engineer, reviewer |
+| Docs | researcher, Technical Writer |
+
+These are real agent names (Task `subagent_type`). For a task-specific pick use the prompt's `[PICK]` line or `mcp__monomind__pick`.
 
 ## Workflow Patterns
 

package/.claude/skills/specialagent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: specialagent
-description: Find the single best specialized agent from the verified ~98-agent roster using two-stage LLM domain→agent selection
+description: Find the single best specialized agent for a task — the [PICK] line or the shared pick index (mcp__monomind__pick / monomind pick), with a two-stage domain→agent fallback over the installed agents
 version: 2.0.0
 triggers:
   - /specialagent
@@ -18,87 +18,68 @@ triggers:
   - which swarm agent
 tools:
   - Bash
+pick: low
 ---
 
-# /specialagent — Two-Stage LLM Agent Selection
+# /specialagent — Best Agent for a Task
 
-Finds the best agent using a lightweight two-stage LLM approach: first pick the domain, then pick the agent within that domain. Only names are passed at each stage — no descriptions, no keyword dumps.
+Finds the best installed agent for a task. Never recommend from memory or from a hardcoded roster: the agent set differs per install, and a `subagent_type` that is not installed fails at spawn time.
 
-## How It Works
+## Step 1: Use the pick index
 
-```
-Stage 1: Give LLM domain names → LLM picks best domain
-Stage 2: Give LLM agent names in that domain → LLM picks best agent
-```
+In this order, stop at the first that answers:
 
-## Stage 1: Domain Selection
+1. **`[PICK]` line** — if the prompt carries `[PICK] agent: <name> · skill: <invoke>`, recommend that agent unless it is clearly wrong for the task.
+2. **`mcp__monomind__pick({ task: "<task>", kind: "agents", top: 5 })`** — choose the best fit among `agents.ranked[]` (prefer the top entry unless another is clearly more specific). Each `name` is a spawnable `subagent_type`.
+3. **Local CLI** — `monomind pick -t "<task>" --top 5 --json | jq -r '.agents.ranked[].name'` (local binary only, never npx; see `mastermind-agent-select/SKILL.md` for the version-checked `mmpick` helper).
 
-The verified roster is ~98 agent definitions (97 registered in `packages/@monomind/cli/.monomind/registry.json`). Domains and representative agents from each:
+## Step 2 (fallback): Two-stage domain → agent selection
 
-| Domain | Representative agents (NOT exhaustive — run `ls .claude/agents/` for the full set) |
-|---|---|
-| development | coder · Backend Architect · Frontend Developer · mobile-dev · Mobile App Builder · Rapid Prototyper · Software Architect · Senior Developer · AI Engineer · Data Engineer · Database Optimizer · AI Data Remediation Engineer · LSP/Index Engineer · Embedded Firmware Engineer · Solidity Smart Contract Engineer · WeChat Mini Program Developer · Feishu Integration Developer · Model QA Specialist |
-| testing | tester · tdd-london-swarm · production-validator · API Tester · Accessibility Auditor · Evidence Collector · Performance Benchmarker · Test Results Analyzer · Tool Evaluator · Workflow Optimizer · Code Reviewer |
-| security | Security Engineer · Compliance Auditor · Blockchain Security Auditor · Threat Detection Engineer · Agentic Identity & Trust Architect · Identity Graph Operator · ZK Steward |
-| devops | DevOps Automator · SRE (Site Reliability Engineer) · Git Workflow Master · Incident Response Commander |
-| architecture | system-architect · Software Architect · Backend Architect · Workflow Architect · Autonomous Optimization Architect · Automation Governance Architect · v1-integration-architect |
-| research | researcher · Technical Writer · Developer Advocate · goal-planner |
-| marketing | Competitive Content Strategist · CRO Specialist · Email Marketing Specialist · Launch Strategist · Pricing Strategist |
-| design | Monodesign · Cultural Intelligence Strategist |
-| github | pr-manager · issue-tracker · release-manager · repo-architect · code-review-swarm · multi-repo-swarm · sync-coordinator · workflow-automation · project-board-sync |
-| swarm / consensus | mesh-coordinator · collective-intelligence-coordinator · scout-explorer · swarm-memory-manager · worker-specialist · coordinator · planner · smart-agent · swarm-init · quorum-manager |
-| optimization | Benchmark Suite · Load Balancing Coordinator · Performance Monitor · Resource Allocator · Topology Optimizer |
-| specialized | MCP Builder · Document Generator · Agents Orchestrator · dashboard-verifier |
+Only when Step 1 returned nothing. Only names are passed at each stage — no descriptions, no keyword dumps.
 
-**The filesystem is authoritative** — run `ls .claude/agents/` (and `ls packages/@monomind/cli/.claude/agents/`) for the current full list; agents are added over time. Only recommend agents that actually exist there.
+```
+Stage 1: Give LLM the category names → LLM picks the best category
+Stage 2: Give LLM the agent names installed in that category → LLM picks the best agent
+```
 
-**Stage 1 prompt to yourself:**
-> "Given the task: `<task>` — which single domain from this list best fits: development, testing, security, devops, architecture, research, marketing, design, github, swarm, optimization, specialized? Answer with just the domain name."
+Categories are the `.claude/agents/` folder names: `architecture consensus core design engineering github goal marketing monoswarm optimization specialists specialized templates testing`.
+
+List the installed agent names in a category from the registry (or the definitions on disk):
 
-## Stage 2: Agent Selection Per Domain
+```bash
+CAT="engineering"
+jq -r --arg c "$CAT" '.agents[] | select(.category == $c and .deprecated != true) | .name' .monomind/registry.json 2>/dev/null \
+  || grep -h -m1 "^name:" packages/@monomind/cli/.claude/agents/$CAT/*.md .claude/agents/$CAT/*.md 2>/dev/null | sed 's/^name: *//'
+```
 
-From the chosen domain's agents (table above), pick the best fit. **Before recommending, verify the name exists** as a `.md` file under `.claude/agents/` (or `packages/@monomind/cli/.claude/agents/`). If the name you want is not on disk, fall back to another agent in the domain or to a core agent (`coder`, `reviewer`, `tester`, `researcher`, `planner`).
+**Stage 1 prompt to yourself:**
+> "Given the task: `<task>` — which single category from this list best fits: `<category names>`? Answer with just the category name."
 
 **Stage 2 prompt to yourself:**
-> "Given the task: `<task>` — which single agent from this domain's list is the best fit: `<comma-separated agent names for the selected domain>`? Answer with just the agent name."
+> "Given the task: `<task>` — which single agent from this category is the best fit: `<agent names listed above>`? Answer with just the agent name."
 
-## Execution Steps
-
-1. Read the user's task
-2. **Stage 1**: Internally reason through the domain list → select one domain
-3. **Stage 2**: Internally reason through agent names in that domain → select one agent
-4. Verify the agent exists: `ls .claude/agents/**/<slug>.md` (names double as slugs; confirm via the frontmatter `name:` field)
-5. Output the recommendation
+If both stages come up empty, fall back to a core agent: `coder`, `reviewer`, `tester`, `researcher`, `planner`.
 
 ## Slug Mapping
 
-Agent names double as their `subagent_type` slug — the slug is the agent's frontmatter `name` (or the filename without `.md`). Resolve a name to its slug from the definition on disk:
-
-```bash
-# list every available agent definition
-ls .claude/agents/ packages/@monomind/cli/.claude/agents/
-# read a specific agent's registered name
-grep -m1 "^name:" .claude/agents/**/<file>.md
-```
-
-If unsure, pass the agent name as the slug. The authoritative set is whatever currently exists in those directories (~98 definitions).
+The `subagent_type` is the agent's frontmatter `name:` — what the pick index returns as `name`, and what the registry lists as `.name`.
 
 ## Output Format
 
 ```
 TASK: <one-line task summary>
 
-DOMAIN: <selected domain>
+PICKED BY: <[PICK] line | mcp__monomind__pick | monomind pick | category fallback: <category>>
 
 RECOMMENDED AGENT: <Agent Name>
-Invoke: Task({ subagent_type: "<slug>", prompt: "..." })
+Invoke: Task({ subagent_type: "<agent name>", prompt: "..." })
 ```
 
 Then ask: "Should I spawn this agent now?"
 
 ## Rules
 
-1. Only pass names at each stage — no descriptions, no keyword dumps, no scoring tables
-2. Pick exactly one domain, then exactly one agent
+1. Prefer the pick index; in the fallback, only pass names at each stage — no descriptions, no keyword dumps, no scoring tables
+2. Recommend exactly one agent, and only a name that is installed
 3. For tasks that clearly need a specialized tool (e.g. accessibility audits → Accessibility Auditor, not tester), prefer the more specific agent
 4. Never recommend a generic role (coder, tester) when a specialized agent in the right domain exists

package/README.md

@@ -414,7 +414,7 @@ Everything runs from inside Claude Code via slash commands. Here's the highlight
 | Package | npm | Purpose |
 |---|---|---|
 | `monomind` | [![npm](https://img.shields.io/npm/v/monomind?style=flat-square&color=00D2AA)](https://www.npmjs.com/package/monomind) | Umbrella shim — **install this one** |
-| `@monoes/monomindcli` | [![npm](https://img.shields.io/npm/v/@monoes/monomindcli?style=flat-square&color=4F46E5)](https://www.npmjs.com/package/@monoes/monomindcli) | CLI engine (38 commands, MCP server) |
+| `@monoes/monomindcli` | [![npm](https://img.shields.io/npm/v/@monoes/monomindcli?style=flat-square&color=4F46E5)](https://www.npmjs.com/package/@monoes/monomindcli) | CLI engine (32 commands, MCP server) |
 | `@monoes/monograph` | [![npm](https://img.shields.io/npm/v/@monoes/monograph?style=flat-square&color=F59E0B)](https://www.npmjs.com/package/@monoes/monograph) | Code knowledge graph (tree-sitter + SQLite) |
 | `@monoes/memory` | [![npm](https://img.shields.io/npm/v/@monoes/memory?style=flat-square&color=8B5CF6)](https://www.npmjs.com/package/@monoes/memory) | Persistent memory backends (SQLite + vectors) |
 | `@monoes/hooks` | [![npm](https://img.shields.io/npm/v/@monoes/hooks?style=flat-square&color=10B981)](https://www.npmjs.com/package/@monoes/hooks) | Hook registry + 9 on-demand workers |

package/dist/src/agents/registry-builder.d.ts

@@ -8,6 +8,11 @@ type AgentRegistryEntry = {
     version: string;
     category: string;
     description: string;
+    /** One-line `when_to_use:` frontmatter — the picker's lead description. */
+    whenToUse?: string;
+    tags: string[];
+    /** Optional `vibe:` frontmatter (personality line), ranked as extra text. */
+    vibe?: string;
     capabilities: string[];
     taskTypes: string[];
     tools: string[];
@@ -19,11 +24,19 @@ type AgentRegistryEntry = {
     registeredAt: string;
     lastUpdated: string;
 };
-type AgentRegistry = {
+/** A slug defined more than once: the first file kept, the others dropped. */
+export type DuplicateSlug = {
+    slug: string;
+    kept: string;
+    dropped: string[];
+};
+export type AgentRegistry = {
     version: string;
     generatedAt: string;
     totalAgents: number;
     agents: AgentRegistryEntry[];
+    /** Duplicate slugs found while building (first root / first file wins). */
+    duplicates: DuplicateSlug[];
 };
 /**
  * Build the agent registry by scanning `.md` files under `agentsRoot`.
@@ -59,6 +72,14 @@ export declare function computeAgentRoots(cwd: string): string[];
  * @param outputPath - Optional path to write the merged registry JSON file.
  * @returns The deduplicated AgentRegistry.
  */
-export declare function buildUnifiedRegistry(roots: string[], outputPath?: string): AgentRegistry;
+export declare function buildUnifiedRegistry(roots: string[], outputPath?: string, opts?: {
+    base?: string;
+}): AgentRegistry;
+/**
+ * Atomically writes `registry` to `file` — except an empty registry never
+ * replaces a non-empty one (a build from a directory without agent files must
+ * not wipe the project's catalog). Returns whether the file was written.
+ */
+export declare function writeRegistryFile(file: string, registry: AgentRegistry): boolean;
 export {};
 //# sourceMappingURL=registry-builder.d.ts.map

package/dist/src/agents/registry-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry-builder.d.ts","sourceRoot":"","sources":["../../../src/agents/registry-builder.ts"],"names":[],"mappings":"AASA,KAAK,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;CAAE,CAAC;AAC5E,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AACF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B,CAAC;AA2NF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAkDxF"}
+{"version":3,"file":"registry-builder.d.ts","sourceRoot":"","sources":["../../../src/agents/registry-builder.ts"],"names":[],"mappings":"AASA,KAAK,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;CAAE,CAAC;AAC5E,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AACF,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,2EAA2E;IAC3E,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B,CAAC;AA4OF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAEpF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3B,aAAa,CA+Df;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAMhF"}