Sub-Agent Collaboration | LanMate User Guide
Using the Qianxin edition of LanMate?View Qianxin Edition User Guide

Sub-Agent Collaboration

Mechanism

The main agent creates sub-agents for sub-tasks:

Model Tiering

Settings > Models > Sub-agent tiers:

Tier Best for Recommended model
Simple Research, information gathering, format validation A cheap model
Standard Daily coding, document writing, routine analysis A mid-tier model
Hard Complex reasoning, architecture design, multi-file refactoring A strong model

Unconfigured tiers follow the parent session model.

Sub-Agent Discipline

Two guardrails hold in every mode: dangerous operations always require confirmation, and sub-agent deletion is always forbidden.

Seven Sub-Agent Types

A type can be assigned when dispatching, each with its own tool domain and persona:

Type What it does What it can touch
explore Read-only research, small-model tier by default Read code and search; change nothing
review Read-only code review Read code and git history; change nothing
verify Verification: run tests, build, reproduce issues Read and execute, but no workspace writes
build Implementation: write code, edit files Inherits the parent’s full toolset (cannot spawn sub-agents)
craft Office output Docs/sheets/slides/PDF/OCR/transcription + images and video
vision Visual output Design canvas + images/video/charts
await Background watch: monitor a started background task to completion, report once Watch only, no changes, no new processes

Without a type, the sub-agent inherits the parent’s full toolset. You can also explicitly restrict its tools — permissions never exceed the main session’s.

Types show as badges next to each sub-agent’s name in the panel, so you can see who’s doing what at a glance.

Worktree Isolation and Snapshots

Coding sub-agents run in their own worktrees, so their changes never touch your main directory. Output is snapshot-protected and recoverable even after cleanup. See Git Worktrees.

Agent-to-Agent Collaboration

Sub-agent results flow back to the main session; the main session can also consult experts, and experts can send private messages to each other (with receipts). See Agent Communication.

Example

Do three things simultaneously: 1) Research competitor pricing 2) Organize monthly expenses 3) Write a product update announcement

Three sub-agents execute in parallel; the main agent aggregates.

External Sub-Agents

LanMate can connect external sub-agents (Codex / Claude Code). After configuring the external agent path in settings, the assistant can call them as needed.