Agent Files

Location

Agent files are stored in .claude/agents/:

.claude/agents/
  frontend-executor/AGENT.md
  backend-executor/AGENT.md
  feature-planner/AGENT.md
  code-reviewer/AGENT.md

AGENT.md Structure

Each AGENT.md file has YAML frontmatter followed by markdown body:

---
description: One-line description of what the agent does
capabilities: [analyze-code, refactor, test-generation]
context:
  - What inputs the agent needs
  - What scope it operates over
---

# Agent Name

You are an expert <role>. Your mission is to <goal>.

## Process
...

## Patterns
1. Pattern one — discovered convention to follow.
2. Pattern two — ...

The frontmatter fields:

• description — short summary, surfaced in /hypr:list and /hypr:status.
• capabilities — tags describing what the agent does (free-form, but keep them short).
• context — list of inputs the agent expects from the caller.

The markdown body typically contains: a Role paragraph, a Process section (numbered steps), and a numbered list of Patterns (project-specific conventions discovered during assessment, referenced by number elsewhere). For real examples, see the assessment-output sample agents.

Modifying Agents

You can manually edit agent files to add custom rules or adjust patterns. Changes take effect immediately.

Optional Agents

Beyond the core agents, you can install optional agents and skills from the Hypr directory:

Optional agents extend Hypr's capabilities for specific use cases:

• accessibility-analyzer - WCAG 2.1 compliance auditing
• security-scanner - Security vulnerability detection
• testing-agent - Test suite generation
• migration-agent - Framework migration assistance