10 Roles · 31 Commands

Agent System

Specialized AI agent roles with role-specific command catalogs covering the full software development lifecycle. Fully extensible.

Architecture

How agents work

Automatic role detection, command catalogs, and continuous operation

Role Detection

Agents analyze the task, feature labels, and workflow stage to automatically select the appropriate role from the agents/ directory.

Command Catalogs

Each role has trigger-coded commands in prompts/agents/{role}/ with detailed workflow instructions and output templates.

Continuous Loop

Agents follow a continuous delivery loop: find work, claim it, execute, transition to the next state, and immediately look for new tasks.

Role Catalog

All agents & commands

Click any role to expand its full command catalog with trigger codes, descriptions, and output locations.

Project Manager

2 commands

Sprint planning, task prioritization, coordination, and stakeholder updates

Identity file

agents/pm.md

Commands directory

prompts/agents/pm/

Commands

GPP Generate Project Progress Report

Scans all feature files across status folders, verifies implementation against acceptance criteria, identifies gaps and blockers, and produces a comprehensive status report with metrics and recommended next steps.

.virtualboard/reports/{date}_Project_Progress_Report.md
GBG Generate Backlog Grooming

Performs a comprehensive backlog refinement session: reviews all backlog items, validates priorities, checks for stale features, identifies missing estimates, and reorganizes the backlog for the next sprint.

.virtualboard/reports/{date}_Backlog_Grooming.md

System Architect

3 commands

System design, technical specifications, and architectural standards

Identity file

agents/architect.md

Commands directory

prompts/agents/architect/

Commands

GAD Generate Architecture Decision

Documents architectural decisions with the ADR (Architecture Decision Record) format. Analyzes 2-3 alternative approaches, evaluates pros/cons for each, and produces a formal decision record with rationale and consequences.

.virtualboard/architecture/decisions/ADR-{NNNN}-{slug}.md
GAR Generate Architecture Report

Creates architecture analysis reports covering system structure, component relationships, scalability concerns, and recommendations for improvement.

.virtualboard/architecture/reports/
GTD Generate Technical Debt Report

Analyzes and prioritizes technical debt across the codebase. Identifies areas of concern, estimates remediation effort, and recommends a prioritized paydown sequence.

.virtualboard/architecture/tech-debt/

Frontend Developer

3 commands

UI components, responsive design, accessibility, and client-side interactions

Identity file

agents/frontend_dev.md

Commands directory

prompts/agents/frontend_dev/

Commands

GC Generate Component

Scaffolds a new UI component with tests, following the project's component conventions. Includes props/types, styling, and initial test coverage.

GCS Generate Component Story

Creates a Storybook story for an existing component with multiple variants, interactive controls, and documentation annotations.

GAA Generate Accessibility Audit

Checks a component or page for WCAG 2.1 accessibility compliance. Reports color contrast, ARIA roles, keyboard navigation, and screen reader compatibility issues.

Backend Developer

3 commands

APIs, databases, authentication, and server-side logic

Identity file

agents/backend_dev.md

Commands directory

prompts/agents/backend_dev/

Commands

GAE Generate API Endpoint

Scaffolds a REST or GraphQL endpoint with request/response validation, error handling, and route registration following the project's API conventions.

GDM Generate Database Migration

Creates a database migration file with up/down operations, data type definitions, index creation, and rollback safety checks.

GAD Generate API Documentation

Auto-generates OpenAPI/Swagger documentation from existing endpoints, including request schemas, response examples, and authentication requirements.

Fullstack Developer

3 commands

End-to-end features with both frontend and backend work

Identity file

agents/fullstack_dev.md

Commands directory

prompts/agents/fullstack_dev/

Commands

GFF Generate Full Feature

Scaffolds a complete vertical-slice feature: UI components, API endpoints, database models, and integration wiring. Delivers the entire stack in one pass.

GIC Generate Integration Contract

Defines API contracts between frontend and backend: request/response schemas, error formats, and contract tests to prevent drift between layers.

GETE Generate End-to-End Test

Creates end-to-end tests for a user flow, covering the full path from UI interaction through API calls to database verification.

QA Engineer

4 commands

Testing, quality assurance, test automation, and regression testing

Identity file

agents/qa.md

Commands directory

prompts/agents/qa/

Commands

GTP Generate Test Plan

Creates a comprehensive test plan from a feature spec: maps acceptance criteria to scenarios, covers positive/negative/edge cases, defines test data requirements, and produces a prioritized execution checklist.

.virtualboard/testing/plans/TP-{FTR-XXXX}-{name}.md
GBR Generate Bug Report

Documents bugs with structured reproduction steps, expected vs. actual behavior, environment details, severity classification, and suggested fix areas.

.virtualboard/testing/bugs/
GTCR Generate Test Coverage Report

Analyzes test coverage gaps across the project. Identifies untested paths, measures coverage by feature area, and recommends high-value tests to write next.

.virtualboard/testing/coverage/
GBAT Generate Browser Automation Tests

Creates Playwright browser automation tests with full page-object models, user flow scripts, visual regression snapshots, and CI integration configuration.

.virtualboard/testing/automation/

DevOps Engineer

3 commands

CI/CD, infrastructure, deployment, monitoring, and reliability

Identity file

agents/devops_engineer.md

Commands directory

prompts/agents/devops/

Commands

GDC Generate Deployment Checklist

Creates a pre-deployment verification checklist covering environment readiness, database migrations, configuration changes, rollback procedures, and monitoring thresholds.

GIR Generate Incident Report

Documents incidents with a detailed timeline, root cause analysis, impact assessment, remediation steps taken, and follow-up action items to prevent recurrence.

