convez.ai
MCP ServerAutomaçãoAvançado
ek33450505

CAST — Control Plane para Claude Agent Teams

ek33450505/claude-agent-team

Orquestração production-grade para swarms de Claude com auditoria local e gates de qualidade

Ver no GitHub
BomPluginScore · de 0 a 100

Framework de orquestração local-first que implementa despacho dirigido por hooks, memória isolada de agentes e gates de política determinística. CAST é um plano de controle production-grade com 23 agentes especialistas pré-configurados, auditoria em SQLite local e qualidade garantida por hooks vinculativos.

Instalação

$npx convez-ai ek33450505/claude-agent-team

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
1
Acompanhando
2
Saúde
100%
Último commit
há 1 semana
Versão
v10.7.0
Issues abertas
1
Contribuidores
5

Casos de uso

  • Automação de workflows de código com múltiplos agentes especializados
  • Implementação de pipelines CI/CD com validação obrigatória por hooks
  • Auditoria e rastreabilidade completa de decisões e execuções de agentes
  • Gerenciamento escalável de teams de agentes com políticas determinísticas

Veredito

CAST é uma solução madura e bem-testada (1.199 testes BATS) para quem precisa de orquestração robusta de agentes Claude em produção. Exige familiaridade com shell scripting e DevOps, mas oferece controle total, auditoria local e nenhuma dependência de SaaS — recomendado para times que priorizam segurança e observabilidade.

README

A tradução para o português deste README ainda está na fila.

CAST

BATS Tests Version Agents Tests License Shell

CAST is a production-grade control plane for Claude Code built on three pillars: hook enforcement (every agent change is gated by validators — cast-validate-all-hooks.sh runs in CI and hookSpecificOutput shape is contract-validated), audit trail (cast.db with 38 tables records every session, agent run, routing decision, quality gate, and memory write), and a typed agent registry (23 agents, model-assigned across haiku 4.5 / sonnet / opus tiers, quality-gated, with frontmatter contracts). Define a workflow once; specialist agents plan, implement, review, test, and commit — automatically.

CAST Framework


Installation

Homebrew

brew tap ek33450505/cast && brew install cast

Manual install

git clone https://github.com/ek33450505/claude-agent-team.git
cd claude-agent-team
bash install.sh

Quick Start

docs/tutorial/getting-started.md — install, verify, and run cast status in 5 minutes.


What Makes CAST Different

  • Quality gates that actually enforce. Raw git commit and git push are hard-blocked by hooks. Code changes mandate a reviewer pass. You cannot skip this.
  • 23 specialist agents, pre-configured. Each has a bounded scope, a model tier, and a thinking budget. code-writer implements; code-reviewer reviews; commit commits. They don't cross lanes.
  • SQLite audit trail, fully local. Every agent dispatch, tool call, and token spend logs to cast.db on your machine. No SaaS dashboard, no cloud lock-in.
  • 1199 BATS test cases. Every hook script and utility is covered. CI runs on both macOS and Ubuntu on every push.

Documentation

GuideDescription
TutorialInstall CAST and run your first agent dispatch
Compatibility MatrixClaude Code version requirements and known breakages
Hook Authoring GuideWrite, test, and install custom hook scripts
Full Docs IndexAll documentation with one-line descriptions

Table of Contents

What is CAST? · Architecture · Agents · Hooks · Observability · Ecosystem · Testing · Contributing · Stats


What is CAST?

CAST transforms Agent Teams into a production-grade control plane:

  • Swarm composition in YAML. Define teams, assign roles, set quality gates. CAST bootstraps worktrees, seeds teammates with identity + prompts, manages peer messaging.
  • Structural quality gates. Code changes mandate a reviewer pass. Raw git commit and git push are hard-blocked by hooks.
  • Full observability. Every session, task, peer message, and token spend logs to cast.db (SQLite).
  • Local model routing. Haiku agents can route to a local Ollama model via claude-code-router (opt-in); token spend drops ~30-50%.

Your First Workflow

  1. Plan — /plan add user auth feature → planner writes an Agent Dispatch Manifest.
  2. Execute — /orchestrate next → code-writer implements, code-reviewer checks, test-runner verifies, commit agent stages.
  3. Ship — /ship → tests, CI sanity check, push, journal entry.

Architecture

Every CAST operation follows a four-stage flow: (1) hook validation — pre-tool hooks enforce quality gates and block non-compliant writes before any change lands; (2) agent dispatch — the typed agent registry routes work to the correct model tier (haiku 4.5 for review/commit, sonnet for implementation, opus for migration review); (3) memory injection — each agent receives relevant prior-session context from its ~/.claude/agent-memory-local/<name>/MEMORY.md on startup; (4) cast.db audit — every session, routing decision, quality gate result, and token spend is appended to the local SQLite database. See docs/architecture/ARCHITECTURE.md for the full guide including Agent Teams comparison table.


Personal Overlay

CAST ships in two layers: core (always installed) and personal (optional, --personal flag). New clones get a trustworthy, generic installation; the personal layer is optional configuration you populate locally. See docs/personal-overlay.md.

Swarm System

