engineering catalog · personas + skills + flow agents

The team's professional engineering stack

Every capability we can invoke on the kvisi migration, mapped to the doc or ADR it serves. Three kinds: personas (Octopus built-ins, invoked via Task()), skills (open-source SKILL.md packages from awesome-claude-skills), and flow (claude-flow swarm agents shipped with .claude-flow/).

total38personas18skills12flow8

Architecture

backend-architectpersona

Scalable API design, microservices, distributed systems. REST/GraphQL/gRPC, event-driven patterns, service mesh, resilience.

octo:personas:backend-architect

For kvisi

Every new bounded-context module. Validates outbox+EventBridge patterns and SQL Server VPN pool design.

applies toCLAUDE.md 02-TARGET-ARCHITECTURE.md ADR-0003 ADR-0008

cloud-architectpersona

AWS/Azure/GCP multi-cloud, IaC (CDK/Terraform), FinOps, serverless, security, compliance.

octo:personas:cloud-architect

For kvisi

CDK + SST stack design (ADR-0009), Fargate sizing, Lambda + SQS topology, cost guardrails.

applies toADR-0009 02-TARGET-ARCHITECTURE.md

database-architectpersona

Data layer design, technology selection, schema modeling. SQL/NoSQL/TimeSeries, normalization, migration planning.

octo:personas:database-architect

For kvisi

RDS-vs-Aurora decision (still open), CDC schema validation, Prisma+Kysely boundary enforcement.

applies toADR-0008 03-MIGRATION-PLAN.md

software-architectureskill@NeoLabHQ

Implements design patterns including Clean Architecture, SOLID principles, and software design best practices.

load via SKILL.md

For kvisi

Backstop for the dependency-cruiser DDD rules. Verify FP/DDD invariants on every new module.

applies to07-CODING-STYLE.md CLAUDE.md

system-architectflow

High-level system architecture, technical decisions, patterns. Coordinates with backend-architect for implementation.

system-architect

For kvisi

Cross-cutting architectural ADRs that span multiple bounded contexts.

applies to02-TARGET-ARCHITECTURE.md CLAUDE.md

Backend

typescript-propersona

TypeScript strict mode mastery — advanced types, generics, decorators, enterprise-grade patterns.

octo:personas:typescript-pro

For kvisi

neverthrow Result chaining, Zod-inferred types, branded VOs, discriminated-union errors.

applies to07-CODING-STYLE.md ADR-0001

backend-devflow

Specialized agent for backend API development with self-learning and pattern recognition.

backend-dev

For kvisi

NestJS controller/service/repository implementation for every endpoint cluster in Phases 2–4.

applies to03-MIGRATION-PLAN.md 07-CODING-STYLE.md

subagent-driven-developmentskill@NeoLabHQ

Dispatches independent subagents for individual tasks with code review checkpoints between iterations.

load via SKILL.md

For kvisi

The 3-loop model in docs/04. Parallel endpoint-cluster work in Phase 2 with controlled hand-off.

applies to04-AI-ORCHESTRATION.md

MCP Builderskill@anthropic

Guides creation of high-quality MCP (Model Context Protocol) servers for integrating external APIs with LLMs.

load via SKILL.md

For kvisi

Build the MCP layer when the dashboard graduates to live data (Phase 2+).

applies to04-AI-ORCHESTRATION.md

Frontend

frontend-developerpersona

React 19, Next.js 15, responsive layouts, accessible UI components. Performance + accessibility.

octo:personas:frontend-developer

For kvisi

This dashboard, the future admin panel, and any operator-facing UI in Phase 4+.

applies toREADME.md

last invoked: 2026-05-17

ui-ux-designerpersona

Style guides, color palettes, typography, component specs. Bridges user research and frontend implementation.

octo:personas:ui-ux-designer

For kvisi

Dashboard design system + admin panel UX before Phase 4 admin work begins.

applies toIA-SURFACES.md

artifacts-builderskill@anthropic

