dew-method 0.1.0

package/src/dew-skills/4-implementation/dew-source-sampler/customize.toml

@@ -0,0 +1,80 @@
+---
+name: dew-source-sampler
+description: Extract or document source samples and schema snapshots as evidence for source validation.
+---
+
+# DEW Source Sampler
+
+**Goal:** Produce source sample and schema snapshot evidence.
+
+**Your Role:** You are a data sampling and schema inspection engineer.
+
+## Mandatory Rules
+
+- Do not invent sample data.
+- Do not invent schema.
+- Do not claim fields exist without sample/schema evidence.
+- Do not modify source data.
+- If sample cannot be captured, document why and trigger HALT-18 if needed.
+
+## On Activation
+
+1. Resolve customization.
+2. Execute `{workflow.activation_steps_prepend}`.
+3. Load persistent facts.
+4. Load config if present.
+5. Load:
+   - `{workflow.sample_notes_template}`
+   - `{workflow.schema_notes_template}`
+6. Greet user in configured language.
+
+## Execution
+
+### Step 1 — Load source context
+
+Load:
+- source validation report
+- access check log
+- source inventory
+- KPI-source matrix
+
+### Step 2 — Select source
+
+If multiple sources need samples, ask which source to sample first.
+
+### Step 3 — Capture or document sample
+
+Create:
+
+`{workflow.sample_output_path}/{source_id}-sample-notes.md`
+
+Record:
+- sample location
+- row count
+- column count
+- time coverage
+- entity/geography coverage
+- caveats
+
+### Step 4 — Capture schema snapshot
+
+Create:
+
+`{workflow.schema_output_path}/{source_id}-schema-snapshot.md`
+
+Record:
+- field names
+- data types if available
+- example values
+- required KPI field mapping
+- schema drift risk
+
+### Step 5 — Update evidence index
+
+Update validation evidence index.
+
+### Step 6 — Recommend next
+
+Recommend:
+
+`dew-source-contract-test`

