Swarm - Multi-Agent SaaS Orchestration

Technology Stack

Multi-agent SaaS orchestration system using Claude Code CLI to coordinate specialized AI agents for building complete full-stack applications. Decomposes project requirements and delegates to backend, frontend, mobile, and DevOps agents.

CLIClaude Code

OrchestrationPython Async

BackendExpress + Prisma

FrontendNext.js

MobileSwift/SwiftUI

DevOpsDocker + Terraform

Workflow 1: Project Decomposition & Analysis

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart TB
    subgraph Input["📥 PROJECT INPUT"]
        REQ["📄 Project Outline"]
        CFG["⚙️ Config YAML"]
    end
    subgraph Decomposer["🔍 DECOMPOSITION"]
        LOAD["📥 Load Description"]
        ANALYZE["🧠 Analyze Context"]
    end
    subgraph Specs["📋 TASK SPECIFICATIONS"]
        BACK["🔧 Backend Spec
API, Auth, DB"]
        FRONT["🖥️ Frontend Spec
Pages, Components"]
        MOBILE["📱 Mobile Spec
Screens, Navigation"]
        DEVOPS["☁️ DevOps Spec
CI/CD, Infra"]
    end
    subgraph Output["📤 OUTPUT"]
        JSON[("📄 project_breakdown.json")]
    end
    REQ --> LOAD
    CFG --> LOAD
    LOAD --> ANALYZE
    ANALYZE --> BACK
    ANALYZE --> FRONT
    ANALYZE --> MOBILE
    ANALYZE --> DEVOPS
    BACK --> JSON
    FRONT --> JSON
    MOBILE --> JSON
    DEVOPS --> JSON

Workflow 2: Backend API Development (Stage 1)

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart LR
    subgraph Input["📥 BACKEND TASK"]
        SPEC["📋 Backend Spec"]
    end
    subgraph CLI["🤖 CLAUDE CODE CLI"]
        INIT["🔧 Init Workspace"]
        PROMPT["📝 Generate Prompt
Express + Prisma + JWT"]
        EXEC["⚙️ Execute CLI"]
        RETRY["🔄 Retry Logic"]
    end
    subgraph Gen["📦 GENERATED CODE"]
        SRC["📁 output/api/src/"]
        TESTS["🧪 output/api/tests/"]
        DOCS["📚 output/api/docs/"]
    end
    subgraph Shared["🔗 SHARED CONTEXT"]
        OPENAPI[("📄 api-spec.yaml")]
    end
    SPEC --> INIT
    INIT --> PROMPT
    PROMPT --> EXEC
    EXEC -->|"Fail"| RETRY
    RETRY --> EXEC
    EXEC --> SRC
    EXEC --> TESTS
    EXEC --> DOCS
    DOCS --> OPENAPI

Workflow 3: Frontend Web Client (Stage 2, Parallel)

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart TB
    subgraph Dep["⏳ DEPENDENCY"]
        WAIT["⏳ Wait for Backend"]
        FLAG["✅ backend_complete"]
    end
    subgraph Context["📚 CONTEXT"]
        APISPEC[("📄 api-spec.yaml")]
        FRONTSPEC["📋 Frontend Spec"]
    end
    subgraph CLI["🤖 CLAUDE CODE CLI"]
        INIT["🔧 Init Workspace"]
        PROMPT["📝 Next.js + TypeScript
Tailwind + React Query"]
        EXEC["⚙️ Execute CLI"]
    end
    subgraph Output["📦 OUTPUT"]
        WEB["📁 output/web/src/"]
        ASSETS["🎨 output/web/public/"]
    end
    WAIT --> FLAG
    FLAG --> INIT
    APISPEC --> PROMPT
    FRONTSPEC --> INIT
    INIT --> PROMPT
    PROMPT --> EXEC
    EXEC --> WEB
    EXEC --> ASSETS

Workflow 4: Mobile iOS App (Stage 2, Parallel)

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart TB
    subgraph Dep["⏳ DEPENDENCY"]
        WAIT["⏳ Wait for Backend"]
        FLAG["✅ backend_complete"]
    end
    subgraph Context["📚 CONTEXT"]
        APISPEC[("📄 api-spec.yaml")]
        MOBILESPEC["📋 Mobile Spec"]
    end
    subgraph CLI["🤖 CLAUDE CODE CLI"]
        INIT["🔧 Init Workspace"]
        PROMPT["📝 Swift + SwiftUI
MVVM + Keychain"]
        EXEC["⚙️ Execute CLI"]
    end
    subgraph Output["📦 OUTPUT"]
        IOS["📁 output/ios/App/"]
        XCODE["📱 Xcode Project"]
    end
    WAIT --> FLAG
    FLAG --> INIT
    APISPEC --> PROMPT
    MOBILESPEC --> INIT
    INIT --> PROMPT
    PROMPT --> EXEC
    EXEC --> IOS
    EXEC --> XCODE

Workflow 5: DevOps Infrastructure (Stage 3)

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart LR
    subgraph Dep["⏳ DEPENDENCIES"]
        BACK["✅ Backend Complete"]
        FRONT["✅ Frontend Complete"]
        MOBILE["✅ Mobile Complete"]
    end
    subgraph CLI["🤖 CLAUDE CODE CLI"]
        SPEC["📋 DevOps Spec"]
        PROMPT["📝 Docker + Terraform
GitHub Actions"]
        EXEC["⚙️ Execute CLI"]
    end
    subgraph Output["📦 INFRASTRUCTURE"]
        DOCKER["🐳 output/infrastructure/docker/"]
        TF["☁️ output/infrastructure/terraform/"]
        GHA["⚙️ .github/workflows/"]
    end
    BACK --> SPEC
    FRONT --> SPEC
    MOBILE --> SPEC
    SPEC --> PROMPT
    PROMPT --> EXEC
    EXEC --> DOCKER
    EXEC --> TF
    EXEC --> GHA

Workflow 6: Real-Time Progress Monitoring & Coordination

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#C17852', 'primaryTextColor': '#F0F6FC', 'primaryBorderColor': '#4A5E32', 'lineColor': '#E6C98F', 'secondaryColor': '#161B22', 'tertiaryColor': '#0D1117'}}}%%
flowchart TB
    subgraph Init["🚀 INITIALIZATION"]
        BUS["📡 Message Bus"]
        MON["📊 Progress Monitor"]
        REG["📝 Register Agents"]
    end
    subgraph Stage1["STAGE 1"]
        S1["🔧 Backend Agent"]
    end
    subgraph Stage2["STAGE 2 (Parallel)"]
        S2A["🖥️ Frontend Agent"]
        S2B["📱 Mobile Agent"]
    end
    subgraph Stage3["STAGE 3"]
        S3["☁️ DevOps Agent"]
    end
    subgraph Dashboard["📊 LIVE DASHBOARD"]
        STATUS["📈 Agent Status
PENDING → RUNNING → COMPLETE"]
        PROGRESS["📊 Progress Bars"]
        TIME["⏱️ Duration Tracking"]
    end
    subgraph Output["📤 FINAL"]
        LOG[("📄 agents.log")]
        REPORT["📋 Summary Report"]
    end
    BUS --> MON
    MON --> REG
    REG --> S1
    S1 -->|"Complete"| S2A
    S1 -->|"Complete"| S2B
    S2A --> S3
    S2B --> S3
    S1 --> STATUS
    S2A --> STATUS
    S2B --> STATUS
    S3 --> STATUS
    STATUS --> PROGRESS
    PROGRESS --> TIME
    S3 --> LOG
    LOG --> REPORT