What is a subagent in Claude Code?

A subagent is an autonomous AI assistant with its own configuration that operates in a separate context window to perform specialized tasks without cluttering the main conversation.

How do I choose the right model for a subagent?

Claude Haiku is recommended for data analysis and validation to save costs, while Sonnet is the balanced default for coding tasks. Opus is reserved for the most complex reasoning requirements.

When should I use a subagent instead of the main conversation?

Use subagents for self-contained tasks, background work, or processes that generate high volumes of logs and data that would otherwise exhaust the main context window.

What are common subagent design anti-patterns?

Avoid vague role descriptions, granting unnecessary tool permissions, using system prompts longer than 5000 characters, and creating subagents with overlapping responsibilities.

Subagent Design Patterns

Name: Subagent Design Patterns
Author: v1truv1us

byv1truv1us

0•

Productivity & Workflow

Optimizes the architecture and performance of autonomous Claude subagents through proven design principles and standardized patterns.

Subagent Design Patterns provides a strategic framework for creating specialized, autonomous AI assistants within the Claude Code environment. It offers essential guidance on role definition, tool permission strategies, and model selection to ensure subagents are efficient, cost-effective, and capable of handling self-contained tasks without context bloat. By implementing these standardized patterns—such as Reviewers, Analyzers, and Fixers—developers can build more reliable multi-agent workflows that minimize errors and maximize output quality.

Key Features

010 GitHub stars

02Cost-effective model selection guidance (Haiku vs. Sonnet vs. Opus)

03Best practices to avoid context bloat and common anti-patterns

04Optimized tool access strategies for security and efficiency

05Defined role clarity and trigger boundaries for autonomous agents

06Standardized subagent patterns for reviewers, analyzers, and generators

Use Cases

01Creating secure, read-only subagents for sensitive documentation reviews

02Structuring parallel workflows for complex data processing tasks

03Designing specialized background agents for large-scale code analysis

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add v1truv1us/plugin-marketplace subagent-design-patterns

For use in Claude.ai and ChatGPT

Download Skill