DORA Metrics Narrative

Overview

Draft and maintain the DORA four key metrics narrative: deployment frequency, lead time for changes, MTTR, and change fail rate. Covers current state, targets, trends, and measurement approach.

Getting Started

Add your source materials to the project workspace, then activate the DORA Metrics Narrative skill. The agent will guide you through the process step by step.

Example Conversation

Below is an example of how a typical DORA metrics narrative session unfolds. The agent confirms scope and then drafts the four key metrics report.

You: We need a DORA metrics narrative for the last quarter. Can you draft it with deployment frequency, lead time, MTTR, and change fail rate?

Agent: I’ll draft the DORA metrics narrative. Do you have current values or dashboards in the workspace I should use, or should I use placeholders and definitions from the DORA reference?

You: We have a CSV with deployment counts and lead times. Use that and add placeholders for MTTR and change fail rate where we don’t have data yet.

Agent: I’ve loaded the DORA four metrics reference. I’ll create a narrative with a section per metric: definition, current value (from your CSV where available), target, trend, and how we measure it. I’ll mark MTTR and change fail rate as TBD with a short note on how to measure them.

Sample Output Excerpt

Below is a representative excerpt from a DORA metrics narrative document.

Deployment frequency

Definition: How often we deploy to production. Current (Q3): 12 deploys/week (median). Target: Elite (multiple per day). Trend: Up from 8/week in Q2. Measurement: Count of production deployments from our CI/CD pipeline; we exclude rollbacks from the count.

Lead time for changes

Definition: Time from commit to production. Current (Q3): Median 2 days. Target: Under one day. Trend: Stable. Measurement: Pipeline timestamps from commit to production deploy; we report median and 90th percentile.

Extension and validation

This skill does not include custom validation tools. Elaboration is guided by the workflow in the skill and the DORA four metrics reference. You can add extension tools later (e.g. to check that all four metrics are present) by editing the skill’s extension.ts.