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.