dew-method 0.1.0

package/src/dew-skills/4-implementation/dew-e2e-validation/assets/e2e-validation-matrix-template.md

@@ -0,0 +1,17 @@
+# E2E Validation Matrix Template
+
+```markdown
+# E2E Validation Matrix
+
+| Stage | Story / Epic | Expected Evidence | Actual Evidence | Status | Finding |
+|---|---|---|---|---|---|
+| Source access | | source access log | | pass/fail/partial | |
+| Bronze ingestion | | run log, row count | | | |
+| Schema snapshot | | schema snapshot | | | |
+| Silver transformation | | transform output, validation | | | |
+| Gold model | | metric output | | | |
+| DQ | | DQ result | | | |
+| Serving | | dashboard/API/report evidence | | | |
+| Trust statement | | trust-limitations document | | | |
+| Observability | | logs/monitor evidence | | | |
+```

package/src/dew-skills/4-implementation/dew-e2e-validation/assets/e2e-validation-report-template.md

@@ -0,0 +1,129 @@
+# E2E Validation Report Template
+
+```markdown
+---
+title: "{Project Name} E2E Validation Report"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+stepsCompleted: []
+decisionGates:
+  GATE-25-e2e-validation:
+    status: pending
+evidence: []
+assumptions: []
+caveats: []
+---
+
+# E2E Validation Report: {Project Name}
+
+## 0. Document Purpose
+
+This report validates the implemented data product end-to-end.
+
+It checks the full path:
+
+Source → Raw/Bronze → Silver → Gold → DQ → Serving → Trust/Limitations → Operational Evidence
+
+## 1. Input Artifacts
+
+| Artifact | Path | Loaded? | Notes |
+|---|---|---|---|
+| Sprint Status | | Yes/No | |
+| Story Validation Reports | | Yes/No | |
+| Completion Notes | | Yes/No | |
+| Evidence Index | | Yes/No | |
+| DataOps Runbook | | Yes/No | |
+| Serving Spec | | Yes/No | |
+| DQ Rules | | Yes/No | |
+| Data Model Spec | | Yes/No | |
+
+## 2. E2E Validation Path
+
+| Stage | Expected Output | Evidence | Status |
+|---|---|---|---|
+| Source access | | | pass/fail/partial |
+| Bronze ingestion | | | pass/fail/partial |
+| Schema snapshot | | | pass/fail/partial |
+| Silver transformation | | | pass/fail/partial |
+| Gold model / KPI | | | pass/fail/partial |
+| DQ rules | | | pass/fail/partial |
+| Serving output | | | pass/fail/partial |
+| Trust/limitations | | | pass/fail/partial |
+| Observability/logs | | | pass/fail/partial |
+
+## 3. Story Completion Coverage
+
+| Story ID | Status | Validation Report | Completion Notes | Evidence |
+|---|---|---|---|---|
+| 1.1 | done | | | |
+
+## 4. E2E Test / Review Summary
+
+### Validation Method
+
+A. Run E2E command  
+B. Review existing story evidence  
+C. Manual walkthrough  
+D. Hybrid  
+
+Selected:
+
+### Command / Procedure
+
+```bash
+# command or manual procedure
+```
+
+### Result
+
+* pass
+* pass-with-caveats
+* fail
+* partial
+* not-run
+
+## 5. Data Output Validation
+
+| Output | Expected | Observed | Evidence | Status |
+| ------ | -------- | -------- | -------- | ------ |
+
+## 6. KPI / Metric Validation
+
+| KPI | Gold Field | Expected Grain | Observed Output | Status |
+| --- | ---------- | -------------- | --------------- | ------ |
+
+## 7. DQ Validation
+
+| DQ Rule | Expected Action | Evidence | Result |
+| ------- | --------------- | -------- | ------ |
+
+## 8. Serving Validation
+
+| Serving Asset | Expected | Observed | Evidence | Status |
+| ------------- | -------- | -------- | -------- | ------ |
+
+## 9. Operational Validation
+
+| Requirement | Expected | Evidence | Status |
+| ----------- | -------- | -------- | ------ |
+
+## 10. Findings
+
+| Severity                 | Finding | Impact | Required Action |
+| ------------------------ | ------- | ------ | --------------- |
+| Critical/High/Medium/Low |         |        |                 |
+
+## 11. E2E Validation Gate
+
+A. E2E pass
+B. E2E pass with caveats
+C. Return to implementation
+D. Block release
+
+User decision:
+
+## 12. Handoff to Final Evidence Review
+```

package/src/dew-skills/4-implementation/dew-e2e-validation/checklist.md

