🧩 Agents¶

Fourteen specialists. Scoped packs. No “hold the monorepo in your head” cosplay. 🎭

Roster 📋¶

ID	Tools	Output	When
`coordinator`	—	JSON actions	Pre-exec + each wave 🧭
`orchestrator`	—	decisions	Reserved
`context`	—	CONTEXT body	Run start 📝
`explorer`	✅	file map	Deep explore 🔎
`docs`	✅	docs map	Docs/API queries 📚
`architect`	—	design JSON	Large/refactor 🏛️
`planner`	—	plan JSON	Always 📋
`splitter`	—	tasks JSON	Always ✂️
`worker`	✅	status	Execute 🛠️
`deep`	✅	status	Multi-step 🧪
`reviewer`	—	approve JSON	Critic 🔍
`corrector`	✅	status	On reject 🔧
`tester`	✅	passed + commands	Real shell verify (pytest/go/smoke) ✅
`placeholder`	✅	status + gaps	Fill stubs / flag precise gaps 🩹
`escalate`	—	action JSON	HITL timeout arbitrator (retry/re-scope/…) ⚖️
`memory`	—	bullets	Learn 💾

⚖ @escalate

Fired only when a task hits max review retries and the human does not answer the escalate modal / /escalate within escalate_ask_timeout (default 30s). Override the specialist with escalate_timeout_agent (auto: escalate → reviewer → coordinator).

curl -s localhost:7420/api/agents | jq '.[].id'
# TUI: /agents

Custom agents ✨¶

.slmcode/agents/<id>.yaml or ~/.slmcode/agents/.

/agent new id=night-auditor title=Night provider=ollama model=qwen2.5-coder:14b
/agent edit worker model=qwen2.5-coder:14b
/agent show night-auditor

Fields: skills, model, provider, endpoint, tools, temperature, max_tokens, max_iter, system_prompt.

Different endpoints → unique backend keys (no accidental shared gateway).

Use anywhere in the pipeline¶

Custom agents are first-class:

Specialist mode — select them in Studio / mode: specialist
Board tasks — set role: night-auditor (dropdown lists all /api/agents)
Pipeline slots — insert before/after/replace any phase in .slmcode/pipeline.yaml

# .slmcode/pipeline.yaml
slots:
  - id: audit-explore
    agent: night-auditor
    after: explore
    input: |
      Review exploration for risks.
      {{exploration}}

→ Pipeline

Coordinator actions 🧭¶

{
  "summary": "Auth clear; tests missing",
  "actions": [
    {"type": "promote", "task_id": "T2", "text": "deps met"},
    {"type": "reassign", "task_id": "T3", "role": "deep"},
    {"type": "add_task", "text": "Add regression test", "role": "tester"},
    {"type": "note", "task_id": "T1", "text": "edge case"}
  ],
  "focus_files": ["pkg/foo.go"]
}

Air-traffic control, not pilot. Let workers fly the plane.

Delegating 📬¶

slmcode task add "Deep refactor auth" --role deep --column ready_to_dev
slmcode task delegate T1 docs

Project instructions 📜¶

Auto-loaded from:

AGENTS.md / AGENT.md
CLAUDE.md
.cursorrules
.slmcode/PROJECT.md

✨ Tiny AGENTS.md

# Agents
- Tiny, reviewable diffs
- No drive-by refactors
- Match existing style

→ 🦋 Skills · 🧠 Concepts

☀️ Made with ♥ by UnicoLab