Personas
What is a persona?
A persona is a .md file that defines a specialist agent — its identity, expertise, tools it can use, and the trigger words that activate it. The orchestrator reads the persona registry before starting any specialized task.
Personas live at ~/.config/nexus/personas/ and are symlinked into Claude Code’s agent directory.
Built-in personas
Expert Orchestrator — agents-orchestrator.md
The top-level brain. Routes every task to the right specialist and manages context window budget. All other agents operate under its supervision.
Trigger: Any complex task involving multiple steps or domains.
Backend Architect — engineering-backend-architect.md
Senior backend architect specializing in scalable system design, database architecture, API development, and cloud infrastructure.
Trigger: “architect”, “design schema”, “API design”, “system design”
Frontend Developer — engineering-frontend-developer.md
Frontend implementation specialist for Astro, React, Vue, Svelte, and Tailwind CSS. Handles components, pages, layouts, and Capacitor config.
Trigger: “build UI”, “component”, “page layout”, “Tailwind”, “React”
Mobile App Builder — engineering-mobile-app-builder.md
Native iOS/Android development and cross-platform frameworks. From app store submission to device deployment.
Trigger: “mobile”, “iOS”, “Android”, “React Native”, “Capacitor”
TUI Specialist — bubbletea-tui.md
Go terminal UIs with Bubbletea v2, Bubbles v2, and Lipgloss. Multi-screen navigation, model architecture, and component design.
Trigger: “TUI”, “terminal UI”, “bubbletea”, “lipgloss”
Code Reviewer — engineering-code-reviewer.md
PR review, quality gates, security pattern detection, and constructive critique. Used automatically during code review phases.
Trigger: “review”, “audit”, “check PR”, “code quality”
DevOps / CI Agent — engineering-devops-ci-agent.md
CI/CD pipeline design, containerisation, infrastructure automation, and deployment workflows.
Trigger: “CI”, “deploy”, “pipeline”, “Docker”, “GitHub Actions”
Git Workflow Master — engineering-git-workflow-master.md
Atomic commits, branching strategy, clean git history, and PR hygiene. All git operations route through this agent.
Trigger: “commit”, “branch”, “rebase”, “merge”, “git”
Firebase Agent — engineering-firebase-agent.md
Firestore, Firebase Auth, Cloud Functions, Hosting, and the broader Firebase / GCP stack.
Trigger: “Firebase”, “Firestore”, “Auth”, “GCP”, “Cloud Functions”
Dev Roadmap — engineering-dev-roadmap.md
Project planning, issue triage, milestone scoping, and roadmap execution. Bridges product vision and engineering work.
Trigger: “roadmap”, “planning”, “milestone”, “sprint”, “backlog”
Toolkiit Migrator — toolkiit-migrator.md
Bootstraps and retrofits repositories to Codelogiic toolkiit standards — AGENTS.md, GitHub issues, design constraints.
Trigger: “Initialize”, “Retrofit” (at the start of a project-scoped request)
UI Tester — ui-tester-agent.md
Playwright browser automation, screenshot capture, visual QA, and regression testing. Never run Playwright directly from the orchestrator — always delegate here.
Trigger: “test UI”, “screenshot”, “Playwright”, “visual regression”
Defining your own persona
Create a new .md file in ~/.config/nexus/personas/:
---
name: My Specialist
description: One-sentence description of what this agent does.
color: blue
emoji: 🔧
---
# My Specialist Agent
You are [role], specializing in [domain].
## When to invoke
[Trigger words and conditions]
## How to approach tasks
[Behavioral guidelines, preferred tools, domain knowledge]
The persona is immediately available to all AI CLIs via the symlink. No restart needed.
The archive
Personas that aren’t actively used live in ~/.config/nexus/personas/_archive/. The orchestrator checks here when no active persona fits a task, and can promote archived personas back into the active roster.
Persona marketplace (v0.4.0)
A community persona registry is planned for v0.4.0. Discover, share, and install community-built specialists without leaving your terminal.