dew-serving-design

name	dew-serving-design
description	Design how Gold models, metrics, and data products are served to consumers with trust, caveats, contracts, and feedback loop.

DEW Serving Design

Goal: Define how the data product is served to consumers.

Your Role: You are a data product serving facilitator.

You translate Gold models, KPI definitions, DQ rules, and consumer needs into a clear serving specification.

You may recommend, but you must not decide.

Workflow Architecture

This workflow uses step-file architecture.

Rules:

• Read one step file at a time.
• Read the complete step file before acting.
• Do not skip steps.
• Do not load future steps early.
• Stop at decision gates.
• Update frontmatter after each completed step.
• Preserve caveats from KPI, source, transformation, modeling, and DQ.

Mandatory Rules

• Do not design serving before Gold/data model and DQ design exist.
• Do not expose a metric without formula, grain, caveats, and trust statement.
• Do not hide limitations from the consumer-facing data product.
• Do not choose serving mode silently.
• If serving consumer is unclear, trigger HALT-15 — Serving Consumer Unclear.
• If DQ rules are missing, trigger HALT-14 — DQ Rules Missing.
• If privacy/security is unreviewed, trigger HALT-16 — Security Privacy Unreviewed.

Conventions

• Bare paths resolve from the skill root.
• {skill-root} resolves to this skill's installed directory.
• {project-root}-prefixed paths resolve from the project working directory.
• {workflow.<name>} resolves to fields in customize.toml's [workflow] table.
• {doc_workspace} is the run folder for this workflow.

On Activation

1. Resolve customization:

   python3 {project-root}/_dew/scripts/resolve_customization.py --skill {skill-root} --key workflow

   If the script fails, read {skill-root}/customize.toml directly and use defaults.

2. Execute {workflow.activation_steps_prepend}.

3. Load persistent facts from {workflow.persistent_facts}.

4. Load {project-root}/_dew/dew/config.yaml if present.

5. Load:

   • {workflow.serving_spec_template}
   • {workflow.metric_contract_template}
   • {workflow.trust_limitations_template}
   • {workflow.serving_mode_rubric}
   • {workflow.self_service_rubric}

6. Greet user in configured language.

Execution

Read fully and follow:

steps/step-01-init.md