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 |
| cartographer |
Maps one area of a codebase into a document-ready section with file:line references. Spawned one per area, in parallel, during research. |
| archivist |
Finds every prior thoughts artifact about a topic or ticket and returns the paper trail. Also drafts handoff bodies. |
| draughtsman |
Drafts an implementation plan body from an approved outline. |
| adjudicator |
Tears a draft plan apart before anyone builds it. Verdict: ship, revise, or reject. |
| foreman |
Executes exactly one phase of an approved plan in a fresh context. |
| inspector |
Audits a finished implementation against its plan. Verdict: promote or block. |
| quartermaster |
Splits a working tree into atomic commits with drafted messages. |
| herald |
Turns a PR’s diff into a filled-out pull request description. |
| ship |
Session agent (claude --agent ship) that commits, pushes, and opens the PR. Not spawned as a sub-agent. |
| 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 or not signed in, and you can spawn it on its own to challenge a diff. |
| marshal |
Triages raw review output into an ordered fix list. Verifies each finding against the code and rules fix now, defer, or reject. |
You never invoke an agent yourself. Commands spawn them:
/research_codebase fans out one cartographer per area of the codebase and an archivist over prior thoughts. It uses codebase-locator, codebase-analyzer, or codebase-pattern-finder for single narrow lookups/create_plan researches with cartographer and archivist, drafts the plan with draughtsman, and has adjudicator review it before you see it/implement_plan runs each phase through foreman; /validate_plan audits the result with inspector/founder_mode uses jira-ticket-reader to create tickets/code_review (Tier 2) spawns adversarial-reviewer when codex is missing or not signed in, then marshal triages the findings
Hyprlayer provisions the agent definitions alongside the skills. hyprlayer ai status shows what is installed and hyprlayer ai reinstall repairs it. Claude Code gets ~/.claude/agents/*.md, Codex gets ~/.codex/agents/*.toml, both linked from ~/.config/hyprlayer/agents/<version>/.
