Engineering team health scoring — DORA metrics, SPACE framework signals, and AI-synthesized insights.
TeamHealthRadar is a FastAPI service that continuously scores engineering
team health by combining DORA delivery metrics, SPACE framework signals, and
AI-synthesized narratives. It gives engineering leaders a weekly, data-driven
view of team performance without relying on subjective pulse surveys alone.
Built for engineering leaders in regulated financial services and manufacturing where team performance data feeds into capacity planning, audit evidence, and executive reporting.
| Endpoint | Description |
|---|---|
GET /health |
Service health check |
GET /teams |
List all tracked teams |
GET /teams/{team}/score |
Current health score for a team |
GET /teams/{team}/metrics |
DORA + SPACE metrics breakdown |
GET /teams/{team}/narrative |
AI-synthesized weekly health narrative |
GET /benchmarks |
DORA elite/high/medium/low band definitions |
- Deployment frequency
- Lead time for changes
- Change failure rate
- Mean time to restore
- Satisfaction signals (PR review sentiment)
- Performance (throughput, quality)
- Activity (commits, reviews, deployments)
- Communication (PR turnaround, comment density)
- Efficiency (cycle time, WIP limits)
pip install TeamHealthRadar
export GITHUB_TOKEN=your_token
export JIRA_URL=https://your-org.atlassian.net
export JIRA_TOKEN=your_token
team-health-radar
# API available at http://localhost:8000| Variable | Description | Required |
|---|---|---|
GITHUB_TOKEN |
GitHub API token | No |
JIRA_URL |
JIRA instance URL | No |
JIRA_TOKEN |
JIRA API token | No |
ANTHROPIC_API_KEY |
For AI narratives | No |
See CONTRIBUTING.md.
Apache 2.0 — see LICENSE.