How SAM Works

From GitHub issue to pull request, follow the journey through SAM's intelligent agent pipeline.

1
🎯

GitHub Issue

A new issue is created in your repository

What Sam does:

Sam is the first responder who analyzes incoming GitHub issues. With keen attention to detail, Sam classifies issues by type (feature, bug, question) and priority, ensuring every issue gets the attention it deserves.

2
📋

Sam (Triage)

Classifies issue type and priority

What Pete does:

Pete transforms requirements into actionable plans. As the Planning Strategist, Pete creates detailed PRDs (Product Requirements Documents) and breaks down complex features into manageable tasks.

3
🏗️

Pete (Planning)

Creates task breakdown and PRD

What Alex does:

Alex reviews the technical approach before implementation begins. As the Architecture Advisor, Alex ensures code quality, identifies potential issues, and recommends best practices.

4
✅

Alex (Architecture)

Reviews technical approach

What Veron does:

Veron validates that plans are complete and implementation-ready. The Quality Verifier ensures all requirements are captured and the approach is sound before development begins.

5
💻

Veron (Verify)

Validates the plan is complete

What Dana does:

Dana turns plans into working code. As the Implementation Specialist, Dana writes clean, tested code following existing patterns and creates pull requests with clear descriptions.

6
✍️

Dana (Development)

Implements code and creates PR

What Quill does:

Quill ensures documentation stays current. The Technical Writer updates README files, API docs, and guides whenever code changes, keeping documentation in sync with the codebase.

7
🎉

PR Created

Ready for human review and merge

Example: What Happens When You Create an Issue?

1You create an issue

# Issue Title

Add user authentication with OAuth

2GitHub sends a webhook to SAM

SAM receives the issue details and begins processing through the agent pipeline.

🎯Sam triages the issue

Type: Feature Request

Priority: High

Labels: enhancement, authentication

📋Pete creates a task breakdown

  • • Research OAuth providers (Google, GitHub)
  • • Implement OAuth flow
  • • Create user session management
  • • Add authentication middleware
  • • Write tests

🏗️Alex reviews the architecture

Ensures the approach follows best practices and identifies potential issues.

💻Dana implements the code

Writes clean, tested code following existing patterns and creates a pull request.

🎉Pull Request Created!

A complete PR is ready for your review, with code changes, tests, and documentation updates.

Get Started