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 commandsSprint planning, task prioritization, coordination, and stakeholder updates
Identity file
agents/pm.md
Commands directory
prompts/agents/pm/
Commands
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.
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.
System Architect
3 commandsSystem design, technical specifications, and architectural standards
Identity file
agents/architect.md
Commands directory
prompts/agents/architect/
Commands
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.
Creates architecture analysis reports covering system structure, component relationships, scalability concerns, and recommendations for improvement.
Analyzes and prioritizes technical debt across the codebase. Identifies areas of concern, estimates remediation effort, and recommends a prioritized paydown sequence.
Frontend Developer
3 commandsUI components, responsive design, accessibility, and client-side interactions
Identity file
agents/frontend_dev.md
Commands directory
prompts/agents/frontend_dev/
Commands
Scaffolds a new UI component with tests, following the project's component conventions. Includes props/types, styling, and initial test coverage.
Creates a Storybook story for an existing component with multiple variants, interactive controls, and documentation annotations.
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 commandsAPIs, databases, authentication, and server-side logic
Identity file
agents/backend_dev.md
Commands directory
prompts/agents/backend_dev/
Commands
Scaffolds a REST or GraphQL endpoint with request/response validation, error handling, and route registration following the project's API conventions.
Creates a database migration file with up/down operations, data type definitions, index creation, and rollback safety checks.
Auto-generates OpenAPI/Swagger documentation from existing endpoints, including request schemas, response examples, and authentication requirements.
Fullstack Developer
3 commandsEnd-to-end features with both frontend and backend work
Identity file
agents/fullstack_dev.md
Commands directory
prompts/agents/fullstack_dev/
Commands
Scaffolds a complete vertical-slice feature: UI components, API endpoints, database models, and integration wiring. Delivers the entire stack in one pass.
Defines API contracts between frontend and backend: request/response schemas, error formats, and contract tests to prevent drift between layers.
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 commandsTesting, quality assurance, test automation, and regression testing
Identity file
agents/qa.md
Commands directory
prompts/agents/qa/
Commands
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.
Documents bugs with structured reproduction steps, expected vs. actual behavior, environment details, severity classification, and suggested fix areas.
Analyzes test coverage gaps across the project. Identifies untested paths, measures coverage by feature area, and recommends high-value tests to write next.
Creates Playwright browser automation tests with full page-object models, user flow scripts, visual regression snapshots, and CI integration configuration.
DevOps Engineer
3 commandsCI/CD, infrastructure, deployment, monitoring, and reliability
Identity file
agents/devops_engineer.md
Commands directory
prompts/agents/devops/
Commands
Creates a pre-deployment verification checklist covering environment readiness, database migrations, configuration changes, rollback procedures, and monitoring thresholds.
Documents incidents with a detailed timeline, root cause analysis, impact assessment, remediation steps taken, and follow-up action items to prevent recurrence.
Comprehensive deployment assessment covering test results, performance benchmarks, security sign-off status, infrastructure readiness, and go/no-go recommendation.
Security Engineer
3 commandsSecurity reviews, threat modeling, compliance, and risk management
Identity file
agents/security_compliance_engineer.md
Commands directory
prompts/agents/security/
Commands
Performs a comprehensive security audit of the project. Examines authentication, authorization, input validation, dependency vulnerabilities, secrets management, and produces a prioritized findings report.
Creates a threat model using STRIDE methodology. Maps data flows, identifies trust boundaries, enumerates threats per component, and recommends mitigations with priority ranking.
Reviews code and configuration for security vulnerabilities: injection flaws, broken authentication, sensitive data exposure, and security misconfiguration. Produces actionable fix recommendations.
Data Engineer
4 commandsData pipelines, analytics dashboards, metrics, and telemetry
Identity file
agents/data_analytics_engineer.md
Commands directory
prompts/agents/data_engineer/
Commands
Creates an ETL/ELT pipeline definition with source extraction, transformation logic, loading targets, scheduling configuration, and data quality validation steps.
Builds an analytics dashboard definition with KPI selections, chart specifications, data source mappings, filter configurations, and refresh schedules.
Creates data validation and quality rules: completeness checks, referential integrity, freshness thresholds, statistical anomaly detection, and alerting configuration.
Generates a data model diagram for database schemas: entities, attributes, relationships, cardinality, and index annotations in a visual format.
UX/Product Designer
3 commandsUser experience design, wireframes, prototypes, and design systems
Identity file
agents/ux_product_designer.md
Commands directory
prompts/agents/ux_designer/
Commands
Maps a complete user journey with personas, touchpoints, emotions, pain points, and opportunities. Produces a visual journey map with actionable insights.
Creates wireframe documentation for screens and flows: layout specifications, component placement, interaction patterns, responsive breakpoints, and annotation notes.
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
Analyze the Task
Examine feature labels (frontend, backend, security), content keywords, workflow stage, and dependencies to determine the best role.
Read the Agent File
Load agents/{role}.md for identity, responsibilities, and workflow. Load prompts/agents/{role}/README.md for the command catalog.
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.
Execute & Loop
Claim features, execute work, transition status, and immediately look for the next task. Agents operate continuously until the backlog is clear.
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.
{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.
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