SAM - Smart Agent Manager


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).

Quick Start

``bash


Interactive mode (choose your platform)

npx sam-agents

Or specify platform directly

npx sam-agents --platform claude # Claude Code
npx sam-agents --platform cursor # Cursor IDE
npx sam-agents --platform antigravity # Google Antigravity
npx sam-agents --platform all # All platforms
`

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
``

Requirements

- Node.js 16+
- One of:
- Claude Code CLI
- Cursor
- Google Antigravity

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

License

MIT - see LICENSE for details.

---

Built with AI. Powered by TDD.