Skip to content

Agents

Specialized sub-agents for parallel research

Hyprlayer installs specialized sub-agents. Your main AI tool spawns them to handle specific tasks in parallel, and commands like /research_codebase and /create_plan drive them for you.

Agent Purpose
codebase-locator Finds files, directories, and components relevant to a feature or task. A “super grep/glob” tool.
codebase-analyzer Analyzes implementation details of specific components. Explains how the code works.
codebase-pattern-finder Finds similar implementations, usage examples, or existing patterns to model after. Returns concrete code examples.
Agent Purpose
web-search-researcher Searches the web for information not available in the codebase. Useful for API docs, library usage, and modern techniques.
thoughts-locator Discovers relevant documents in the thoughts/ directory. Finds existing research, plans, and context.
thoughts-analyzer Analyzes research topics found in the thoughts directory.
Agent Purpose
jira-ticket-reader Reads full details of a JIRA ticket including description, comments, and linked issues.
jira-searcher Searches JIRA for tickets using JQL or text queries. Finds similar issues and historical context.
Agent Purpose
adversarial-reviewer Adversarial code reviewer. Read-only. Reviews the current branch’s diff against its base for the ways the code will fail in production: edge cases, race conditions, security holes, resource leaks, corruption that never raises. /code_review Tier 2 spawns it when codex is missing, and you can spawn it on its own to challenge a diff.

You never invoke an agent yourself. Commands spawn them:

  • /research_codebase spawns codebase-locator, codebase-analyzer, and codebase-pattern-finder in parallel to explore different aspects of the codebase
  • /create_plan uses codebase-analyzer and thoughts-locator to research before planning
  • /founder_mode uses jira-ticket-reader to create tickets
  • /code_review (Tier 2) spawns adversarial-reviewer when the codex CLI is unavailable

hyprlayer ai configure installs the agent definitions alongside the commands. They live in the agents/ subdirectory of your AI tool’s configuration directory.