Skip to content

james-prodopen/triage

Repository files navigation

Triage

Data to help leaders answer these questions:

  • Which devs are outperforming/underperforming expectations?
  • Which devs is the team most reliant on? Is the team becoming more/less balanced?
  • Which parts of our codebase are costliest to maintain? Which are becoming more costly?
  • What areas of code should we focus on to reduce bugs/regressions?

Performance analytics

PR summary, per developer

Which devs are outperforming/underperforming expectations? With AI writing more code, these metrics focus on collaboration to assess performance.

PR summary per developer

Active PR context, by dev

Which devs is the team most reliant on? Is the team becoming more/less balanced? Who might be at silent risk of burnout/attrition?

Active PR context by dev

Bugfix PR breakdown

What share of PRs in each repo are bugfixes?

Bugfix PR breakdown

Bugfixes as share of team PR throughput

Which parts of our codebase are costliest to maintain? Which are becoming more costly?

  • The more consistent in size/complexity your PRs, the more useful this metric

Bugfixes as share of team PR throughput

Code hotspots

What areas of code are most brittle? Where should we focus first to reduce bugs/regressions?

  • Likely more useful for LLM-generated or old code you/your team are less familiar with

Code hotspots

Quickstart

Installation

  1. Clone the repository and install dependencies:
npm install
  1. Generate a GitHub Personal Access Token with access to the repos you want to analyze.

  2. Copy the .env.example file and add your GitHub token:

GITHUB_TOKEN=your_github_personal_access_token
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000

Configuration

On first launch, configure the dashboard for your team:

  1. Repositories - GitHub repositories your team contributes to
  2. Authors - GitHub usernames for your devs (e.g. helpful to filter monorepos with multiple teams)
  3. Bugfix Query - GitHub search query to identify bugfix PRs
  • e.g. replace fix in:title with label:bug if more accurate for your team
  • Yes, this query will likely be incomplete
  1. Total PRs Query - GitHub search query for all PRs created by your team

Configuration is automatically saved to config.json for persistence.

License

This project is licensed under the MIT License - see the LICENSE file for details.

About

Engineering performance metrics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published