sam-agents
v0.6.1
Published
SAM (Smart Agent Manager) - Autonomous TDD agent system for Claude Code, Cursor, and Antigravity
Maintainers
Readme
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
# 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 platformsSupported 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 |
Pipeline Phases
- Validate PRD - Atlas + Iris review requirements
- Generate Stories - Break down into epics and user stories
- TDD Loop - For each story:
- RED: Titan writes failing tests
- GREEN: Dyna writes minimal code to pass
- REFACTOR: Argus improves code quality
- UI: Iris reviews layout and fixes alignment (web apps only)
- CSS: Cosmo reviews styling consistency (web apps only)
- 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 skillsRequirements
- Node.js 16+
- One of:
Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
License
MIT - see LICENSE for details.
Built with AI. Powered by TDD.
