Skip to content

Metrics Dashboard

Purpose

Metrics Dashboard is the iteration-level measurement summary. Its unique job is to compare current metric values against explicit baselines, interpret direction and tolerance, and produce a clear decision about improvement, regression, or noise.

For how this artifact relates to metric definitions, security-metrics, and the improvement backlog, see the “Metric Four-Way Slice” section of workflows/activities/06-iterate/README.md.

Example

Show a worked example of this artifact
---
ddx:
  id: example.metrics-dashboard.depositmatch.csv-import
  authoring:
    home: repo
  depends_on:
    - example.metric-definition.depositmatch.csv-import-validation-seconds
---

# Metrics Dashboard: DepositMatch CSV Import Pilot Readiness

**Review Window**: 2026-05-05 - 2026-05-12
**Baseline**: FEAT-001 pre-release benchmark floor from 2026-05-05

## Decision

The latest change improved CSV import validation time and remains within the
FEAT-001 performance target. No performance backlog item is required for this
metric. Continue monitoring during pilot rollout.

## Summary

The representative 10,000-row CSV import validation benchmark improved from
5.8 seconds to 4.4 seconds. The current value is below the 5-second target and
outside the 5% noise band, so the result counts as a meaningful improvement.

## Metrics Table

| Metric | Baseline | Current | Direction | Result | Source |
|--------|----------|---------|-----------|--------|--------|
| `csv-import-validation-seconds` | 5.8 seconds | 4.4 seconds | lower | pass / improved | `docs/helix/06-iterate/metrics/csv-import-validation-seconds.yaml`; `pnpm metric:csv-import-validation -- --fixture fixtures/import/acme-10000-rows` |

## Interpretation Rules

- Values within 5% of baseline are treated as noise.
- Values above 5 seconds violate the FEAT-001 performance target and create an
  improvement backlog candidate.
- Values below target but worse than baseline by more than 5% create a watch
  item, not an automatic build task.

## Trend Notes

- Validation improved after switching row checks to batched normalization before
  persistence.
- No corresponding increase in upload API 5xx rate was observed in staging.
- Pilot rollout should still watch p95 upload response time because production
  file sizes may differ from fixture data.

## Follow-Up

- No immediate improvement issue.
- Continue pilot monitoring through the deployment checklist signals.
- Re-run the benchmark after adding column mapping and row-level validation
  stories.

Reference

ActivityIterate — Measure, align, and improve. Close the feedback loop back into the planning strand.
Default locationdocs/helix/06-iterate/metrics-dashboard.md
RequiresNone
EnablesNone
InformsImprovement Backlog
Status Report
HELIX documentsdocs/helix/06-iterate/metrics-dashboard.md
Generation prompt
Show the full generation prompt
# Metrics Dashboard Generation Prompt

Document the iteration-level metrics summary used to judge whether the latest
changeset improved the system.

## Purpose

Metrics Dashboard is the **iteration-level measurement summary**. Its unique
job is to compare current metric values against explicit baselines, interpret
direction and tolerance, and produce a clear decision about improvement,
regression, or noise.

For how this artifact relates to metric definitions, security-metrics, and the
improvement backlog, see the "Metric Four-Way Slice" section of
`workflows/activities/06-iterate/README.md`.

## Reference Anchors

Use this local resource summary as grounding:

- `docs/resources/google-sre-monitoring-distributed-systems.md` grounds
  dashboard summaries as interpreted quantitative signals with clear sources.

## Focus
- Start from the canonical metric definitions in `docs/helix/06-iterate/metrics/`.
- Compare the current measurement against the previous baseline or committed floor.
- State whether the change improved, regressed, or stayed within noise.
- Include only the metrics needed to support the decision.
- Cite the source of each metric and the measurement command or report.
- Keep raw observability setup and implementation details out of this artifact.
- When the product has user journeys, add the optional Journey Funnels table:
  per journey, the completion rate against its baseline, the step people drop
  off at most, and the diagnosis. Route the fix to the improvement backlog.
  Cite the analytics export as a source; dated exports are run output and stay
  out of the repo.

