acceptance-tests
Read this before writing or running the graphical acceptance suite under `test/acceptance.d/`.
Flowy lists 54 subagents for Operations, and the most-starred are acceptance-tests, capture and command-metadata, all three from the 45,868-star omarchy plugin. That plugin was last pushed on October 29, 2026.
Read this before writing or running the graphical acceptance suite under `test/acceptance.d/`.
Read this before taking screenshots or screen recordings, extracting text from the screen, or sharing files with other machines.
Read this before adding or changing commands in `bin/`.
MUST BE USED when starting new projects or planning major changes. This agent specializes exclusively in system architectureโฆ
MUST BE USED when creating comprehensive architecture documentation for systems, APIs, or technical designs. This agentโฆ
Use PROACTIVELY during requirements gathering and before technical implementation begins. This agent specializes exclusively inโฆ
**โ ๏ธ DEVELOPER REFERENCE ONLY** โ This file documents the raw GraphQL API schema for development and maintenance purposes (addingโฆ
**โ ๏ธ DEVELOPER REFERENCE ONLY** โ This file documents raw GraphQL endpoints for development purposes. For MCP tool usage, useโฆ
**โ ๏ธ DEVELOPER REFERENCE ONLY** โ Full GraphQL SDL from live API introspection. Use this to verify field names and types whenโฆ
The generic template and base persona for PAI. All role-specific agents under [/agents/](../agents/) inherit from this file,โฆ
Writes, edits, and reviews source code in the PAI repository.
Inherits from [base-agent](./agent.md), which inherits from [AGENTS.md](../docs/src/AGENTS.md). Sibling:โฆ
Produce design + contracts (OpenAPI/AsyncAPI/JSON Schema) + ADRs for a greenfield feature. Wraps /plan. Use when the spec existsโฆ
Interview the operator and produce EARS-format requirements + PROJECT.md/.json + Gherkin acceptance scenarios. Iterates untilโฆ
Run validate-project-spec.py against a project and report gaps in human-readable form. Cheap (haiku model) read-only check. Useโฆ
Read this before setting up scripts that run on system events (theme changes, updates, boot, low battery, etc.).
Read this before changing keybindings, monitors, window rules, or any other Hyprland (window manager) configuration.
Read this before adding a branded glyph to `default/fonts/omarchy/omarchy.ttf`.
Use PROACTIVELY when inheriting legacy codebases or before making changes to undocumented systems. This agent specializesโฆ
Use PROACTIVELY before every production deployment to ensure zero-downtime releases and instant rollback capability. This agentโฆ
MUST BE USED when creating understanding-oriented documentation for experienced users. This agent specializes exclusively inโฆ
All operations use: `unraid(action="<domain>", subaction="<operation>", [params])`
**Error:** `CredentialsNotConfiguredError` or message containing `~/.unraid-mcp/.env`
Inherits from [base-agent](./agent.md), which inherits from [AGENTS.md](../AGENTS.md). Sibling: [docs-agent](./docs-agent.md).
Atomize a designed feature into tasks.json with files_owned + dependencies + parallelizable + acceptance_test + risk_score perโฆ
Read this before working under `install/` or on the system/user setup commands.
Read this before creating or changing migrations under `migrations/`.
Read this before adding or changing a mise-managed tool. Default tools belong in `etc/mise/conf.d/omarchy-tools.toml`, which theโฆ
MUST BE USED when creating task-oriented documentation for competent users solving specific problems. This agent specializesโฆ
MUST BE USED when creating information-oriented documentation for technical lookup. This agent specializes exclusively inโฆ
MUST BE USED when creating learning-oriented documentation for beginners. This agent specializes exclusively in creatingโฆ
Read this before adding or changing any animation in `shell/`: a panel, popup, notification, button, list or anything else thatโฆ
* Do not write new oligarchy tests as this is still experimental
Read this before changing the status bar, notifications, shell plugins, widgets, or idle/lock behavior.
MUST BE USED whenever code is created or modified to maintain living documentation. This agent specializes exclusively inโฆ
MUST BE USED when implementing performance optimizations based on profiling data. This agent specializes exclusively inโฆ
Use PROACTIVELY when performance metrics decline or before scaling events. This agent specializes exclusively in performanceโฆ
Read this only after concluding that a crash is genuinely Omarchy's to fix.
Read this before editing the Quickshell desktop under `shell/`.
Read this before changing themes, backgrounds, fonts, or theme colors.
MUST BE USED when analyzing system performance through profiling and measurement. This agent specializes exclusively inโฆ
Use PROACTIVELY during backlog grooming and sprint planning to maximize business value delivery. This agent specializesโฆ
Use PROACTIVELY at the start of each sprint or product cycle to align technical work with business objectives. This agentโฆ
Read this before finishing any change with a visual effect: Omarchy shell styling and layout, panels, menus, notifications,โฆ
MUST BE USED before every release to ensure comprehensive quality validation and prevent defects from reaching production. Thisโฆ
Use PROACTIVELY for sprint ceremonies and when team velocity drops or blockers arise. This agent specializes exclusively in agileโฆ
MUST BE USED before every deployment and pull request. This agent focuses solely on security vulnerability detection andโฆ
MUST BE USED by beginners learning architectural decisions for small-to-medium web applications. This agent specializes inโฆ
By the GitHub stars of the plugin each ships in (Flowy does not rate quality), the best Operations subagent for Claude Code is acceptance-tests, level on stars with capture and command-metadata, all three from the 45,868-star omarchy plugin.
Flowy lists 54 subagents for Operations, and this page draws the top 48 Operations subagents.