Suite of tools for creating elaborate, multi-component artifacts using React, Tailwind, and shadcn/ui.

load via SKILL.md

For kvisi

Stakeholder explainers and one-off visualizations without expanding the app footprint.

applies toREADME.md

Testing

tdd-orchestratorpersona

Red-green-refactor discipline, multi-agent workflow coordination, AI-assisted testing.

octo:personas:tdd-orchestrator

For kvisi

Every payments / auth / pricing PR. Coordinates the Stryker ≥ 70% mutation gate.

applies to05-METHODOLOGY.md 07-CODING-STYLE.md

test-automatorpersona

AI-powered test automation with modern frameworks, self-healing tests, CI/CD integration.

octo:personas:test-automator

For kvisi

Parity replay harness (Phase 1) + Diffy-style comparator wiring across endpoint clusters.

applies to03-MIGRATION-PLAN.md 05-METHODOLOGY.md

test-driven-developmentskill@obra

Use when implementing any feature or bugfix, before writing implementation code. Red-green-refactor discipline.

load via SKILL.md

For kvisi

Foundation discipline for the mutation gate. Phase 2+ every endpoint cluster.

applies to05-METHODOLOGY.md

Webapp Testingskill@anthropic

Tests local web applications using Playwright for verifying frontend functionality, debugging UI behavior.

load via SKILL.md

For kvisi

Smoke tests for this dashboard + admin panel work in Phase 4.

applies toREADME.md

testerflow

Comprehensive testing and quality assurance specialist with AI-powered test generation.

tester

For kvisi

Property-test generation (fast-check) for pure domain logic. Phase 2+ pricing, validation.

applies to05-METHODOLOGY.md

Security

security-auditorpersona

DevSecOps, OWASP, OAuth2/OIDC, threat modeling, vulnerability assessment, cloud security automation.

octo:personas:security-auditor

For kvisi

Auto-review on every auth / payments / integrations PR. JWT design, CreditGuard scope.

applies toADR-0005 07-CODING-STYLE.md

security-architectflow

V3 Security Architecture specialist with threat pattern search and zero-trust design.

security-architect

For kvisi

Cross-cutting security ADRs. PII redaction in fixtures, secrets rotation in Web.config drain.

applies toADR-0005 ADR-0007

Data

postgresskill@sanjay3290

Execute safe read-only SQL queries against PostgreSQL with multi-connection support and defense-in-depth security.

load via SKILL.md

For kvisi

Aurora Postgres audits during shadow-diff windows (Phase 3+).

applies to03-MIGRATION-PLAN.md

context-managerpersona

AI context engineering — dynamic context management, vector databases, knowledge graphs, memory systems.

octo:personas:context-manager

For kvisi

When the dashboard graduates to live data ingestion (Phase 2+) and we need indexed retrieval over ADRs/docs.

applies to04-AI-ORCHESTRATION.md

Cloud & DevOps

deployment-engineerpersona

CI/CD pipelines, GitOps workflows, deployment automation. GitHub Actions, ArgoCD/Flux, progressive delivery.

octo:personas:deployment-engineer

For kvisi

ECS blue-green strategy, per-PR ephemeral envs, OpenFeature flag ramps.

applies toADR-0009 03-MIGRATION-PLAN.md

devops-troubleshooterpersona

Rapid incident response, advanced debugging, modern observability. Log analysis, distributed tracing, K8s debugging.

octo:personas:devops-troubleshooter

For kvisi

Phase 2+ production triage. VPN flap, pool exhaustion, Bringg sync drift.

applies toADR-0007 ADR-0008

cicd-engineerflow

GitHub Actions CI/CD pipeline creation and optimization. Build/test/deploy orchestration.

cicd-engineer

For kvisi

Phase 0 deliverable — wires lint, typecheck, test, build, CDK deploy preview.

applies toADR-0009

Observability

performance-engineerpersona

Performance, observability, scalable systems. OpenTelemetry, distributed tracing, load testing, Core Web Vitals.

octo:personas:performance-engineer

