des-requirements-and-kpis

Convert Phase 02 business questions into measurable data engineering requirements and KPI definitions.

2|Updated May 20, 2026
One-click install
npx skills add https://github.com/DKSang/DES-SKILL --skill des-requirements-and-kpis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: des-requirements-and-kpis
Source: https://github.com/DKSang/DES-SKILL/tree/main/skills/des-requirements-and-kpis
Command: npx skills add https://github.com/DKSang/DES-SKILL --skill des-requirements-and-kpis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

des-requirements-and-kpis converts approved business questions into explicit, measurable data engineering requirements and KPI definitions so downstream phases can design data products from evidence rather than vague assumptions.

Core Features & Use Cases

  • Requirements & KPI Catalog creation: Produces functional/non-functional requirements, candidate KPIs, and KPI/metric definitions with acceptance criteria and traceability.
  • Phase-orchestrated validation: Uses evidence mapping and a Done Gate to decide whether Phase 03 is Pass, Pass with risks, Fail, or Blocked.
  • HALT-safe decision handling: Stops to request user decisions when formulas, grain, owners, SLAs/freshness, acceptance criteria, or conflicts cannot be safely inferred.

Quick Start

Use the des-requirements-and-kpis skill to generate _des-output/planning-artifacts/03-requirements-and-kpi-catalog.md from your Phase 02 business question catalog and Phase 02 to Phase 03 handoff.

Frequently Asked Questions about des-requirements-and-kpis

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

FAQPage Schema
How do I turn business questions into measurable data engineering requirements and KPI definitions?

To turn business questions into measurable data engineering requirements, you transform approved questions into functional and non-functional requirements, candidate KPIs, and metric definitions with explicit acceptance criteria, traceability, and SLA freshness.

What is the best way to define SLA freshness and metric ownership for data engineering workflows?

Defining SLA freshness and metric ownership requires specifying explicit acceptance criteria and ownership decisions within your KPI catalog, stopping the process to request user decisions when formulas, grain, or SLAs cannot be safely inferred.

How do I create a requirements and KPI catalog with traceability for data products?

Create a requirements and KPI catalog by mapping approved business questions to candidate KPIs and non-functional requirements, ensuring traceability, tracking evidence status, and explicitly listing unresolved items to prevent downstream physical design.

When should I halt the data engineering requirements gathering process?

You should halt the requirements gathering process when formulas, grain, owners, SLAs, freshness, acceptance criteria, or conflicts cannot be safely inferred, applying HALT-safe decision handling to request explicit user decisions.

How do I validate if my KPI definitions are ready for the next data engineering phase?

Validate KPI readiness for the next data engineering phase by applying evidence mapping and a Done Gate to decide whether the phase is Pass, Pass with risks, Fail, or Blocked based on explicit, measurable requirement definitions.

Can I use this approach to prevent premature physical design in data engineering?

Yes, you can prevent premature physical design by producing requirement and KPI catalogs that focus on functional metrics, evidence status, and traceability, ensuring downstream phases design data products from evidence rather than assumptions.