Subagents are specialized AI agents that operate with their own custom system prompt and isolated context window. They handle specific tasks delegated by the main agent without polluting the main conversation context.

What You’ll Learn

  • Understanding default subagents
  • Creating custom subagents
  • Managing subagent configurations
  • Manual invocation with @-mentions

Key Characteristics

  • Isolated Context: Each subagent maintains its own separate context window
  • Custom System Prompts: Every subagent has a dedicated system prompt defining its behavior
  • Manual Invocation: Users can explicitly reference subagents using @-mentions (e.g., @verifier)

Default Subagents

Verdent includes a built-in subagent that is pre-configured and immediately available.

@verifier

Specialization: Quick code checks and validation Capabilities:
  • Validates code logic
  • Checks syntax correctness
  • Verifies implementation against requirements
Usage:
@verifier check this authentication logic
Best For: Rapid validation without full code review overhead
@verifier can be configured to use a different model in Settings. Use a smaller, cheaper model for simple verification tasks.

Creating Custom Subagents

Create specialized subagents tailored to your workflow.
1

Navigate to Settings

Open Settings → Subagents
2

Add Subagent

Click Add Subagent
3

Configure

FieldDescription
NameIdentifier for @-mention invocation
DescriptionBrief explanation of purpose
PromptCustom system instructions
ModelSonnet 4.5, GPT-5, GPT-5-Codex, or Haiku 4.5

Managing Subagents

ActionDescription
Enable/DisableToggle subagent availability
DuplicateCreate a copy with existing settings
EditModify any configuration
DeleteRemove the subagent

Using Subagents

Manual Invocation

Use @-mentions to explicitly invoke a subagent:
@verifier check validation logic in middleware
Benefits of Manual Invocation:
  • Precision: Ensure exact subagent handles the task
  • Control: Choose specific subagent when multiple could apply
  • Consistency: Repeat tasks with same subagent for consistent results

When to Use @verifier

Task TypeExample
Quick validation@verifier check this logic
Syntax check@verifier validate this function
Implementation check@verifier verify this matches requirements

Subagent vs Main Agent

AspectSubagentMain Agent
ContextIsolated, focusedFull conversation context
SpeedFaster for specific tasksBetter for complex analysis
Best forValidation, reviewInvestigation, implementation

FAQs

Use subagents for quick, focused tasks like validation or code review. Use the main agent for complex investigations requiring full context.
No. Subagents have isolated context windows. Only the final results are returned to the main agent.
Yes. @verifier can be configured to use a different model in Settings for cost optimization.

See Also