@@ -0,0 +1,18 @@
+# E2E Validation Checklist
+
+- [ ] Sprint status loaded.
+- [ ] Required implementation stories are done or caveated.
+- [ ] Story validation reports loaded.
+- [ ] Completion notes loaded.
+- [ ] Evidence index loaded.
+- [ ] E2E validation path defined.
+- [ ] Source access evidence reviewed.
+- [ ] Bronze evidence reviewed.
+- [ ] Silver evidence reviewed.
+- [ ] Gold/KPI evidence reviewed.
+- [ ] DQ evidence reviewed.
+- [ ] Serving evidence reviewed.
+- [ ] Trust/limitations evidence reviewed.
+- [ ] Operational evidence reviewed.
+- [ ] Findings classified.
+- [ ] E2E Validation Gate completed.

package/src/dew-skills/4-implementation/dew-e2e-validation/customize.toml

@@ -0,0 +1,46 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-e2e-validation.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/sprint-status.yaml",
+  "file:{project-root}/**/stories/**/*.md",
+  "file:{project-root}/**/story-validation/**/*.md",
+  "file:{project-root}/**/completion-notes/**/*.md",
+  "file:{project-root}/**/story-evidence/**/*.md",
+  "file:{project-root}/**/dataops-runbook.md",
+  "file:{project-root}/**/observability-plan.md",
+  "file:{project-root}/**/serving-data-product-spec.md",
+  "file:{project-root}/**/metric-serving-contract.md",
+  "file:{project-root}/**/trust-and-limitations-statement.md",
+  "file:{project-root}/**/data-quality-rules.md",
+  "file:{project-root}/**/dq-rule-catalog.md",
+  "file:{project-root}/**/data-model-spec.md",
+  "file:{project-root}/**/ingestion-design.md",
+  "file:{project-root}/**/transformation-design.md",
+  "file:{project-root}/**/storage-design.md",
+  "file:{project-root}/**/validation-evidence-index.md",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+e2e_validation_report_template = "assets/e2e-validation-report-template.md"
+e2e_path_rubric = "assets/e2e-path-rubric.md"
+e2e_failure_rubric = "assets/e2e-failure-rubric.md"
+e2e_validation_matrix_template = "assets/e2e-validation-matrix-template.md"
+checklist = "checklist.md"
+
+e2e_output_path = "{implementation_artifacts}/e2e-validation"
+run_folder_pattern = "e2e-validation-{project_name}-{date}"
+
+sprint_status_path = "{implementation_artifacts}/sprint/sprint-status.yaml"
+evidence_index_path = "{evidence_artifacts}/validation-evidence-index.md"
+decision_log_path = "{planning_artifacts}/.decision-log.md"
+learning_log_path = "{learning_artifacts}/.learning-log.md"

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-01-init.md

@@ -0,0 +1,56 @@
+# Step 01 — E2E Validation Initialization
+
+## Mandatory Rules
+
+- Do not run E2E validation before implementation stories exist.
+- Do not proceed if sprint-status.yaml is missing.
+- Read the complete step before acting.
+
+## Task
+
+Initialize E2E validation workflow.
+
+## Sequence
+
+1. Detect existing workflow.
+
+Look for:
+- `{workflow.e2e_output_path}/**/e2e-validation-report.md`
+- `{implementation_artifacts}/**/*e2e*.md`
+
+If unfinished workflow exists, offer to resume.
+
+2. Validate prerequisite:
+   - `sprint-status.yaml`
+   - story validation reports
+   - completion notes
+   - evidence index
+
+If missing:
+- missing sprint status → `HALT-17`
+- missing evidence → `HALT-18`
+
+3. Create workspace:
+
+`{workflow.e2e_output_path}/{workflow.run_folder_pattern}/`
+
+Create:
+- `e2e-validation-report.md`
+- `e2e-validation-matrix.md`
+
+Use templates.
+
+4. Initialize frontmatter:
+
+```yaml
+status: draft
+stepsCompleted:
+  - step-01-init
+decisionGates:
+  GATE-25-e2e-validation:
+    status: pending
+```
+
+5. Continue checkpoint:
+
+`[C] Continue to load implemented context`

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-02-load-implemented-context.md

