The full catalog of 36 CHAOS-AI agents — what each does and how to run it.
Running Agents
Run any agent directly from the CLI:
cw run <agent-name> "your instruction here"
Or dispatch via the PM agent for coordinated pipelines:
cw run pm "run security audit and generate tests for src/auth/"
Language Agents
| Agent | Language / Stack |
|---|
python-agent | Python 3.14+, FastAPI, SQLAlchemy, Pydantic, pytest, ruff, mypy |
typescript-agent | TypeScript, React, Next.js, Vitest, ESLint, tsc strict |
go-agent | Go, REST APIs, gRPC, CLI tools |
rust-agent | Rust, Tokio, Axum, async patterns |
java-agent | Java 21+, Spring Boot, JPA, JUnit 5 |
csharp-agent | .NET 8+, ASP.NET Core, Entity Framework, xUnit |
swift-agent | Swift 6, SwiftUI, MVVM, XCTest |
mobile-agent | React Native, Expo, Flutter |
c-agent | C23, embedded firmware, CMake |
cpp-agent | C++23, RAII, concepts, ranges, CMake |
r-agent | tidyverse, ggplot2, Shiny, testthat |
Quality Agents
| Agent | Purpose |
|---|
test-agent | Scan for untested paths, generate test suites, run and fix failures, report coverage |
review-agent | High signal-to-noise code review — bugs, security, logic errors only |
security-agent | OWASP audit: injection, auth, secrets, input validation, CVEs |
refactor-agent | Identify smells, plan safe refactoring sequences, verify with tests |
debug-agent | Hypothesis-driven debugging, root cause analysis, regression tests |
Infrastructure Agents
| Agent | Purpose |
|---|
database-agent | Schema design, Alembic migrations, query optimization, seed data |
devops-agent | GitHub Actions, Dockerfiles, deployment pipelines |
cloud-agent | Terraform, Kubernetes, AWS/Azure/GCP |
monitoring-agent | Health checks, logging, metrics, SLIs/SLOs, tracing |
performance-agent | CPU/memory profiling, bottleneck identification, benchmarks |
migration-agent | Alembic lifecycle, zero-downtime planning, upgrade/downgrade testing |
dependency-agent | CVE scanning, license compliance, outdated packages |
ci-cd | CI/CD pipeline config and validation |
Management Agents
| Agent | Purpose |
|---|
pm-agent | Central dispatcher — decomposes tasks, coordinates all other agents |
planning-agent | Scope definition, task decomposition, TODO.md and implementation plans |
brainstorm-agent | Divergent idea generation, trade-off matrices |
research-agent | Technology research, library comparison, prior art |
git-manager-agent | Merge conflicts, PR readiness, history cleanup |
release-agent | Version bumping, changelog, git tagging, GitHub Release publishing |
agent-generation-agent | Scaffold new agents from a plain-language spec |
Documentation & Design Agents
| Agent | Purpose |
|---|
docs-agent | DEV-LOG, CHANGELOG, README, API docs, docstrings, drift detection |
ui-ux-agent | WCAG compliance, responsive layouts, design-to-code |
design-systems-agent | Component libraries, design tokens, Storybook, visual regression |
Utility Agents
| Agent | Purpose |
|---|
data-science-agent | EDA, visualizations, data pipelines, statistical models |
scripts-agent | Cross-platform shell, Python, and PowerShell scripts |
project-audit | Holistic codebase QA — quality, security, tests, docs, architecture |
Creating Custom Agents
Agents are markdown files with YAML frontmatter. Create one in .github/agents/ or .claude/agents/:
---
name: my-agent
description: What this agent does
model: claude-sonnet-4-6
tools: [bash, edit, view, grep, glob]
---
Your agent instructions go here.
Define its behavior, constraints, and output format.
Or use the agent-generation-agent to scaffold one:
cw run agent-generation-agent "create an agent that audits GraphQL schemas for security issues"