---

name: agent-creator description: "Guide for creating Claude Code subagent files (.md). Use when: (1) Creating a new subagent, (2) Modifying or improving an existing agent, (3) Defining the agent's role scope or trigger conditions, (4) Configuring agent settings (model, tools, permissionMode). Includes templates, examples, and tool references."

Subagent Creation Guide

Writing Workflow

1. Copy Template: Copy structure from references/template.md
2. Reference Examples: Check similar patterns in references/example.md
3. Write Section by Section: Follow the guide below to write content
4. Select Tools: Choose necessary tools from references/tools.md
5. Verify Checklist: Final inspection

---

Storage Location

---

YAML Frontmatter

Required Fields

Optional Fields

Description Writing Pattern

Copydescription: "use proactively, Use this agent when: 1) condition1, 2) condition2, 3) condition3, 4) condition4. Additional explanation."

Description Writing Guidelines

• Must include use proactively: Include at the beginning of description for Claude to automatically delegate to the agent
• Numbered trigger conditions: List conditions in 1), 2), 3), 4) format after Use this agent when:
• Additional explanation: Add description of agent characteristics or execution method at the end

Model Selection Criteria

---

Required Body Sections

1. Role Introduction

CopyYou are a **{expert title}**. Based on {experience/expertise}, you perform {responsibilities}.

2. Core Roles and Responsibilities

Agent's main functions, automatic/manual execution, tools/references used

3. Role Scope Limitations (Important)

Prevent role overlap with other agents:

Copy### Items NOT reviewed
- ❌ {Items handled by other agents}

### Items reviewed
- ✅ {Items handled by this agent}

4. Task Execution Modes

• Mode 1 - Automatic Execution: Trigger conditions, automatically collected information
• Mode 2 - Manual Execution: User-specified scope

5. Required Work Procedures

Step-by-step process (specify tools, reference resources, decision criteria)

6. Output Language

CopyAll analysis results, comments, and reports are written in **Korean**.

---

Optional Sections

---

Checklist

Required Items

• Is name written in kebab-case?
• Does description specify trigger conditions in a numbered list?
• Does it follow the template structure?
• Was the example pattern referenced?

Optional Items

• Is model appropriately selected? (inherit recommended)
• Is tools restriction needed? (Tool Reference)
• Is permissionMode needed?

Quality Items

• Does the role scope not overlap with other agents?
• Are required work procedures clear step by step?
• Is the output language specified?

---

Reference Documents