@@ -0,0 +1,49 @@
+# Step 02 — Load Implemented Context
+
+## Mandatory Rules
+
+- Load implementation, evidence, serving, DQ, and DataOps context.
+- Do not treat design artifacts as implementation evidence.
+
+## Task
+
+Load completed implementation context.
+
+## Extract
+
+From sprint status:
+- stories done
+- stories blocked
+- stories still incomplete
+
+From story validation:
+- Done Gate result
+- caveats
+- evidence paths
+
+From completion notes:
+- what was built
+- evidence produced
+- learning captured
+
+From evidence index:
+- evidence IDs
+- evidence paths
+- validation status
+
+From serving/DQ/DataOps:
+- expected outputs
+- DQ rules
+- operational evidence requirements
+
+## Update
+
+Update:
+- e2e-validation-report.md
+- e2e-validation-matrix.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to build E2E validation path`

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-03-build-e2e-validation-path.md

@@ -0,0 +1,43 @@
+# Step 03 — Build E2E Validation Path
+
+## Mandatory Rules
+
+- E2E path must include all relevant lifecycle stages.
+- Do not call story-level validation E2E unless it covers full path.
+- Missing lifecycle stage must be flagged.
+
+## Required stages
+
+- source access
+- Bronze ingestion
+- schema snapshot
+- Silver transformation
+- Gold model / KPI
+- DQ
+- serving
+- trust/limitations
+- observability/logging
+
+## Required table
+
+| Stage | Expected Evidence | Actual Evidence | Status |
+|---|---|---|---|
+
+## Validation method options
+
+A. Run E2E command  
+B. Review existing story evidence  
+C. Manual walkthrough  
+D. Hybrid  
+
+Recommend one.
+
+## Update
+
+Update e2e report.
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to run or review E2E validation`

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-04-run-or-review-e2e-validation.md

@@ -0,0 +1,53 @@
+# Step 04 — Run or Review E2E Validation
+
+## Mandatory Rules
+
+- Do not fabricate E2E results.
+- If command cannot be run, document manual review path.
+- If required evidence is missing, trigger HALT-18.
+
+## Task
+
+Execute or review E2E validation.
+
+## If command exists
+
+Run or instruct:
+
+```bash
+# project-specific E2E validation command
+```
+
+Record:
+
+* command
+* timestamp
+* result
+* output path
+* failure logs
+
+## If manual/hybrid
+
+Review:
+
+* source access evidence
+* ingestion evidence
+* transformation evidence
+* DQ evidence
+* serving evidence
+* operational evidence
+
+## Record findings
+
+Classify:
+
+* Critical
+* High
+* Medium
+* Low
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to E2E validation gate`

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-05-e2e-validation-gate.md

@@ -0,0 +1,51 @@
+# Step 05 — E2E Validation Gate
+
+## Mandatory Rules
+
+- Stop at this gate.
+- User must approve E2E validation result.
+- Critical finding blocks release.
+- Missing E2E evidence blocks release.
+
+## Decision options
+
+A. E2E pass  
+B. E2E pass with caveats  
+C. Return to implementation  
+D. Block release  
+
+## Required summary
+
+| Area | Status | Finding | Release Impact |
+|---|---|---|---|
+
+## Recommendation
+
+Recommend one option.
+
+## User decision
+
+Ask user to choose A/B/C/D.
+
+Do not continue until user chooses.
+
+## Record
+
+Update:
+- e2e-validation-report.md
+- .decision-log.md
+- .learning-log.md if enabled
+
+Update frontmatter:
+
+```yaml
+decisionGates:
+  GATE-25-e2e-validation:
+    status: approved / approved-with-caveats / blocked
+```
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to finalize E2E validation`

package/src/dew-skills/4-implementation/dew-e2e-validation/steps/step-06-finalize.md

@@ -0,0 +1,35 @@
+# Step 06 — Finalize E2E Validation
+
+## Mandatory Rules
+
+- Do not finalize as passed if E2E gate is blocked.
+- Run checklist.
+- Preserve caveats.
+
+## Required outputs
+
+- e2e-validation-report.md
+- e2e-validation-matrix.md
+- decision log entry
+- learning log entry if enabled
+
+## Final status
+
+Set:
+
+```yaml
+status: final
+stepsCompleted:
+  - step-01-init
+  - step-02-load-implemented-context
+  - step-03-build-e2e-validation-path
+  - step-04-run-or-review-e2e-validation
+  - step-05-e2e-validation-gate
+  - step-06-finalize
+```
+
+## Next workflow
+
+Recommend:
+
+`dew-final-evidence-review`

