Software Metrics Machine

Everything runs locally on your machine.

A Data-Driven Approach to High-Performing Teams

Agile software development has become a dominant practice, but many teams struggle to consistently deliver high-value software. While story points and code maintainability metrics (like SonarQube) provide a starting point, they often miss crucial factors like team dynamics, waiting times, code churn, and the impact of knowledge silos. Metrics Machine is designed to fillin these gaps by providing a comprehensive set of metrics that reflect the health of your development process.

"software quality is a multi-dimensional concept, and no single metric can fully represent its various aspects" - Morteza Zakeri et al.

Why Metrics Machine?

We believe that the success of an Agile team is directly tied to the speed and quality with which value is delivered to production. Software Metrics Machine provides insights beyond traditional metrics.

Philosophy Drivers

• Continuous Feedback Loops: A constant cycle of observation, analysis, and adjustment is essential.
• Pipeline Health: Maintain a consistently green and stable development pipeline.
• Controlled Code Churn: Minimize unnecessary code changes, as they often indicate underlying issues.
• Knowledge Sharing: Actively avoid knowledge silos – encourage collaboration and knowledge transfer.
• Data-Based Technical Debt: Define and prioritize technical debt based on real data and impact.

Facets

This project relies on metrics that are extracted from:

• Pipeline
  • Success rate of pipeline ✅
  • Average time to complete pipeline from start to finish ✅
• Pull requests
  • Average of Pull requests opened ✅
• Git history
  • Code churn ✅
  • Hotspots ✅
  • Change Frequency ✅
  • Complexity Trends Over Time 🚧

Getting started

npm install -g @smmachine/launcher

smm

Usage: smm [options] [command]

Software Metrics Machine - High-performing team metrics

Options:
  -V, --version           output the version number
  --debug                 Enable debug logging
  --project <name>        Select active project by name (github_repository)
  -h, --help              display help for command

Commands:
  change-requests         Change request operations
  pipelines               Pipeline/workflow operations
  code                    Code analysis operations
  jira                    Jira integration operations
  sonarqube               SonarQube integration operations
  dashboard               Dashboard operations
  tools                   Utility tools
  health-check            Analyze local cache data quality
  mcp                     Model Context Protocol operations
  architecture            Architecture analysis and visualization
  engineering-health      Engineering health metrics
  filters                 Manage saved filters
  project                 Configure and manage projects
  help                    Show help information

The official documentation is hosted at github pages.

References

This project uses other tools to extract the metrics, and is inspired by other works in the field of software metrics. Here are some references:

• Metrics
  • https://github.com/adamtornhill/code-maat
  • https://pragprog.com/titles/atevol/software-design-x-rays/
  • https://github.com/fouadh/gocan
• Platform
  • https://git-scm.com/doc
  • https://docs.github.com/en/rest?apiVersion=2022-11-28
• Research
  • https://www.researchgate.net/publication/379096213_Software_Metrics_in_Agile_Software_Development_A_Review_Report