For kvisi

OTel pipeline (Phase 0), SLO design (Phase 1), p95/p99 tracking per endpoint cluster.

applies to02-TARGET-ARCHITECTURE.md

incident-responderpersona

Rapid resolution, observability, incident management. Incident command, blameless post-mortems, error budgets.

octo:personas:incident-responder

For kvisi

Phase 2+ when shadow-diff drift or VPN flap surfaces. Runbooks per integration partner.

applies toADR-0007

root-cause-tracingskill@obra

Use when errors occur deep in execution and you need to trace back to find the original trigger.

load via SKILL.md

For kvisi

Inevitable Phase 2 production incident triage. Pair with the mirrored-traffic comparator diffs.

applies toADR-0008

Review

code-reviewerpersona

AI-powered code review — quality, security vulnerabilities, performance, production reliability. Static analysis.

octo:personas:code-reviewer

For kvisi

Every PR. Especially Phase 2+ endpoint-cluster PRs that touch payments / auth / pricing.

applies to07-CODING-STYLE.md

reviewerflow

Code review and quality assurance specialist with AI-powered pattern detection.

reviewer

For kvisi

Automated review pass on every cluster PR before human review.

applies to05-METHODOLOGY.md

finishing-a-development-branchskill@obra

Guides completion of development work by presenting clear options and handling the chosen workflow.

load via SKILL.md

For kvisi

Per-endpoint PR closure with the right flag-ramp + shadow-diff hand-off.

applies to03-MIGRATION-PLAN.md

Documentation

docs-architectpersona

Creates comprehensive technical documentation from existing codebases. Architecture guides and technical deep-dives.

octo:personas:docs-architect

For kvisi

Maintain the 8 numbered docs. Generate post-migration architecture guide once Phase 5 lands.

applies to00-OVERVIEW.md 02-TARGET-ARCHITECTURE.md

mermaid-expertpersona

Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures. Masters syntax and styling.

octo:personas:mermaid-expert

For kvisi

Diagrams for architecture docs + ADRs (sequence flow on outbox → SQS → Bringg).

applies to02-TARGET-ARCHITECTURE.md diagrams

Process

brainstormingskill@obra

Transform rough ideas into fully-formed designs through structured questioning and alternative exploration.

load via SKILL.md

For kvisi

ADR-0008 design (the remaining Phase-0 blocker), and any new bounded-context discussion.

applies toADR-0008

last invoked: 2026-05-13

using-git-worktreesskill@obra

Creates isolated git worktrees with smart directory selection and safety verification.

load via SKILL.md

For kvisi

Parallel endpoint-cluster work without branch-switching cost. One worktree per cluster in flight.

applies to03-MIGRATION-PLAN.md

plannerflow

Strategic planning and task orchestration agent with AI-powered resource optimization.

planner

For kvisi

Per-phase planning at the Phase-0→1, Phase-1→2, Phase-2→3 boundaries.

applies to03-MIGRATION-PLAN.md

Research

deep-researchskill@sanjay3290

Execute autonomous multi-step research using Gemini Deep Research Agent for market analysis and literature reviews.

load via SKILL.md

For kvisi

Mirrored the OSS-alternatives scout exercise. Re-run when evaluating Phase 2 observability (Langfuse vs Phoenix).

applies toRESEARCH-ALTERNATIVES.md

researcherflow

Deep research and information gathering specialist with AI-enhanced pattern recognition.

researcher

For kvisi

Phase-2+ tooling decisions, library evaluation, post-mortem deep-dives.

applies toRESEARCH-ALTERNATIVES.md IA-AUDIT.md

last invoked: 2026-05-17

ux-researcherpersona

User research synthesis, journey mapping, persona creation, usability evaluation. Qualitative + quantitative methods.

octo:personas:ux-researcher

For kvisi

IA audits of the dashboard. Phase 4 admin-panel scope decision (Q5).

applies toIA-AUDIT.md IA-SURFACES.md

last invoked: 2026-05-17