GDRR Generate Deployment Readiness Report

Comprehensive deployment assessment covering test results, performance benchmarks, security sign-off status, infrastructure readiness, and go/no-go recommendation.

Security Engineer

3 commands

Security reviews, threat modeling, compliance, and risk management

Identity file

agents/security_compliance_engineer.md

Commands directory

prompts/agents/security/

Commands

GSA Generate Security Audit

Performs a comprehensive security audit of the project. Examines authentication, authorization, input validation, dependency vulnerabilities, secrets management, and produces a prioritized findings report.

GTM Generate Threat Model

Creates a threat model using STRIDE methodology. Maps data flows, identifies trust boundaries, enumerates threats per component, and recommends mitigations with priority ranking.

GSR Generate Security Review

Reviews code and configuration for security vulnerabilities: injection flaws, broken authentication, sensitive data exposure, and security misconfiguration. Produces actionable fix recommendations.

Data Engineer

4 commands

Data pipelines, analytics dashboards, metrics, and telemetry

Identity file

agents/data_analytics_engineer.md

Commands directory

prompts/agents/data_engineer/

Commands

GDP Generate Data Pipeline

Creates an ETL/ELT pipeline definition with source extraction, transformation logic, loading targets, scheduling configuration, and data quality validation steps.

GMD Generate Metrics Dashboard

Builds an analytics dashboard definition with KPI selections, chart specifications, data source mappings, filter configurations, and refresh schedules.

GDQ Generate Data Quality Check

Creates data validation and quality rules: completeness checks, referential integrity, freshness thresholds, statistical anomaly detection, and alerting configuration.

ERD Entity Relationship Diagram

Generates a data model diagram for database schemas: entities, attributes, relationships, cardinality, and index annotations in a visual format.

UX/Product Designer

3 commands

User experience design, wireframes, prototypes, and design systems

Identity file

agents/ux_product_designer.md

Commands directory

prompts/agents/ux_designer/

Commands

GUJ Generate User Journey

Maps a complete user journey with personas, touchpoints, emotions, pain points, and opportunities. Produces a visual journey map with actionable insights.

GWF Generate Wireframe

Creates wireframe documentation for screens and flows: layout specifications, component placement, interaction patterns, responsive breakpoints, and annotation notes.

GDS Generate Design System Component

Documents a design system component: visual specs, usage guidelines, variants, states, accessibility requirements, and code implementation notes.

Workflow

Adoption process

How AI agents select, adopt, and operate within their roles

1

Analyze the Task

Examine feature labels (frontend, backend, security), content keywords, workflow stage, and dependencies to determine the best role.

2

Read the Agent File

Load agents/{role}.md for identity, responsibilities, and workflow. Load prompts/agents/{role}/README.md for the command catalog.

3

Adopt and Announce

Announce the adopted role ("I am working as a Frontend Developer agent") and follow that role's workflow for the entire task lifecycle.

4

Execute & Loop

Claim features, execute work, transition status, and immediately look for the next task. Agents operate continuously until the backlog is clear.

Shared guardrails: All agents follow agents/RULES.md for universal constraints including read-first behavior, ownership respect, transition validation, and the untrusted-content policy.

Extensible

Make it yours

The agent system is designed to be extended. Add new roles, create custom commands, or modify existing ones to match your team's workflow.

Add a new agent

Create agents/your_role.md following the existing format: identity, responsibilities, workflow, and skill levels. Add it to the role-detection table in AGENTS.md.

agents/
  your_role.md          # Role identity
prompts/agents/your_role/
  README.md             # Command catalog
  YourRole-Command.md   # Command file

Add a new command

Create a command file in prompts/agents/{role}/ with the naming convention {Role}-{Command_Name}.md. Define trigger phrases, step-by-step workflow, and output format. Register it in the role's README.md.

Naming convention: {Role}-{Command_Name}.md with a short trigger code alias (e.g., GTP, GAD).

Customize guardrails

Edit agents/RULES.md to adjust shared constraints, add project-specific policies, or modify the state machine transitions. Changes apply to all agents immediately.

Tip: Keep rules concise. Agents load RULES.md every turn, so every line costs tokens. Move detailed procedures into command files instead.

The agent system is pure Markdown. No compilation, no build step, no runtime dependency. Edit a file and the next agent turn picks up the changes. Use vb validate to verify your feature specs remain valid after any changes.

File structure

Where everything lives in the repository

agents/
  AGENTS.md                    # Role selection guide & task-type mapping
  RULES.md                     # Universal guardrails & state transitions
  pm.md                        # Project Manager identity
  architect.md                 # System Architect identity
  frontend_dev.md              # Frontend Developer identity
  backend_dev.md               # Backend Developer identity
  fullstack_dev.md             # Fullstack Developer identity
  qa.md                        # QA Engineer identity
  devops_engineer.md           # DevOps Engineer identity
  security_compliance_engineer.md  # Security Engineer identity
  data_analytics_engineer.md   # Data Engineer identity
  ux_product_designer.md       # UX Designer identity

prompts/agents/
  pm/                          # GPP, GBG
  architect/                   # GAD, GAR, GTD
  frontend_dev/                # GC, GCS, GAA
  backend_dev/                 # GAE, GDM, GAD
  fullstack_dev/               # GFF, GIC, GETE
  qa/                          # GTP, GBR, GTCR, GBAT
  devops/                      # GDC, GIR, GDRR
  security/                    # GSA, GTM, GSR
  data_engineer/               # GDP, GMD, GDQ, ERD
  ux_designer/                 # GUJ, GWF, GDS