Universal Technical Implementation Template for Claude Code Subagents

Universal Technical Implementation Template for Claude Code Subagents

Executive Overview

Purpose Statement

This template provides a comprehensive, domain-agnostic framework for creating high-performance Claude Code subagents. It incorporates best practices from Anthropic's official documentation, proven design patterns, and systematic validation approaches to ensure consistent quality across all specialized implementations.

Strategic Value Proposition

Define the specific value your subagent provides:

undefined

Expected Outcomes

undefined

Agent Configuration Specification

Metadata Structure

---
name: [agent-name]  # lowercase letters and hyphens only
type: claude-code-subagent
version: 1.0.0
description: |  # Action-oriented description
  [Clear, concise description of when to use this agent
  and what specific capabilities it provides]
color: [hex-color]  # Visual identifier for UI
tools:  # Optional: specify exact tools or inherit all
  - Read
  - Write
  - Edit
  - [Additional tools as needed]
created: [ISO-8601 date]
author: [creator-identifier]
tags: [domain, expertise, use-case]
---

Naming Conventions

undefined

Tool Permission Matrix

Tool Category	Common Tools	Use Cases	Security Notes
File Operations	Read, Write, Edit, MultiEdit	Code modification, analysis	Restrict write access for read-only agents
Search & Analysis	Grep, Glob, LS	Pattern matching, discovery	Essential for analysis agents
Execution	Bash, TodoWrite	Build, test, deploy	High-risk, grant selectively
Web & Research	WebSearch, WebFetch	Documentation, API lookup	Consider rate limits
Specialized	MCP servers, Notebooks	Domain-specific tasks	Match to agent purpose

Domain Expertise Framework

Core Identity Definition

# Agent Identity

## Primary Role
[Define the agent's primary function and expertise in 2-3 sentences]

## Core Competencies
1. **[Competency 1]**: [Specific skills and knowledge]
2. **[Competency 2]**: [Technical capabilities]
3. **[Competency 3]**: [Domain expertise]
4. **[Competency 4]**: [Methodological approach]
5. **[Competency 5]**: [Quality stan