package/src/dew-skills/4-implementation/dew-example-project/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: dew-example-project
+description: Create a quickstart example project walkthrough showing how to use DEW from brief to release.
+---
+
+# DEW Example Project
+
+**Goal:** Create a quickstart example project walkthrough.
+
+**Your Role:** You are a demo and onboarding facilitator.
+
+You show how DEW is used end-to-end without overwhelming the user.
+
+## Mandatory Rules
+
+- Example project is optional.
+- Do not make the example too large.
+- Do not pretend example artifacts are full production artifacts.
+- Example must show the minimum useful path.
+- Example must include gates, HALTs, evidence, and story flow.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.example_project_walkthrough_template}`
+   - `{workflow.quickstart_scenario_template}`
+   - `{workflow.example_artifact_map_template}`
+   - `{workflow.example_quality_rubric}`
+   - `{workflow.demo_flow_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+Read fully and follow:
+
+`steps/step-01-init.md`

package/src/dew-skills/4-implementation/dew-example-project/assets/demo-flow-rubric.md

@@ -0,0 +1,26 @@
+# Demo Flow Rubric
+
+## Minimum demo
+
+- project brief
+- one KPI
+- one source
+- one validation
+- one architecture
+- one story
+- one evidence output
+
+## Strong demo
+
+- includes gate decision
+- includes caveat
+- includes DQ
+- includes release readiness
+- includes learning capture
+
+## Too large
+
+- multiple sources
+- many KPIs
+- production governance
+- complex deployment

package/src/dew-skills/4-implementation/dew-example-project/assets/example-artifact-map-template.md

@@ -0,0 +1,14 @@
+# Example Artifact Map Template
+
+```markdown
+# Example Artifact Map
+
+| DEW Step | Artifact | Example Content | Full Project Equivalent |
+|---|---|---|---|
+| Project Brief | project-brief.md | short scope | full brief |
+| KPI Feasibility | kpi-feasibility-report.md | one KPI | full KPI matrix |
+| Source Validation | source-validation-report.md | one source | source portfolio |
+| Requirement Gate | requirement-gate-report.md | one approval | full gate |
+| Architecture | data-architecture.md | simple architecture | full architecture |
+| Story | story.md | one story | full backlog |
+```

package/src/dew-skills/4-implementation/dew-example-project/assets/example-project-walkthrough-template.md

@@ -0,0 +1,61 @@
+# Example Project Walkthrough Template
+
+```markdown
+---
+title: "DEW Example Project Walkthrough"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+stepsCompleted: []
+decisionGates:
+  GATE-34-example-quality:
+    status: pending
+---
+
+# DEW Example Project Walkthrough
+
+## 0. Purpose
+
+This walkthrough demonstrates how to use DEW on a small example project.
+
+## 1. Scenario
+
+## 2. Project Goal
+
+## 3. User / Consumer
+
+## 4. KPI
+
+## 5. Source
+
+## 6. Minimal Workflow
+
+| Step | Skill | Output | Why |
+|---|---|---|---|
+| 1 | dew-project-brief | project brief | define scope |
+| 2 | dew-kpi-feasibility | KPI feasibility | avoid fake KPI |
+| 3 | dew-source-validation | source validation | prove source |
+| 4 | dew-requirement-gate | requirement gate | approve before architecture |
+| 5 | dew-data-architecture | architecture | design lifecycle |
+| 6 | dew-storage-design | storage design | define layers |
+| 7 | dew-ingestion-design | ingestion design | define ingestion |
+| 8 | dew-transformation-design | transformation design | define logic |
+| 9 | dew-data-quality-design | DQ rules | define validation |
+| 10 | dew-create-data-story | story | create implementation unit |
+| 11 | dew-dev-story | implementation | build |
+| 12 | dew-e2e-validation | validation | validate product |
+
+## 7. Example Artifacts
+
+See:
+
+`example-artifact-map.md`
+
+## 8. Demo Script
+
+## 9. Expected Learning
+
+## 10. Caveats
+```

package/src/dew-skills/4-implementation/dew-example-project/assets/example-quality-rubric.md

@@ -0,0 +1,19 @@
+# Example Quality Rubric
+
+## Good example
+
+- small
+- concrete
+- end-to-end
+- shows evidence
+- shows at least one gate
+- shows one HALT or caveat
+- does not pretend to be production
+
+## Bad example
+
+- too large
+- skips validation
+- skips evidence
+- only shows happy path
+- hides limitations

package/src/dew-skills/4-implementation/dew-example-project/assets/quickstart-scenario-template.md

@@ -0,0 +1,25 @@
+# Quickstart Scenario Template
+
+```markdown
+# Quickstart Scenario
+
+## Scenario Name
+
+## Business Problem
+
+## Consumer
+
+## Decision Supported
+
+## KPI
+
+## Candidate Source
+
+## Trust Expectation
+
+## Minimal Output
+
+## Why This Is a Good Demo
+
+## What This Demo Does Not Cover
+```