## Boundary Test

| If you are writing... | Put it in... |
|---|---|
| Metric unit, command, tolerance, and labels | Metric Definition |
| Current-vs-baseline interpretation for one iteration | Metrics Dashboard |
| Prioritized follow-up work | Improvement Backlog |
| Alerting or dashboard implementation details | Monitoring Setup |

## Completion Criteria
- Every metric cited has a source definition and current value.
- The comparison baseline is explicit.
- The conclusion is actionable and easy to hand to the next iteration.
Template
Show the template structure
---
ddx:
  id: metrics-dashboard
  authoring:
    home: repo
---

# Metrics Dashboard: [iteration or release]

**Review Window**: [start date - end date]
**Baseline**: [previous iteration, ratchet floor, or benchmark]

## Decision

[State whether the latest change improved the system and why.]

## Summary

[One concise paragraph that summarizes the result of the measured change.]

## Metrics Table

| Metric | Baseline | Current | Direction | Result | Source |
|--------|----------|---------|-----------|--------|--------|
| [name] | [value] | [value] | [higher/lower] | [pass/fail/noise] | [metric definition or report] |

## Interpretation Rules

- [How tolerance/noise is applied]
- [What creates a follow-up]

## Trend Notes

- [Trend or anomaly]
- [What changed relative to the baseline]

## Journey Funnels

[Optional. For a product with user journeys: one row per journey, named by the
journey. Delete if not relevant.]

| Journey | Completion | Biggest Drop-off | Diagnosis | Source |
|---------|------------|------------------|-----------|--------|
| [journey name] | [share who finish, against baseline] | [the step people leave most] | [why, and the follow-up] | [metric definition or report] |

## Follow-Up

- [Tracker issue ID or next step]
Innsigle seal: model-primary by HELIX

The signature covers the markdown source of this page, not these HTML bytes. This page quotes that seal; verify it against the source file.

Composition
model-primary
Issuer
HELIX helix
Signing key
ed25519:b0865d76d834a52c48506414d16f4e5a (build key)
Signed source
artifact-types/iterate/metrics-dashboard.md
Signed
2026-11-16T15:52:45Z
Content digest
sha256:254ead9f…c9c92655

This build key is endorsed by the human key for build signing; the signature is not a detector and not a truth guarantee.

Raw attestation JSON
{
  "payload": {
    "innsigle": "1",
    "type": "https://innsigle.dev/claim/colophon/v1",
    "issued_at": "2026-11-16T15:52:45Z",
    "issuer": {
      "id": "helix",
      "name": "HELIX",
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "key_url": "https://documentdrivendx.github.io/helix/.well-known/innsigle/keys.json"
    },
    "subjects": [
      {
        "uri": "https://documentdrivendx.github.io/helix/artifact-types/iterate/metrics-dashboard/",
        "digest": {
          "alg": "sha256",
          "value": "254ead9f594202fd04009ddbde61ee87e0436c433f781e6c67a9bcdcc9c92655"
        }
      }
    ],
    "colophon": {
      "schema_version": "1",
      "composition": "model-primary",
      "ingredients": [
        {
          "kind": "model",
          "name": "Claude",
          "role": "draft"
        },
        {
          "kind": "tool",
          "name": "sloptimizer",
          "role": "rewrite"
        },
        {
          "kind": "human",
          "name": "operator",
          "role": "structure-edit"
        }
      ],
      "notes": null
    }
  },
  "payload_encoding": "json",
  "signatures": [
    {
      "key_id": "ed25519:b0865d76d834a52c48506414d16f4e5a",
      "alg": "ed25519",
      "sig": "reIpAsTzjJItHyOs44pbWIEFvhY3l3wDq9PgfteBkWoPq-rpfZBh1bgLYU6qDIKp9709wE_W-11MfM0-7X2pAQ",
      "signed_at": "2026-11-16T15:52:45Z"
    }
  ]
}