archyl-roi

Compute net monthly ROI from DORA metrics, drift, ADRs, and ownership data.

1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/archyl-com/agent-skills --skill archyl-roi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: archyl-roi
Source: https://github.com/archyl-com/agent-skills/tree/main/plugins/archyl-developer/skills/archyl-roi
Command: npx skills add https://github.com/archyl-com/agent-skills --skill archyl-roi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ROI analysis for software architecture decisions by quantifying financial and productivity impact through DORA metrics, drift, and conformance data to support executive decisions.

Core Features & Use Cases

  • Four-lens ROI modeling (Productivity, Reliability, Debt, and Decision Impact) using DORA, drift, ADRs, and ownership data.
  • Per-ADR analysis with before/after metrics to prioritize architecture changes and forecast ROI.
  • Executive, team, and architect reports with transparent assumptions and payback projections.

Quick Start

Provide a target project and time window to run an ROI analysis and generate the executive report.

Frequently Asked Questions about archyl-roi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I measure architecture ROI using DORA metrics and drift data?

Architecture ROI is measured by collecting DORA metrics, drift data, ADRs, and ownership information for a target project, then comparing before and after periods around ADRs or releases to compute productivity, reliability, debt, and decision impact into a net monthly ROI.

What is the best way to quantify the financial impact of software architecture decisions?

Quantifying the financial impact of architecture decisions involves a four-lens ROI model analyzing productivity, reliability, debt, and decision impact using DORA and conformance data, generating executive, team, and ADR-level reports with transparent assumptions and payback projections.

Can I calculate ROI for individual Architecture Decision Records before implementation?

Yes, per-ADR analysis is supported by comparing before and after metrics around each Architecture Decision Record to prioritize architecture changes, forecast ROI, and generate ADR-level reports with confidence levels based on defined cost parameters.

What data do I need to generate an executive report for architecture investment analysis?

Generating an executive report for architecture investment analysis requires defining a target project and analysis period to collect DORA metrics, drift data, ADRs, and ownership information, which then aggregates into a net monthly ROI with transparent assumptions.

Does architecture ROI analysis work for tracking technical debt reduction over time?

Architecture ROI analysis tracks technical debt reduction by evaluating the debt lens through drift and conformance data, comparing periods around releases or ADRs to measure impact and aggregate the results into monthly ROI calculations.

When should I not rely on ROI analysis for software architecture decisions?

ROI analysis for software architecture decisions requires defined cost parameters and sufficient before and after data around ADRs or releases, so it is not suitable when historical DORA metrics, drift data, or ownership information are unavailable for the target project.