https://github.com/ek33450505/cast-agents
CAST specialist agent definitions — 23 production-grade Claude Code agents (commit, debug, review, plan, test, research, and more)
https://github.com/ek33450505/cast-agents
agent-framework agents ai-agents anthropic cast claude-code cli developer-tools open-source specialists
Last synced: 13 days ago
JSON representation
CAST specialist agent definitions — 23 production-grade Claude Code agents (commit, debug, review, plan, test, research, and more)
- Host: GitHub
- URL: https://github.com/ek33450505/cast-agents
- Owner: ek33450505
- License: mit
- Created: 2026-04-02T21:34:09.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-25T22:09:48.000Z (29 days ago)
- Last Synced: 2026-05-26T00:23:31.069Z (29 days ago)
- Topics: agent-framework, agents, ai-agents, anthropic, cast, claude-code, cli, developer-tools, open-source, specialists
- Language: Shell
- Size: 171 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# cast-agents
[](https://github.com/ek33450505/cast-agents/actions/workflows/ci.yml)
23 specialist Claude Code agent definitions. Drop them into `~/.claude/agents/` and they are immediately available in any Claude Code session. Commit, review, debug, plan, research, test — each task goes to the right expert.
## What you get
Every agent is a markdown file with a YAML frontmatter block that Claude Code reads as a named sub-agent. Dispatch any agent by name from within a session:
> "Use the code-reviewer agent to review my changes"
> "Dispatch the debugger agent to fix this TypeScript error"
> "Use the researcher agent to analyze this architectural question"
Agents handle one concern well, use the right model for the job (haiku for speed, sonnet for reasoning), and always end with a structured `Status:` block so orchestrators can route their output reliably.
## Install
### Homebrew
```bash
brew tap ek33450505/cast-agents
brew install cast-agents
cast-agents install
```
### Manual
```bash
git clone --recurse-submodules https://github.com/ek33450505/cast-agents.git
cd cast-agents
bash install.sh
```
## Agent roster
### General-purpose agents
Work standalone with any Claude Code setup — no CAST framework required.
| Agent | Model | Effort | What it does |
|---|---|---|---|
| `api-contract` | sonnet | medium | API contract guardian. Detects breaking changes in REST endpoints, compares route signatures and response shapes, generates OpenAPI-style diffs |
| `bash-specialist` | haiku | low | Complex shell scripts, debugging Bash, BATS tests |
| `code-reviewer` | haiku | low | Immediate post-change code review |
| `code-writer` | sonnet | high | Feature implementation, refactors, bug fixes |
| `commit` | haiku | low | Semantic git commit message generation |
| `debugger` | sonnet | high | Error triage, root cause analysis, fixes |
| `dep-auditor` | haiku | low | Dependency auditor. Reviews package changes for transitive risk, known CVEs, version compatibility, and license concerns |
| `devops` | haiku | low | CI/CD, Docker, shell automation, deployments |
| `docs` | haiku | low | Documentation, changelogs, README files |
| `eval-writer` | sonnet | medium | Eval and benchmark fixture author for Claude API and CAST agent prompts. Generates regression fixtures that catch prompt-level behavior drift |
| `frontend-qa` | haiku | low | UI component review and accessibility checks |
| `merge` | haiku | low | Git merge, rebase, and conflict resolution — merges branches, resolves conflicts, prunes dead worktrees |
| `migration-reviewer` | opus | high | Database schema change reviewer. Analyzes migration files for safety, generates rollback plans, validates ordering, and checks for data-loss risks |
| `perf-sentinel` | sonnet | medium | Performance regression detector. Runs benchmarks, interprets results in context of recent changes, and suggests git bisect targets |
| `planner` | sonnet | high | Write structured plans with Agent Dispatch Manifests |
| `pr-reviewer` | sonnet | medium | Holistic pull-request reviewer. Reads the full diff, commit history, and linked issues at PR-open time |
| `push` | haiku | low | Safe git push with pre-push validation |
| `release-notes` | haiku | low | Release notes generator. Creates structured changelogs from git commits, resolved issues, and breaking changes between two refs |
| `researcher` | sonnet | high | Deep investigation, multi-step analysis |
| `security` | sonnet | medium | Security audits, vulnerability assessment |
| `test-runner` | haiku | low | Run test suites, report failures |
| `test-writer` | haiku | low | Write tests for new features and edge cases |
### CAST-enhanced agents
Work standalone, but produce richer output when the CAST observability database (`cast.db`) is present.
| Agent | Model | Effort | What it does |
|---|---|---|---|
| `morning-briefing` | haiku | low | Daily briefing: git activity, plans, session summary |
## The Status block contract
Every agent ends its response with a structured Status block:
```
Status: DONE
Summary: Reviewed 3 files, found 2 issues, both addressed.
```
Valid values:
| Status | Meaning |
|---|---|
| `DONE` | Task completed successfully |
| `DONE_WITH_CONCERNS` | Completed, but human attention needed on something |
| `BLOCKED` | Cannot proceed — missing input, permission, or context |
| `NEEDS_CONTEXT` | Stopped to ask a clarifying question before continuing |
This contract is what makes automated orchestration reliable. The orchestrator reads the Status line to decide whether to continue, retry, or stop and wait for human intervention — no natural language parsing required.
Example `DONE_WITH_CONCERNS`:
```
Status: DONE_WITH_CONCERNS
Summary: Tests written for 5 functions.
Concerns: coverage/auth.ts is at 61% — below the 80% threshold. Consider adding edge case tests for token expiry.
```
## Model selection rationale
Haiku agents handle high-frequency, low-complexity tasks — commit messages, code review, push validation, running tests, doc writing, shell scripting, devops, morning briefings, dep auditing, release notes, and test writing. Sonnet agents handle reasoning-heavy work — writing code, debugging, planning, research, security review, API contracts, eval writing, PR review, and performance analysis. Opus is reserved for migration-reviewer, where the cost of a missed data-loss risk outweighs the model price difference. The 13 haiku / 9 sonnet / 1 opus split and the cost differences between models makes this worth understanding before you dispatch everything to sonnet.
Rule of thumb: if the task requires reading and deciding (not reading and writing), start with haiku.
## Usage examples
```
# After implementing a feature:
"Use the commit agent to commit my staged changes"
# After writing code:
"Use the code-reviewer agent to review the changes in src/api/"
# When something breaks:
"Dispatch the debugger agent — getting TypeError: Cannot read property 'id' of undefined in line 42"
# Before a complex task:
"Use the planner agent to write a plan for refactoring the auth module"
# Research question:
"Use the researcher agent to analyze tradeoffs between JWT and session-based auth for our stack"
```
## Works with CAST
These agents are extracted from [CAST](https://github.com/ek33450505/claude-agent-team) — a full multi-agent framework built on Claude Code with orchestration, hooks, observability (cast.db), and automated plan execution. If you want the complete framework — including the `planner` agent working at full capacity with ADM manifests, plus CI hooks and a dashboard — install CAST.
cast-agents is for teams and individuals who want the specialized agents without the full framework.
## CAST Ecosystem
> Auto-synced from [claude-agent-team/docs/ecosystem.md](https://github.com/ek33450505/claude-agent-team/blob/main/docs/ecosystem.md). Run `~/Projects/personal/claude-agent-team/scripts/sync-ecosystem-readme.sh` to refresh.
| Repo | Description | Latest | Install |
|---|---|---|---|
| [cast-hooks](https://github.com/ek33450505/cast-hooks) | 13 auditable hook scripts — observability, safety guards, quality gates. SessionStart, PreToolUse, PostToolUse, PostCompact. |  | `brew tap ek33450505/cast-hooks && brew install cast-hooks` |
| [cast-agents](https://github.com/ek33450505/cast-agents) | 23 specialist agents — commit, debug, review, plan, test, research, and more. Agent definitions with YAML frontmatter. v7-synced. |  | `brew tap ek33450505/cast-agents && brew install cast-agents` |
| [cast-memory](https://github.com/ek33450505/cast-memory) | Persistent agent memory with FTS5 search, relevance scoring, shared pool, semantic embeddings. Per-agent knowledge accumulation. |  | `brew tap ek33450505/cast-memory && brew install cast-memory` |
| [cast-routines](https://github.com/ek33450505/cast-routines) | Scheduled autonomous Claude Code routines via YAML + cron. Daily briefings, inbox triage, release celebration, weekly cost reports. |  | `brew tap ek33450505/cast-routines && brew install cast-routines` |
| [cast-parallel](https://github.com/ek33450505/cast-parallel) | Parallel agent execution across worktree sessions. Agent Dispatch Manifest (ADM) support. |  | `brew tap ek33450505/cast-parallel && brew install cast-parallel` |
| [cast-observe](https://github.com/ek33450505/cast-observe) | Session-level observability — cost tracking, agent run history, token spend, event sourcing. Feeds cast.db. |  | `brew tap ek33450505/cast-observe && brew install cast-observe` |
| [cast-security](https://github.com/ek33450505/cast-security) | Security hooks and audit trails. PII redaction, parry-guard integration, compliance logging. |  | `brew tap ek33450505/cast-security && brew install cast-security` |
| [cast-doctor](https://github.com/ek33450505/cast-doctor) | Read-only health check for any Claude Code install. Validates hooks, MCP servers, agent frontmatter, cast.db schema, stale memories. |  | `brew tap ek33450505/cast-doctor && brew install cast-doctor` |
| [cast-time](https://github.com/ek33450505/cast-time) | Gives Claude Code a clock — injects local time, timezone, and a semantic time-of-day bucket at every SessionStart. |  | `brew tap ek33450505/cast-time && brew install cast-time` |
| [cast-dash](https://github.com/ek33450505/cast-dash) | Terminal UI dashboard for live swarm monitoring. 4-panel real-time display (Textual framework). |  | `brew tap ek33450505/cast-dash && brew install cast-dash` |
| [cast-claudes_journal](https://github.com/ek33450505/cast-claudes_journal) | Session continuity — Claude's Journal auto-injects prior-day context via SessionStart hook. Obsidian vault sync. |  | `brew tap ek33450505/homebrew-claudes-journal && brew install claudes-journal` |
| [cast-website](https://github.com/ek33450505/cast-website) | castframework.dev — marketing site and docs portal for the CAST ecosystem. |  | — |
| [cast-desktop](https://github.com/ek33450505/cast-desktop) | Tauri 2 native app — embedded PTY terminal, command palette, 11 dashboard views. |  | `brew tap ek33450505/homebrew-cast-desktop && brew install cast-desktop` |
## License
MIT — see [LICENSE](LICENSE)