package/src/dew-skills/4-implementation/dew-sprint-planning/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: dew-sprint-planning
+description: Create sprint-status.yaml and plan implementation order for DEW epics and stories.
+---
+
+# DEW Sprint Planning
+
+**Goal:** Create sprint-status.yaml and plan story implementation order.
+
+**Your Role:** You are a delivery planning facilitator.
+
+You convert epics/story map into a trackable implementation plan.
+
+## Mandatory Rules
+
+- Do not create sprint status before epics/story-map exist.
+- Do not mark stories ready-for-dev here unless they have been created by `dew-create-data-story`.
+- Preserve existing story statuses if updating.
+- Do not overwrite completed/review/done statuses.
+- If story dependencies are unclear, trigger `HALT-17`.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.sprint_status_template}`
+   - `{workflow.sprint_plan_template}`
+   - `{workflow.story_status_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+### Step 1 — Load epics and story map
+
+Look for:
+- `epics.md`
+- `story-map.md`
+
+If missing, ask user to run `dew-create-epics-and-stories`.
+
+### Step 2 — Create or update sprint status
+
+Create:
+
+`{workflow.sprint_output_path}/sprint-status.yaml`
+
+Preserve existing status if file exists.
+
+### Step 3 — Create sprint plan
+
+Create:
+
+`{workflow.sprint_output_path}/sprint-plan.md`
+
+### Step 4 — Recommend first story
+
+Pick first backlog story whose dependencies are satisfied.
+
+Usually:
+- 1.1 Foundation setup
+
+### Step 5 — Finalize
+
+Recommend:
+
+`dew-create-data-story`

package/src/dew-skills/4-implementation/dew-sprint-planning/assets/sprint-plan-template.md

@@ -0,0 +1,21 @@
+# Sprint Plan
+
+## Purpose
+
+Track implementation order for DEW stories.
+
+## Current Sprint Goal
+
+## Selected Stories
+
+| Story ID | Title | Epic | Status | Depends On | Reason Selected |
+|---|---|---|---|---|---|
+
+## Not Selected
+
+| Story ID | Title | Reason |
+|---|---|---|
+
+## Risks
+
+## Next Recommended Story

package/src/dew-skills/4-implementation/dew-sprint-planning/assets/sprint-status-template.yaml

@@ -0,0 +1,61 @@
+# DEW Sprint Status
+#
+# Status values:
+# Epic:
+#   backlog | in-progress | done
+# Story:
+#   backlog | ready-for-dev | in-progress | review | done | blocked
+
+project: "{project_name}"
+created: "{YYYY-MM-DD}"
+updated: "{YYYY-MM-DD}"
+workflow: dew
+
+epics:
+  EPIC-01:
+    title: "Foundation and Project Setup"
+    status: backlog
+    stories:
+      "1.1":
+        title: "Initialize project structure"
+        status: backlog
+
+  EPIC-02:
+    title: "Source Access and Bronze Ingestion"
+    status: backlog
+    stories: {}
+
+  EPIC-03:
+    title: "Source Contract and DQ Prechecks"
+    status: backlog
+    stories: {}
+
+  EPIC-04:
+    title: "Silver Transformation"
+    status: backlog
+    stories: {}
+
+  EPIC-05:
+    title: "Gold Modeling and KPI Computation"
+    status: backlog
+    stories: {}
+
+  EPIC-06:
+    title: "Data Quality Evidence"
+    status: backlog
+    stories: {}
+
+  EPIC-07:
+    title: "Serving Data Product"
+    status: backlog
+    stories: {}
+
+  EPIC-08:
+    title: "Governance Documentation"
+    status: backlog
+    stories: {}
+
+  EPIC-09:
+    title: "DataOps and Observability"
+    status: backlog
+    stories: {}

package/src/dew-skills/4-implementation/dew-sprint-planning/assets/story-status-rubric.md

@@ -0,0 +1,31 @@
+# Story Status Rubric
+
+## backlog
+
+Story exists as candidate but does not yet have full story file.
+
+## ready-for-dev
+
+Story file exists and includes:
+- context
+- acceptance criteria
+- implementation tasks
+- evidence requirements
+- validation commands
+- DoD
+
+## in-progress
+
+Developer has started implementation.
+
+## review
+
+Implementation complete and awaiting review.
+
+## done
+
+Review passed, evidence exists, status updated.
+
+## blocked
+
+Story cannot proceed due to missing dependency, decision, or evidence.

package/src/dew-skills/4-implementation/dew-sprint-planning/checklist.md

@@ -0,0 +1,10 @@
+# Sprint Planning Checklist
+
+- [ ] epics.md loaded.
+- [ ] story-map.md loaded.
+- [ ] sprint-status.yaml created or updated.
+- [ ] Existing statuses preserved.
+- [ ] Story dependencies respected.
+- [ ] First story recommended.
+- [ ] No story marked ready-for-dev without story file.
+- [ ] Decision log updated if needed.

package/src/dew-skills/4-implementation/dew-sprint-planning/customize.toml

@@ -0,0 +1,29 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-sprint-planning.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/epics.md",
+  "file:{project-root}/**/story-map.md",
+  "file:{project-root}/**/sprint-status.yaml",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+sprint_status_template = "assets/sprint-status-template.yaml"
+sprint_plan_template = "assets/sprint-plan-template.md"
+story_status_rubric = "assets/story-status-rubric.md"
+checklist = "checklist.md"
+
+sprint_output_path = "{implementation_artifacts}/sprint"
+stories_output_path = "{implementation_artifacts}/stories"
+
+decision_log_path = "{planning_artifacts}/.decision-log.md"
+learning_log_path = "{learning_artifacts}/.learning-log.md"

package/src/dew-skills/4-implementation/dew-story-completion/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: dew-story-completion
+description: Finalize story completion notes, learning capture, file list, evidence index, and sprint status after validation passes.
+---
+
+# DEW Story Completion
+
+**Goal:** Close a validated story cleanly and capture learning.
+
+**Your Role:** You are a completion and learning capture facilitator.
+
+## Mandatory Rules
+
+- Do not complete story unless validation report marks story done or done-with-caveats.
+- Do not skip learning capture.
+- Do not skip evidence index update.
+- Do not overwrite sprint statuses incorrectly.
+- If learning capture is missing, trigger `HALT-19`.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.completion_notes_template}`
+   - `{workflow.learning_capture_template}`
+   - `{workflow.sprint_status_update_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+### Step 1 — Load validated story
+
+Load:
+- story file
+- validation report
+- code review report
+- dev notes
+- evidence manifest
+- sprint-status.yaml
+
+### Step 2 — Verify completion status
+
+Proceed only if validation decision is:
+- done
+- done-with-caveats
+
+### Step 3 — Create completion notes
+
+Create:
+
+`{workflow.completion_output_path}/{story_id}-completion-notes.md`
+
+### Step 4 — Capture learning
+
+Update:
+- `.learning-log.md`
+- story completion notes
+
+### Step 5 — Update sprint status
+
+Ensure:
+- story status = done
+- epic status updated if all stories done
+
+### Step 6 — Finalize
+
+Recommend next backlog story or sprint review.

package/src/dew-skills/4-implementation/dew-story-completion/assets/completion-notes-template.md

@@ -0,0 +1,43 @@
+# Completion Notes Template
+
+```markdown
+---
+title: "Completion Notes — {Story ID}"
+status: final
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+storyId: "{Story ID}"
+---
+
+# Completion Notes: {Story ID} — {Story Title}
+
+## Final Status
+
+Done / Done with caveats
+
+## Summary
+
+## What Was Built
+
+## Evidence Produced
+
+| Evidence | Path | Status |
+|---|---|---|
+
+## Files Created / Modified
+
+| Path | Purpose |
+|---|---|
+
+## Validation Result
+
+## Caveats Remaining
+
+## Learning Captured
+
+## Follow-up Stories
+
+## Sprint Status Update
+```

package/src/dew-skills/4-implementation/dew-story-completion/assets/learning-capture-template.md

@@ -0,0 +1,30 @@
+# Learning Capture Template
+
+```markdown
+## Learning Entry — {Story ID}
+
+Date:
+
+Story:
+
+What was implemented:
+
+What was learned:
+
+FDE concept practiced:
+- source systems
+- storage
+- ingestion
+- transformation
+- serving
+- security/governance
+- DataOps
+- data management
+- software engineering
+
+Mistake avoided:
+
+Reusable pattern:
+
+Open question:
+```

package/src/dew-skills/4-implementation/dew-story-completion/assets/sprint-status-update-rubric.md

@@ -0,0 +1,24 @@
+# Sprint Status Update Rubric
+
+## Story done update
+
+A story can be marked done only when:
+- story validation report says done or done-with-caveats
+- evidence exists
+- completion notes created
+
+## Epic done update
+
+An epic can be marked done only when:
+- all required stories under epic are done
+- no required story is blocked
+- epic-level evidence exists or caveat approved
+
+## Preserve status
+
+Do not downgrade:
+- done
+- review
+- in-progress
+
+unless user explicitly requests correction.

package/src/dew-skills/4-implementation/dew-story-completion/checklist.md

@@ -0,0 +1,11 @@
+# Story Completion Checklist
+
+- [ ] Validated story loaded.
+- [ ] Validation report says done or done-with-caveats.
+- [ ] Evidence manifest loaded.
+- [ ] Completion notes created.
+- [ ] Learning captured.
+- [ ] Evidence index updated.
+- [ ] Sprint status updated.
+- [ ] Epic status checked.
+- [ ] Next story recommended.

package/src/dew-skills/4-implementation/dew-story-completion/customize.toml

@@ -0,0 +1,32 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-story-completion.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/stories/**/*.md",
+  "file:{project-root}/**/story-validation/**/*.md",
+  "file:{project-root}/**/code-review/**/*.md",
+  "file:{project-root}/**/dev-notes/**/*.md",
+  "file:{project-root}/**/story-evidence/**/*.md",
+  "file:{project-root}/**/sprint-status.yaml",
+  "file:{project-root}/**/validation-evidence-index.md",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+completion_notes_template = "assets/completion-notes-template.md"
+learning_capture_template = "assets/learning-capture-template.md"
+sprint_status_update_rubric = "assets/sprint-status-update-rubric.md"
+checklist = "checklist.md"
+
+completion_output_path = "{implementation_artifacts}/completion-notes"
+learning_log_path = "{learning_artifacts}/.learning-log.md"
+sprint_status_path = "{implementation_artifacts}/sprint/sprint-status.yaml"
+evidence_index_path = "{evidence_artifacts}/validation-evidence-index.md"

package/src/dew-skills/4-implementation/dew-story-validation/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: dew-story-validation
+description: Validate acceptance criteria, evidence, DQ, operational requirements, and decide whether story can move to done.
+---
+
+# DEW Story Validation
+
+**Goal:** Validate whether a reviewed story can become done.
+
+**Your Role:** You are a story validation gatekeeper.
+
+You verify story completion against ACs, evidence, DQ, operational requirements, review findings, and DoD.
+
+## Mandatory Rules
+
+- Do not validate story unless code review approved or approved with caveats.
+- Do not mark done if evidence is missing.
+- Do not mark done if critical/high review findings remain unresolved.
+- Do not mark done if DQ/operational requirements are missing.
+- User must approve Done Gate.
+- If evidence is missing, trigger `HALT-18`.
+- If implementation not ready, trigger `HALT-17`.
+
+## Workflow Architecture
+
+This workflow uses step-file architecture.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.validation_report_template}`
+   - `{workflow.validation_evidence_rubric}`
+   - `{workflow.status_transition_rubric}`
+   - `{workflow.done_gate_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+Read fully and follow:
+
+`steps/step-01-load-review-story-evidence.md`

package/src/dew-skills/4-implementation/dew-story-validation/assets/done-gate-rubric.md

@@ -0,0 +1,37 @@
+# Done Gate Rubric
+
+## Done
+
+Use when:
+- ACs pass
+- evidence valid
+- review approved
+- no critical/high findings remain
+- DQ/operational requirements satisfied
+- story file updated
+- sprint status can update to done
+
+## Done with caveats
+
+Use when:
+- ACs pass
+- evidence exists
+- medium/low caveats remain
+- user accepts caveats
+- downstream impact documented
+
+## Return to dev
+
+Use when:
+- implementation incomplete
+- evidence invalid
+- AC partially fails
+- fix is feasible
+
+## Block
+
+Use when:
+- critical blocker remains
+- design conflict exists
+- evidence cannot be produced
+- user decision required

package/src/dew-skills/4-implementation/dew-story-validation/assets/story-status-transition-rubric.md

@@ -0,0 +1,33 @@
+# Story Status Transition Rubric
+
+## ready-for-dev → in-progress
+
+Allowed by:
+- dew-dev-story
+
+## in-progress → review
+
+Allowed when:
+- implementation complete
+- evidence produced or blocker documented
+
+## review → done
+
+Allowed only after:
+- code review approved
+- story validation passed
+- Done Gate approved
+
+## review → in-progress
+
+Allowed when:
+- review requests changes
+- validation fails
+
+## any → blocked
+
+Allowed when:
+- dependency missing
+- evidence impossible
+- design conflict exists
+- user decision required

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

@@ -0,0 +1,67 @@
+# Story Validation Report Template
+
+```markdown
+---
+title: "Story Validation — {Story ID}"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+storyId: "{Story ID}"
+---
+
+# Story Validation: {Story ID} — {Story Title}
+
+## 1. Validation Summary
+
+Recommended decision:
+
+- done
+- done-with-caveats
+- return-to-dev
+- blocked
+
+## 2. Inputs Reviewed
+
+| Input | Path | Status |
+|---|---|---|
+| Story | | |
+| Dev Notes | | |
+| Code Review | | |
+| Evidence Manifest | | |
+| Sprint Status | | |
+
+## 3. Acceptance Criteria Validation
+
+| AC | Status | Evidence | Notes |
+|---|---|---|---|
+
+## 4. Evidence Validation
+
+| Evidence | Required? | Present? | Valid? | Notes |
+|---|---|---|---|---|
+
+## 5. DQ / Operational Validation
+
+| Requirement | Status | Evidence | Notes |
+|---|---|---|---|
+
+## 6. Review Finding Resolution
+
+| Finding | Severity | Resolved? | Notes |
+|---|---|---|---|
+
+## 7. Done Gate
+
+A. Mark done  
+B. Mark done with caveats  
+C. Return to dev  
+D. Block  
+
+User decision:
+
+## 8. Sprint Status Update
+
+## 9. Completion Handoff
+```