1-example-agent

description

Guide through creating a new purpose-built agent for specialized tasks with proper configuration

Creating New Claude Code Agent: ${1:-example-agent}

I'll help you create a new purpose-built agent for specialized tasks, following your established agent configuration patterns.

Agent Configuration

Agent Name: ${1:-example-agent} (kebab-case format) Specialization Domain: ${2:-general-purpose} Model Preference: ${3:-sonnet} (Options: sonnet, opus, haiku - prefer sonnet for speed)

Agent Creation Process

Step 1: Define Agent Scope and Expertise

Core Questions to Answer:

• What specific domain expertise does this agent provide?
• When should users invoke this agent vs. general Claude?
• What tools are essential for this agent's function?
• What knowledge areas require deep, specialized context?

Step 2: Analyze Context Efficiency Potential

High Priority Candidates (Create Agent):

• Complex, multi-step workflows requiring specialized knowledge
• Domain-specific expertise (JIRA, testing, architecture, etc.)
• Repetitive tasks with established patterns and best practices
• Workflows requiring consistent methodology and quality standards
• Tasks that benefit from maintained context and state

Low Priority Candidates (Keep as Command):

• Simple, procedural workflows
• One-time or infrequent tasks
• Basic formatting or templating operations
• Tasks requiring minimal specialized knowledge

Step 3: Create Agent File Structure

File Location: /Users/tylerstapler/.claude/agents/${1:-example-agent}.md

Required YAML Frontmatter:

---
name: ${1:-example-agent}
description: Use this agent when [specific trigger conditions]. This agent should be invoked [when to use it based on context and examples].

Examples:
- <example>
  Context: [Situation description]
  user: "[Example user request]"
  assistant: "[Response showing agent invocation]"
  <commentary>
  [Explanation of why this agent is appropriate for this scenario]
  </commentary>
  </example>

tools: [list of required tools or * for all tools]
model: ${3:-sonnet}
---

Step 4: Define Agent Expertise and Methodology

Core Structure:

1. Mission Statement: Clear purpose and role definition
2. Key Expertise Areas: Domain-specific knowledge and competencies
3. Methodology/Process: Step-by-step approach for handling requests
4. Quality Standards: Non-negotiable requirements and success criteria
5. Best Practices: Domain-specific patterns and recommendations

Step 5: Implementation Template

Based on your inputs, here's the agent template:

---
name: ${1:-example-agent}
description: Use this agent when you need specialized ${2:-general-purpose} expertise. This agent should be invoked when [specific conditions that warrant specialized knowledge over general Claude capabilities].

Examples:
- <example>
  Context: User needs ${2:-general-purpose} assistance.
  user: "I need help with [specific ${2:-general-purpose} task]"
  assistant: "I'll use the ${1:-example-agent} agent to provide specialized ${2:-general-purpose} expertise"
  <commentary>
  Since this requires ${2:-general-purpose} domain knowledge, the ${1:-example-agent} agent is the appropriate choice.
  </commentary>
  </example>

tools: *
model: ${3:-sonnet}
---

You are a ${2:-general-purpose} specialist with deep expertise in [specific domain areas]. Your role is to provide expert-level assistance while maintaining [specific quality standards].

## Core Mission

[Define the primary purpose and value proposition of this agent]

## Key Expertise Areas

### **[Domain Area 1]**
- [Specific competency]
- [Related skill or knowledge]
- [Best practices and patterns]

### **[Domain Area 2]**  
- [Specific competency]
- [Related skill or knowledge]
- [Best practices and patterns]

## Methodology

### **Phase 1: [Process Step]**
[Description of what happens in this phase]

### **Phase 2: [Process Step]**
[Description of what happens in this phase]

### **Phase 3: [Process Step]**
[Description of what happens in this phase]

## Quality Standards

You maintain these non-negotiable standards:
- [Standard 1]: [Description and rationale]
- [Standard 2]: [Description and rationale]
- [Standard 3]: [Description and rationale]

## Professional Principles

- [Principle 1]: [How this guides your work]
- [Principle 2]: [How this guides your work]
- [Principle 3]: [How this guides your work]

Remember: [Key reminder about the agent's core purpose and value]

Current Agent Ecosystem

Existing Specialized Agents:

• pr-reviewer: Code review and software engineering best practices
• java-test-debugger: Java testing framework debugging and fixes
• github-debugger: GitHub Actions and CI/CD troubleshooting
• jira-project-manager: FBG JIRA and project management workflows
• knowledge-synthesis: Zettelkasten research and knowledge integration

Agent Design Principles

Context Efficiency Guidelines:

• High Specialization: Focus on narrow, deep expertise vs. broad knowledge
• Consistent Methodology: Establish repeatable processes and quality standards
• Tool Optimization: Include only tools essential for the domain
• Model Selection: Prefer sonnet for speed and efficiency; use opus only for extremely complex reasoning tasks; use haiku for simple tasks
• Clear Boundaries: Define exactly when to use this agent vs. general Claude

Usage Pattern Design:

• Trigger Conditions: Make it obvious when to invoke this agent
• Example Scenarios: Provide concrete examples with commentary
• Value Proposition: Clearly articulate why specialization matters
• Quality Standards: Define what makes this agent's output superior

Implementation Steps

1. Create Agent File: /Users/tylerstapler/.claude/agents/${1:-example-agent}.md
2. Define Specialization: Focus on specific domain expertise
3. Configure Tools: Include essential tools for the domain
4. Set Quality Standards: Define non-negotiable requirements
5. Test and Refine: Validate agent performance vs. general Claude
6. Document Usage: Update any relevant workflow documentation

Would you like me to create this ${1:-example-agent} agent now based on your specifications? Please confirm:

• Agent Name: ${1:-example-agent}
• Specialization Domain: ${2:-general-purpose}
• Model: ${3:-sonnet} (prefer sonnet for better performance)
• Specific Expertise Areas: [Please specify the key domains]
• Essential Tools: [Please specify required tools]