Skip to content

Agents

Specialized sub-agents for parallel research

Hyprlayer installs specialized sub-agents that are spawned by the main AI tool to handle specific tasks in parallel. These agents are used internally by commands like /research_codebase and /create_plan.

AgentPurpose
codebase-locatorFinds files, directories, and components relevant to a feature or task. A “super grep/glob” tool.
codebase-analyzerAnalyzes implementation details of specific components. Deep-dives into how code works.
codebase-pattern-finderFinds similar implementations, usage examples, or existing patterns to model after. Returns concrete code examples.
AgentPurpose
web-search-researcherSearches the web for information not available in the codebase. Useful for API docs, library usage, and modern techniques.
thoughts-locatorDiscovers relevant documents in the thoughts/ directory. Finds existing research, plans, and context.
thoughts-analyzerDeep-dives on research topics found in the thoughts directory.
AgentPurpose
jira-ticket-readerReads full details of a JIRA ticket including description, comments, and linked issues.
jira-searcherSearches JIRA for tickets using JQL or text queries. Finds similar issues and historical context.
AgentPurpose
adversarial-reviewerAdversarial code reviewer. Read-only. Reviews the current branch’s diff against its base for ways the code will fail in production — edge cases, race conditions, security holes, resource leaks, silent corruption. Used by /code_review Tier 2 when codex is unavailable, and spawnable on its own as a “challenge this diff” reviewer.

You don’t invoke agents directly. They are spawned by commands when needed:

  • /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

Agent definitions are installed alongside commands during hyprlayer ai configure. They live in the agents/ subdirectory of your AI tool’s configuration directory.