mastermind-agents

name	mastermind-agents
description	Mastermind agents — list, inspect, hire, pause, and remove agents in a running org. Shows status, last heartbeat, adapter config, and burn rate per agent.
type	domain-skill
default_mode	confirm

Mastermind Agents

This skill is invoked by mastermind:agents or directly via /mastermind:agents.

---

Inputs

• brain_context: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
• org_name: org to inspect (optional — lists all orgs if omitted)
• action: list | hire | pause | resume | remove | inspect
• agent_id: role id or agent slug (required for inspect/pause/resume/remove)
• caller: command | master

---

Step 0 — Brain Load (standalone only)

If caller is not "command", load brain context following mastermind-protocol/SKILL.md Brain Load Procedure with namespace: ops.

---

Step 1 — Resolve Org

If org_name is provided, load .monomind/orgs/<org_name>.json. Otherwise list all orgs:

ls .monomind/orgs/*.json 2>/dev/null | grep -vE -- '-approvals|-state|-activity|-goals|-routines|-projects|-members|-issues|-workspaces|-worktrees|-environments|-plugins|-adapters|-bootstrap|-threads|-budgets|-project-workspaces|-approval-comments' | xargs -I{} basename {} .json

If no orgs exist, print: "No orgs found. Run /mastermind:createorg to define one."

---

Step 2 — Execute Action

list (default)

Display all agents in the org with status from state file:

orgFile=".monomind/orgs/${org_name}.json"
stateFile=".monomind/orgs/${org_name}-state.json"

jq -r '(.roles // [])[] | "• [\(.id)] \(.title)  agent=\(.agent_type)  reports_to=\(.reports_to // "none")"' "$orgFile"

# LEGACY-ORG-V1: the state file's per-agent heartbeat tracking is a v1 concept —
# v2 orgs report live status via `monomind org status`/`org report` instead.
# Overlay runtime status from state file if present
if [ -f "$stateFile" ]; then
  echo ""
  echo "RUNTIME STATUS:"
  jq -r '.agents // {} | to_entries[] | "  \(.key): \(.value.status // "unknown")  last_beat=\(.value.last_heartbeat // "never")"' "$stateFile" 2>/dev/null || true
fi
# end LEGACY-ORG-V1

Render as table:

AGENTS — org: <org_name>
──────────────────────────────────────────────────────
ID              TITLE              AGENT TYPE          STATUS        LAST HEARTBEAT
boss            CEO / Boss         coordinator         running       2 min ago
content-writer  Content Writer     Content Creator     idle          8 min ago
reviewer        Content Reviewer   reviewer            waiting       8 min ago
...

inspect

Show full config + responsibilities + communication edges for a single agent:

jq --arg id "$agent_id" '(.roles // [])[] | select(.id == $id)' "$orgFile"
jq --arg id "$agent_id" '(.communication // [])[] | select(.from == $id or .to == $id)' "$orgFile"

hire

Add a new role to the org. Prompt the user for:

• id (slug, e.g. seo-lead), title (display name), agent_type (from mapping table in createorg.md), responsibilities (comma-separated), reports_to (role id or null)

Adapter/model selection — present this picker:

ADAPTER / MODEL
───────────────
Available Claude models:
  1. claude-sonnet-4-6    → balanced capability + speed (Recommended)
  2. claude-opus-4-7      → highest capability, slower
  3. claude-haiku-4-5     → fastest, lowest cost

Enter choice [1]:

Set adapter_config.model from selection. Default: claude-sonnet-4-6.

Append to .monomind/orgs/<org_name>.json roles array using jq:

# model from adapter picker (default: claude-sonnet-4-6)
adapter_model="${selected_model:-claude-sonnet-4-6}"

tmp="${orgFile}.tmp"
jq --arg id "$agent_id" \
   --arg title "$title" \
   --arg agent_type "$agent_type" \
   --arg reports_to "${reports_to:-}" \
   --arg model "$adapter_model" \
   --argjson resp "$(echo "$responsibilities" | jq -R 'split(",") | map(ltrimstr(" "))')" \
   '.roles += [{"id":$id,"title":$title,"agent_type":$agent_type,
     "responsibilities":$resp,
     "reports_to":($reports_to|if .=="" then null else . end),
     "adapter_config":{"model":$model,"max_tokens":8192}}]' \
   "$orgFile" > "$tmp" && mv "$tmp" "$orgFile"
echo "Hired: $title ($agent_type) → adapter: $adapter_model"

Then emit org:agent:hired event to dashboard:

REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
CTRL_URL=$(jq -r '.url // "http://localhost:4242"' "$REPO_ROOT/.monomind/control.json" 2>/dev/null || echo "http://localhost:4242")
curl -s -X POST "${CTRL_URL}/api/mastermind/event" -H "x-monomind-token: $(cat "${REPO_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}/.monomind/dashboard-token" 2>/dev/null || true)" \
  -H "Content-Type: application/json" \
  -d "$(jq -cn --arg org "$org_name" --arg role "$agent_id" --arg title "$title" \
    '{type:"org:agent:hired",org:$org,role:$role,title:$title,ts:(now*1000|floor)}')" || true

pause / resume

Update state file:

stateFile=".monomind/orgs/${org_name}-state.json"
[ ! -f "$stateFile" ] && echo '{"agents":{}}' > "$stateFile"
tmp="${stateFile}.tmp"
jq --arg id "$agent_id" --arg status "paused" \
  '.agents[$id].status = $status | .agents[$id].updated_at = (now|todate)' \
  "$stateFile" > "$tmp" && mv "$tmp" "$stateFile"

Emit org:agent:paused / org:agent:resumed event.

remove

Confirm with user, then remove role from org config:

tmp="${orgFile}.tmp"
jq --arg id "$agent_id" '.roles = [(.roles // [])[] | select(.id != $id)] | .communication = [(.communication // [])[] | select(.from != $id and .to != $id)]' \
  "$orgFile" > "$tmp" && mv "$tmp" "$orgFile"

---

Step 3 — Return Output

domain: ops
status: complete
action: <action>
org: <org_name>
agents_count: <N>

Print summary and any suggested next actions (e.g. "Run /mastermind:heartbeatv1 to trigger a manual heartbeat for this agent").

---

Step 4 — Brain Write (standalone only)

If caller is not "command", follow mastermind-protocol/SKILL.md Brain Write Procedure for domain ops.