SAM (Smart Agent Manager) - Autonomous TDD agent system for Claude Code, Cursor, and Antigravity
npm install sam-agents


Autonomous TDD agent system for Claude Code, Cursor, and Antigravity.
SAM orchestrates a team of specialized AI agents that transform your PRD into working, tested code using strict Test-Driven Development (RED-GREEN-REFACTOR).
``bashInteractive mode (choose your platform)
npx sam-agents
Supported Platforms
| Platform | Install Command | Skill Format |
|----------|-----------------|--------------|
| Claude Code |
npx sam-agents --platform claude | /sam: commands |
| Cursor | npx sam-agents --platform cursor | @agent mentions |
| Antigravity | npx sam-agents --platform antigravity | /sam- skills |Why SAM?
| Feature | SAM | Traditional AI Coding |
|---------|-----|----------------------|
| TDD-First | Tests written before code | Code first, tests maybe |
| BYOA | Use your own AI subscription | Pay per API call (5-10x cost) |
| Transparency | Watch agents work in real-time | Black box |
| Autonomous | Minimal intervention after PRD | Constant hand-holding |
| Multi-Platform | Claude Code + Cursor + Antigravity | Single platform lock-in |
Available Agents
| Agent | Role | Claude Code | Cursor | Antigravity |
|-------|------|-------------|--------|-------------|
| SAM | Orchestrator |
/sam:core:agents:sam | @sam | /sam-orchestrator |
| Atlas | System Architect | /sam:sam:agents:atlas | @atlas | /sam-atlas |
| Titan | Test Architect (RED) | /sam:sam:agents:titan | @titan | /sam-titan |
| Dyna | Developer (GREEN) | /sam:sam:agents:dyna | @dyna | /sam-dyna |
| Argus | Code Reviewer (REFACTOR) | /sam:sam:agents:argus | @argus | /sam-argus |
| Cosmo | CSS Reviewer (web apps) | /sam:sam:agents:cosmo | @cosmo | /sam-cosmo |
| Sage | Technical Writer | /sam:sam:agents:sage | @sage | /sam-sage |
| Iris | UX Designer | /sam:sam:agents:iris | @iris | /sam-iris |The TDD Pipeline
| Platform | Command |
|----------|---------|
| Claude Code |
/sam:core:workflows:autonomous-tdd |
| Cursor | @sam-tdd |
| Antigravity | /sam-tdd-pipeline |$3
1. Validate PRD - Atlas + Iris review requirements
2. Generate Stories - Break down into epics and user stories
3. TDD Loop - For each story:
- RED: Titan writes failing tests
- GREEN: Dyna writes minimal code to pass
- REFACTOR: Argus improves code quality
- CSS: Cosmo reviews styling consistency (web apps only)
4. Complete - Sage generates documentation
What Gets Installed
`
your-project/
├── _sam/ # Agent definitions (shared)
│ ├── agents/ # Individual agent configs
│ └── core/workflows/ # TDD pipeline workflow
├── .claude/commands/sam/ # Claude Code skills
├── .cursor/rules/ # Cursor rules
└── .agent/skills/ # Antigravity skills
``- Node.js 16+
- One of:
- Claude Code CLI
- Cursor
- Google Antigravity
We welcome contributions! See CONTRIBUTING.md for guidelines.
MIT - see LICENSE for details.
---
Built with AI. Powered by TDD.