Scrum Master Agent

Daily sprint status summaries for Scrum Masters and Engineering Managers — Spring Boot 4.0 + Spring AI 2.0 + React UI + Atlassian MCP.

Quick start (monolith)

mvn clean package
java -jar target/scrum-master-agent-1.0.0-SNAPSHOT.jar

Open the dashboard: http://localhost:8080/dashboard

Swagger: http://localhost:8080/swagger-ui.html

Frontend development (hot reload)

Terminal 1 — backend:

mvn spring-boot:run

Terminal 2 — React (Vite dev server with API proxy):

cd frontend
npm install
npm run dev

Open http://localhost:5173

Build flow

frontend: npm run build  →  frontend/dist
Maven: copy dist → target/classes/static
Package: java -jar target/scrum-master-agent.jar serves API + React UI

mvn clean package runs the frontend build automatically via frontend-maven-plugin.

UI pages

Route	Page
/dashboard	Sprint overview, health, metrics
/status	Status breakdown table + charts
/assignees	Filterable assignee risk table
/risks	Blockers, stale, spillover tickets
/report	AI report, copy/export markdown/PDF

Documentation

All detailed docs live in documentation/.

Topic	Doc
Start here / question index	documentation/README.md
What it does	documentation/PROJECT_OVERVIEW.md
Install & run	documentation/DEVELOPMENT_SETUP.md
REST APIs	documentation/API_ENDPOINTS_REFERENCE.md
Config & env vars	documentation/CONFIGURATION_REFERENCE.md
Risk rules	documentation/RISK_RULES.md
AI assistant context	documentation/CLAUDE.md

Minimum env vars

$env:JIRA_BASE_URL = "https://your-org.atlassian.net"
$env:JIRA_PAT = "your-pat"
$env:SCRUM_JIRA_BOARD_ID = "123"
$env:APP_MCP_ENABLED = "true"
$env:ATLASSIAN_MCP_URL = "http://localhost:3333"   # mcp-remote proxy
$env:OPENAI_API_KEY = "sk-..."

See documentation/DEVELOPMENT_SETUP.md for full setup.

Tests

mvn test