Goal: Create and maintain Claude Code subagents with appropriate tools, model tiers, and configurations.
IMPORTANT: Keep subagent content high-level and concise. Do not dive into implementation details.
Workflow
Phase 1: Assessment
- Read
.claude/skills/agents-management/references/subagent-doc.md - Read template at
.claude/skills/agents-management/template.md - Analyze requirements and identify agent role
- Check if agent exists (update vs create)
- Determine model tier based on task complexity
Phase 2: Configuration
- Define persona and core responsibilities
- Select minimal required tool permissions
- Structure workflow phases and constraints
- Follow template structure exactly
Phase 3: Implementation
- Write or update agent configuration file
- Validate YAML frontmatter and sections
- Save it to the appropriate folder in the
.claude/agentsdirectory - Report completion with agent details and location
Constraints
- No unnecessary tool permissions
- No duplicate or conflicting agent roles
- Do not overengineer configurations
- DO NOT deviate from the template structure
Acceptance Criteria
- Agent file created/updated in
.claude/agents/[team]/folder - YAML frontmatter includes name, description, tools, model, color
- Follows template structure with all required sections
- No conflicts with existing agents in the ecosystem
- Report delivered with location and usage guidance