SprintFlow architecture#

flowchart LR
    dev([Developers<br/>Managers<br/>Admins]) -->|SSO, browser| console
    subgraph SprintFlow
      console[Web console<br/>+ API]
      workers[Workers]
      db[(PostgreSQL<br/>state, queue,<br/>console data)]
      s3[(S3 / MinIO<br/>reports, patches,<br/>proof videos)]
      console <--> db
      workers <--> db
      workers --> s3
      console -->|signed links| s3
    end
    jira[Jira] <-->|stories, sprints,<br/>comments, status| workers
    jira -. webhooks .-> console
    git[GitLab / GitHub /<br/>Bitbucket / Azure DevOps] <-->|clone, draft MR,<br/>review comments, CI| workers
    git -. webhooks .-> console
    claude[Claude<br/>Anthropic API / Bedrock / Vertex] <-->|redacted prompts| workers
    workers -->|alerts| chat[Slack / Teams / email]
    workers -->|traces, metrics| obs[Prometheus /<br/>OpenTelemetry]

flowchart TD
    A[Story assigned / sprint starts<br/>or 'New run'] --> P[Prepare<br/>clone, detect stack]
    P --> B[Baseline<br/>build + test untouched code]
    B --> U[Understand<br/>goal, acceptance criteria,<br/>questions on Jira if needed]
    U --> PL[Plan<br/>files, approach, root cause]
    PL --> I[Implement<br/>code + tests]
    I --> V{Verify<br/>build + tests vs baseline}
    V -- new failures --> F[Fix round] --> V
    V -- ok --> R{Independent review<br/>fresh conversation}
    R -- changes requested --> F2[Fix round] --> V
    R -- approved --> RK{Risky paths?}
    RK -- yes --> AP[Person approves] --> E
    RK -- no --> E[Browser proof<br/>4K video on Jira]
    E --> PR[Draft PR/MR<br/>+ Jira In Review]
    PR --> FU[PR follow-up<br/>review comments, failed CI]
    FU -.-> PR

flowchart TB
    subgraph single[Single node - pilot, one team]
      c1[Console<br/>runs execute inline] --- pv[(Persistent volume<br/>runs + console data)]
    end
    subgraph prod[Production - scale-out]
      ing[Ingress / TLS] --> c2[Console x2<br/>one leads background work]
      c2 --> pg[(PostgreSQL)]
      w[Workers x N<br/>autoscaled] --> pg
      w --> s[(S3)]
      c2 --> s
    end