AI Agents

Overview

Agents are specialized AI sub-agents that can be spawned to handle specific tasks autonomously. They operate with access to specific tools and are designed for complex, multi-step work.

Available Agents

Codebase Agents

codebase-locator

Purpose: Find files, directories, and components relevant to a feature or task Tools: Grep, Glob, LS Usage: Spawn when you need to locate code without analyzing contents

codebase-analyzer

Purpose: Analyze implementation details and understand how components work Tools: Read, Grep, Glob, LS Usage: Spawn when you need to understand existing code implementation

codebase-pattern-finder

Purpose: Find similar implementations, usage examples, and patterns to model after Tools: Grep, Glob, Read, LS Usage: Spawn when implementing new features to find existing patterns

Agent Definition Format

Agents are defined in Markdown files with frontmatter:

---
name: agent-name
description: Brief description of agent's purpose
tools: Tool1, Tool2, Tool3
---

[Detailed instructions for the agent...]

Creating New Agents

1. Identify a specialized, repeatable task that requires multiple steps
2. Define which tools the agent needs access to
3. Create agent definition in appropriate subdirectory
4. Document the agent's purpose and usage patterns
5. Test the agent with various scenarios

Tool Compatibility

• Claude Code: Full support via Task tool with subagent_type parameter
• Cursor: Agent support status TBD
• GitHub Copilot: Not applicable (doesn't support sub-agents)