CAST swarms are defined in YAML and bootstrapped with cast swarm bootstrap. Teams get isolated worktrees, agent identity, peer messaging, and quality gates. See docs/swarm.md.

Observability Dashboards

claude-code-dashboard — a React 19 + Vite + Express observability UI fed live from ~/.claude/cast.db (local-only, no cloud). ~21 views covering sessions, agent analytics & reliability, hook health and failures, memory browser, plans, incidents, swarm runs, file-write audits, injection log, and a SQLite explorer. See docs/dashboard.md.

Cast Desktop — Tauri 2 native macOS app surfacing the same observability layer with an embedded PTY terminal, command palette (Cmd+K), and 11 dashboard views.


Agents

23 core specialists. Each is a markdown file in ~/.claude/agents/ with YAML frontmatter defining model, memory, isolation, and thinking budget tier. Agent responses validate against JSON schemas in schemas/. See docs/agents/AGENT-ROSTER.md for the full table with model tiers and thinking budgets.

Key agents: code-writer, debugger, planner, researcher, security, code-reviewer, commit, push, test-writer, devops, bash-specialist, migration-reviewer, api-contract, dep-auditor, perf-sentinel.


Token Efficiency & Cost Optimization

Model tiering, response budgets, Ollama local routing, laconic mode, and RTK compression achieve ~30-50% token spend reduction. See docs/TOKEN-OPTIMIZATION.md.

Optional: Local-first cheap-mode (claude-code-router)

For local Haiku-tier work without API spend, install claude-code-router and run ccr instead of claude. CCR proxies all model calls to local Ollama (default: deepseek-coder:latest). Opt-in per session — vanilla claude continues to use Anthropic API.


Hooks

Hooks cover the full swarm lifecycle: SessionStart, TaskCreated, WorktreeCreate, PreToolUse:Bash (commit guard), PostToolUse, PostCompact, SessionEnd. See docs/hooks/authoring-guide.md.

Observability & cast.db

SQLite WAL mode at ~/.claude/cast.db — append-only, never truncated. Stores swarm_sessions, teammate_runs, agent_runs, routing_events, stream_events. See docs/observability/OBSERVABILITY.md.

Peer Messaging & Gossip Protocol

Teammates communicate via cast.db message bus — no central broker, fully decentralized. See docs/architecture/ARCHITECTURE.md.

Multi-Agent Pipelines

The /orchestrate skill executes Agent Dispatch Manifests (ADM) — JSON plan files defining sequential/parallel agent batches. owns_files prevents write conflicts between parallel agents. See docs/architecture/ARCHITECTURE.md.

Agent Memory & Persistence

Each agent accumulates domain knowledge in ~/.claude/agent-memory-local/<name>/MEMORY.md. Features: FTS5 full-text search, relevance scoring, shared pool, procedural memory, session distiller. See docs/architecture/ARCHITECTURE.md.

Routines: Scheduled Workflows

11 built-in time-triggered or event-triggered agent jobs — daily briefings, inbox triage, standup, weekly cost reports, and more. Manage with cast routines list / cast routines trigger <name>. Full guide: docs/routines.md.


Project Structure

agents/ · rules-{core,personal}/ · docs/ · schemas/ · scripts/ · swarm-configs/ · tests/ · .github/workflows/

Runtime installs to ~/.claude/ — agents, memory, plans, swarm sessions, cast.db, scripts.


Testing

125 CAST-authored BATS test files (1199 test cases) covering core hooks, swarm bootstrap, message bus, database migrations, guard logic, event emission, and memory persistence. (find tests -name '*.bats' also counts ~28 vendored bats-assert/bats-support submodule self-tests.) BATS is installed via package manager — brew install bats-core (macOS) or apt-get install bats-core (Ubuntu/Debian). Run with bash tests/run.sh (the CI-glob runner; plain bats tests/ is non-recursive and skips subdirectory tests).


Version History

Full changelog: CHANGELOG.md.


CAST Ecosystem

CAST is one of 13 source repositories in a connected ecosystem — each solves a piece of the multi-agent workflow puzzle. All are open-source. See docs/ecosystem.md for the full repo table and install commands.

TierRepos
Core Frameworkcast-hooks, cast-agents, cast-memory, cast-observe, cast-security, cast-parallel
Toolingcast-claudes_journal, cast-dash, cast-time, cast-routines, cast-doctor
Observabilityclaude-code-dashboard, cast-desktop

New to CAST? Quick Start · Agent Roster · Architecture

Already using CAST? Changelog · Hook Authoring Guide · Full Docs


Used In / Built With CAST


Contributing

Contributions are welcome — CAST is built in the open and actively developed. New agents, shell script fixes, BATS test coverage, and documentation improvements are all fair game.

Good first issues: good first issue label — curated entry points with clear scope and test expectations.

See CONTRIBUTING.md for the full workflow. Open an issue first for non-trivial changes.


Support & Portfolio

Built by Ed Kubiak as a showcase of production-grade multi-agent AI tooling. Portfolio →


License

MIT — see LICENSE. Built by Edward Kubiak — full-stack engineer, Claude Code expert. CAST Portfolio: castframework.dev


Stats

Ver o original no GitHub

Bom para

Relacionados