nexus-agents

Architecture expert for system design, design patterns, and architectural trade-offs.

Code expert for code review, refactoring, and multi-language best practices.

Data visualization expert for chart selection, interactive dashboards, WCAG-AA color palettes, and ECharts/D3 code.

DevOps/SRE expert for CI/CD pipelines, infrastructure-as-code, observability, and reliability engineering.

Documentation expert for technical writing, API docs, README authoring, and docs-content governance.

Infrastructure expert for bare-metal, out-of-band (iDRAC/iLO), networking, and physical-server operations.

Product management expert for requirements gathering, user stories, acceptance criteria, and scope decisions.

Quality assurance expert for code review, requirements verification, regression analysis, and standards compliance.

Research expert for literature review, prior-art analysis, and evidence-based recommendations.

Security expert for OWASP-aware code review, threat modeling, and vulnerability analysis.

Testing expert for TDD, test strategy, coverage analysis, and edge-case identification.

UX design expert for interaction design, usability analysis, accessibility, and user-journey mapping.

Design stable, hard-to-misuse interfaces — REST endpoints, MCP tool schemas, module boundaries, type contracts. Apply when defining new surfaces or evolving public ones. Triggers on "API design", "interface", "schema", "contract", "module boundary", "type design".

Test UI in real browsers via Chrome DevTools MCP. Apply when debugging rendering issues, console errors, network behavior, performance, or accessibility — anywhere static code analysis can't see runtime state. Triggers on "browser test", "DOM inspect", "console errors", "network trace", "core web vitals in browser", "ui bug repro".

Fix a bug following project standards. Use when fixing defects, debugging issues, or resolving reported problems. Triggers on "fix bug", "debug", "fix issue", "resolve bug".

Reduce nesting, extract names, eliminate redundancy without changing behavior. Apply after features work and tests pass — never as a drive-by during feature work. Triggers on "simplify", "refactor for clarity", "this is hard to read", "code review flagged complexity".

Delegate code generation tasks to Codex CLI for optimal performance. Use when implementing features, generating tests, refactoring code, or making bulk code changes. Triggers on "delegate to codex", "route to codex", "use codex", "code generation".

Curate what the agent sees, when, and how it's structured. Apply when starting a session, when output quality drifts, when fanning out subagents, or when configuring rules files. Triggers on "context engineering", "rules file", "agent context", "subagent fan-out", "context budget".

Plan and execute the removal of deprecated APIs without breaking consumers. Apply when retiring `@deprecated` markers, renaming public surfaces, or version-gating cleanup work. Triggers on "deprecate", "remove deprecated", "migration plan", "breaking change", "v3 cleanup".

Multi-agent development pipeline (Orchestrator + workers + consensus vote). Use when the user asks to "build a feature", "fix a bug with the pipeline", or "run the dev pipeline". Triggers on "dev pipeline", "multi-agent pipeline", "run pipeline".

Operating manual for documentation work in nexus-agents. Use when updating docs, adding new docs, changing doc pipeline, or troubleshooting doc issues. Triggers on "update docs", "add documentation", "doc pipeline".

Process open GitHub issues using the self-development protocol. Implements features from research registry with proper voting and testing. Use when working on open issues, implementing research techniques, or following the dogfooding workflow. Triggers on "dogfood", "work on issues", "implement issue", "self-development", "process issues".

Delegate large context and multimodal tasks to Gemini CLI. Use when context exceeds 100K tokens, analyzing images/screenshots, processing large codebases, or for speed/cost-sensitive operations. Triggers on "delegate to gemini", "route to gemini", "use gemini", "large context", "analyze image", "screenshot analysis".

Apply a hotfix for critical production issues. Use for security vulnerabilities or bugs that prevent core functionality. Triggers on "hotfix", "emergency fix", "critical fix", "production bug".

Implement a new feature following project standards. Use when adding functionality, creating new modules, or extending capabilities. Triggers on "implement", "add feature", "create", "build".

Manage physical server infrastructure, bare metal systems, and OOB management. Handles iDRAC/iLO/IPMI access, SSH connectivity checks, boot time estimation, and hardware health monitoring. Triggers on "infrastructure", "bare metal", "server management", "idrac", "hardware check".

Measure-first optimization for code that has actual evidence of being slow. Apply when performance requirements exist, profiles show bottlenecks, or a change introduced a regression. Triggers on "optimize", "performance", "slow", "profile", "bottleneck", "core web vitals", "regression".

Execute a release following project standards. Use when publishing a new version, creating release tags, or deploying. Triggers on "release", "publish", "version bump", "create release".

Extract structured requirements from vague user requests. Decompose ideas into user stories with acceptance criteria, map to available capabilities, and identify gaps. Triggers on "requirements", "user stories", "what do I need", "break down this request", "analyze this feature".

Research a topic using multiple sources and conduct multi-agent voting. Use when making architectural decisions, choosing dependencies, or designing APIs. Triggers on "research", "decide", "vote on", "consensus".

Review code changes following project standards and security guidelines. Checks for lint compliance, type safety, test coverage, and security issues. Use when reviewing PRs, auditing code, or checking implementation quality. Triggers on "review code", "code review", "check this", "audit", "PR review".

Respond to a reporter-filed GitHub Security Advisory with coordinated disclosure discipline: confidential triage, private-fork patching, simultaneous publish, post-mortem. Use when someone files a security advisory against this repo, OR when our own discovery (via .security-discoveries.jsonl) is escalated to a reporter-facing advisory. Triggers on "security advisory", "CVE response", "coordinated disclosure", "private fork patch".

Review and fix security scanning alerts from CodeQL and secret scanning. Run as part of system reviews, after CI runs, or on manual request. Triggers on "security scan", "codeql", "secret scanning", "security alerts".

Score your own output 0-10 across 5 task-appropriate dimensions before emitting it. Anything below band 3 (5-6 Functional) is a regression — fix and rescore. Use as a pre-emit gate when work is complex enough that grade-inflation is a real risk. Triggers on "self-critique", "score my output", "pre-emit review", "grade my work", "five-dimension critique".

Run a system review to check project health. Use when issues drop below 5, an EPIC closes, or 7+ days since last review. Triggers on "system review", "project health", "review system".

Write failing tests before implementation. The Red-Green-Refactor cycle is a core nexus-agents discipline (CLAUDE.md prime directive). Use when implementing new logic, fixing bugs (Prove-It Pattern), or modifying existing behavior. Triggers on "TDD", "write a test", "test-first", "red-green-refactor", "fixing a bug" (Prove-It).

Generate design systems and implement UX/UI for software products using Astro, Svelte, Tailwind CSS, Material Design 3, and OKLCH color system. Covers style selection, color palettes, typography, layout patterns, accessibility, and frontend code generation. Triggers on "design system", "UI design", "color palette", "typography", "landing page design", "dashboard design", "style guide", "component design", "frontend".

Check that dependencies are current stable versions and not deprecated. Use before adding new dependencies or at project setup. Triggers on "check versions", "verify dependencies", "audit packages".