dew-method 0.1.0

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: dew-implementation-readiness-review
+description: Review whether generated stories have enough context, evidence criteria, dependencies, and DoD before development starts.
+---
+
+# DEW Implementation Readiness Review
+
+**Goal:** Review whether implementation stories are actually ready for development.
+
+**Your Role:** You are an implementation readiness reviewer.
+
+You review story quality before development begins.
+
+## Mandatory Rules
+
+- Do not approve story without evidence requirements.
+- Do not approve story with missing dependencies.
+- Do not approve story with vague acceptance criteria.
+- Do not approve story without validation approach.
+- Do not approve story without DoD.
+- If not ready, trigger `HALT-17 — Implementation Not Ready`.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.readiness_report_template}`
+   - `{workflow.blocker_rubric}`
+   - `{workflow.dod_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+### Step 1 — Load story
+
+Load:
+- story file
+- story context pack
+- sprint-status.yaml
+- epics.md
+- story-map.md
+
+### Step 2 — Review readiness
+
+Check:
+- context completeness
+- dependencies
+- acceptance criteria
+- implementation tasks
+- evidence requirements
+- validation approach
+- DQ requirements
+- operational requirements
+- caveats
+- DoD
+
+### Step 3 — Produce readiness report
+
+Create:
+
+`{workflow.review_output_path}/{story_id}-implementation-readiness-report.md`
+
+### Step 4 — Decision
+
+Recommend one:
+
+A. Ready for dev  
+B. Ready with caveats  
+C. Needs revision  
+D. Blocked  
+
+Ask user to approve.
+
+### Step 5 — Update status
+
+If approved:
+- story status remains/sets `ready-for-dev`
+- sprint-status remains/sets `ready-for-dev`
+
+If not:
+- story status `blocked` or `backlog`
+- sprint-status updated accordingly

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/assets/implementation-blocker-rubric.md

@@ -0,0 +1,35 @@
+# Implementation Blocker Rubric
+
+## Critical blocker
+
+Use when:
+- required design artifact missing
+- source/KPI/model dependency unresolved
+- no evidence requirement
+- no validation approach
+- no acceptance criteria
+- dependency story not done
+
+Status:
+- blocked
+
+## Major blocker
+
+Use when:
+- acceptance criteria are vague
+- DQ requirement missing for data-changing story
+- operational requirement missing for pipeline story
+- caveat not carried forward
+
+Status:
+- needs revision or blocked
+
+## Minor blocker
+
+Use when:
+- wording unclear
+- file list incomplete
+- documentation could be improved
+
+Status:
+- ready with caveats or needs revision

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/assets/implementation-readiness-report-template.md

@@ -0,0 +1,59 @@
+# Implementation Readiness Report Template
+
+```markdown
+---
+title: "Implementation Readiness Review — {Story ID}"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+storyId: "{Story ID}"
+---
+
+# Implementation Readiness Review: {Story ID}
+
+## 1. Story Reviewed
+
+Story path:
+
+Story status:
+
+## 2. Readiness Summary
+
+Recommended status:
+
+- ready-for-dev
+- ready-with-caveats
+- needs-revision
+- blocked
+
+## 3. Review Matrix
+
+| Area | Status | Finding | Required Action |
+|---|---|---|---|
+| Context | pass/warn/fail | | |
+| Dependencies | pass/warn/fail | | |
+| Acceptance Criteria | pass/warn/fail | | |
+| Evidence Requirements | pass/warn/fail | | |
+| Validation Approach | pass/warn/fail | | |
+| DQ Requirements | pass/warn/fail | | |
+| Operational Requirements | pass/warn/fail | | |
+| Caveats | pass/warn/fail | | |
+| DoD | pass/warn/fail | | |
+
+## 4. Blockers
+
+## 5. Caveats
+
+## 6. Recommendation
+
+A. Ready for dev  
+B. Ready with caveats  
+C. Needs revision  
+D. Blocked  
+
+## 7. User Decision
+
+## 8. Sprint Status Update
+```

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/assets/story-dod-rubric.md

@@ -0,0 +1,15 @@
+# Story Definition of Done Rubric
+
+A data engineering story is done only when:
+
+- implementation completed
+- tests or validation approach executed
+- required evidence produced
+- DQ results produced if relevant
+- run logs produced if relevant
+- output path exists
+- file list updated
+- completion notes written
+- caveats updated
+- story status updated to review
+- sprint-status.yaml updated

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/checklist.md

@@ -0,0 +1,16 @@
+# Implementation Readiness Review Checklist
+
+- [ ] Story file loaded.
+- [ ] Story context pack loaded.
+- [ ] Sprint status loaded.
+- [ ] Dependencies checked.
+- [ ] Acceptance criteria reviewed.
+- [ ] Evidence requirements reviewed.
+- [ ] Validation approach reviewed.
+- [ ] DQ requirements reviewed if relevant.
+- [ ] Operational requirements reviewed if relevant.
+- [ ] Caveats checked.
+- [ ] DoD checked.
+- [ ] Readiness report created.
+- [ ] User approved readiness status.
+- [ ] Sprint status updated.

package/src/dew-skills/4-implementation/dew-implementation-readiness-review/customize.toml

@@ -0,0 +1,31 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-implementation-readiness-review.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/stories/**/*.md",
+  "file:{project-root}/**/story-context/**/*.md",
+  "file:{project-root}/**/sprint-status.yaml",
+  "file:{project-root}/**/epics.md",
+  "file:{project-root}/**/story-map.md",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+readiness_report_template = "assets/implementation-readiness-report-template.md"
+blocker_rubric = "assets/implementation-blocker-rubric.md"
+dod_rubric = "assets/story-dod-rubric.md"
+checklist = "checklist.md"
+
+review_output_path = "{implementation_artifacts}/readiness-reviews"
+
+decision_log_path = "{planning_artifacts}/.decision-log.md"
+learning_log_path = "{learning_artifacts}/.learning-log.md"
+sprint_status_path = "{implementation_artifacts}/sprint/sprint-status.yaml"

package/src/dew-skills/4-implementation/dew-installation-guide/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: dew-installation-guide
+description: Create installation, usage, command reference, and troubleshooting documentation for the DEW skill module.
+---
+
+# DEW Installation Guide
+
+**Goal:** Create installation and usage documentation for DEW.
+
+**Your Role:** You are an onboarding documentation facilitator.
+
+You make the skill pack usable by another person.
+
+## Mandatory Rules
+
+- Do not create install docs without package scope.
+- Do not invent unsupported install commands.
+- Clearly separate verified install steps from assumed/manual steps.
+- Usage guide must show recommended workflow order.
+- Troubleshooting must include common failure modes.
+- If install path is unknown, mark caveat.
+
+## On Activation
+
+1. Resolve customization.
+2. Load persistent facts.
+3. Load config if present.
+4. Load:
+   - `{workflow.installation_guide_template}`
+   - `{workflow.usage_guide_template}`
+   - `{workflow.command_reference_template}`
+   - `{workflow.troubleshooting_template}`
+   - `{workflow.installation_quality_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+Read fully and follow:
+
+`steps/step-01-init.md`

package/src/dew-skills/4-implementation/dew-installation-guide/assets/command-reference-template.md

@@ -0,0 +1,54 @@
+# Command Reference Template
+
+```markdown
+# DEW Command Reference
+
+## Analysis
+
+| Command / Skill | Purpose |
+|---|---|
+| dew-project-brief | Create project brief |
+| dew-business-discovery | Clarify business decision |
+| dew-kpi-discovery | Discover KPI candidates |
+| dew-kpi-feasibility | Validate KPI feasibility |
+| dew-source-validation | Validate source evidence |
+
+## Planning / Solutioning
+
+| Command / Skill | Purpose |
+|---|---|
+| dew-requirement-gate | Approve requirements before architecture |
+| dew-data-architecture | Create architecture |
+| dew-storage-design | Design storage |
+| dew-ingestion-design | Design ingestion |
+| dew-transformation-design | Design transformation |
+| dew-data-model-design | Design model |
+| dew-data-quality-design | Design DQ |
+| dew-serving-design | Design serving |
+| dew-governance-security-design | Design governance/security |
+| dew-dataops-design | Design operations |
+
+## Implementation
+
+| Command / Skill | Purpose |
+|---|---|
+| dew-create-epics-and-stories | Create backlog |
+| dew-sprint-planning | Create sprint status |
+| dew-create-data-story | Create ready-for-dev story |
+| dew-dev-story | Implement story |
+| dew-code-review | Review story |
+| dew-story-validation | Validate story |
+| dew-story-completion | Complete story |
+
+## Release / Learning / Packaging
+
+| Command / Skill | Purpose |
+|---|---|
+| dew-e2e-validation | Validate E2E |
+| dew-release-readiness | Decide release |
+| dew-project-documentation | Create docs |
+| dew-learning-capture | Capture learning |
+| dew-pattern-extraction | Extract reusable patterns |
+| dew-skill-qa | QA skill pack |
+| dew-package-release | Package release |
+```

package/src/dew-skills/4-implementation/dew-installation-guide/assets/installation-guide-template.md

@@ -0,0 +1,69 @@
+# Installation Guide Template
+
+```markdown
+---
+title: "DEW Installation Guide"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+stepsCompleted: []
+decisionGates:
+  GATE-33-installation-docs:
+    status: pending
+---
+
+# DEW Installation Guide
+
+## 0. Purpose
+
+This guide explains how to install the DEW skill module.
+
+## 1. Prerequisites
+
+## 2. Repository Layout
+
+```text
+src/dew-skills/
+├── module.yaml
+├── module-help.csv
+├── 1-analysis/
+├── 2-plan-workflows/
+├── 3-solutioning/
+└── 4-implementation/
+```
+
+## 3. Installation Options
+
+### Option A — Copy module into agent skills directory
+
+### Option B — Use repo as skill source
+
+### Option C — Manual local usage
+
+## 4. Configuration
+
+Expected config:
+
+```text
+_dew/dew/config.yaml
+_dew/custom/
+planning_artifacts/
+implementation_artifacts/
+evidence_artifacts/
+learning_artifacts/
+```
+
+## 5. Verify Installation
+
+## 6. First Run
+
+Recommended first skill:
+
+`dew-project-brief`
+
+## 7. Upgrade Notes
+
+## 8. Known Caveats
+```

package/src/dew-skills/4-implementation/dew-installation-guide/assets/installation-quality-rubric.md

@@ -0,0 +1,19 @@
+# Installation Quality Rubric
+
+## Good install docs
+
+- list prerequisites
+- show repo/module layout
+- explain install options
+- explain config
+- show verification
+- show first run
+- explain troubleshooting
+
+## Weak install docs
+
+- assume install path
+- no verification
+- no usage flow
+- no troubleshooting
+- no artifact locations

package/src/dew-skills/4-implementation/dew-installation-guide/assets/troubleshooting-template.md

@@ -0,0 +1,64 @@
+# Troubleshooting Template
+
+```markdown
+# DEW Troubleshooting
+
+## Common Issue: Skill cannot find artifact
+
+### Symptom
+
+### Cause
+
+### Fix
+
+- Check artifact path.
+- Check config variables.
+- Check previous skill output.
+
+## Common Issue: HALT triggered
+
+### Symptom
+
+Skill stops with HALT.
+
+### Fix
+
+- Read HALT reason.
+- Resolve missing decision/evidence/artifact.
+- Re-run or continue from checkpoint.
+
+## Common Issue: Missing source evidence
+
+### Fix
+
+Run:
+- dew-source-access-check
+- dew-source-sampler
+- dew-source-contract-test
+
+## Common Issue: KPI not feasible
+
+### Fix
+
+Run:
+- dew-kpi-feasibility
+- dew-kpi-prototype
+- dew-kpi-validation-review
+
+## Common Issue: Story not ready-for-dev
+
+### Fix
+
+Run:
+- dew-create-data-story
+- dew-implementation-readiness-review
+
+## Common Issue: Release blocked
+
+### Fix
+
+Run:
+- dew-e2e-validation
+- dew-final-evidence-review
+- dew-release-readiness
+```

package/src/dew-skills/4-implementation/dew-installation-guide/assets/usage-guide-template.md

@@ -0,0 +1,66 @@
+# Usage Guide Template
+
+```markdown
+# DEW Usage Guide
+
+## Recommended Workflow
+
+```text
+01. dew-decision-gate / dew-halt-resolver / dew-evidence-check
+02. dew-project-brief
+03. dew-business-discovery
+04. dew-kpi-discovery
+05. dew-data-product-prd
+06. dew-kpi-feasibility
+07. dew-source-discovery
+08. dew-source-assessment
+09. dew-source-validation
+10. dew-requirement-gate
+11. dew-data-architecture
+12. dew-storage-design
+13. dew-ingestion-design
+14. dew-transformation-design
+15. dew-data-model-design
+16. dew-data-quality-design
+17. dew-serving-design
+18. dew-governance-security-design
+19. dew-dataops-design
+20. dew-create-epics-and-stories
+21. dew-sprint-planning
+22. dew-create-data-story
+23. dew-dev-story
+24. dew-code-review
+25. dew-story-validation
+26. dew-story-completion
+27. dew-e2e-validation
+28. dew-final-evidence-review
+29. dew-release-readiness
+30. dew-project-documentation
+31. dew-learning-capture
+32. dew-pattern-extraction
+33. dew-skill-qa
+34. dew-package-release
+```
+
+## Recommended Project Modes
+
+### Learning mode
+
+### Portfolio mode
+
+### Internal decision-support mode
+
+### Production-like mode
+
+## How to Use a Skill
+
+## How to Handle HALT
+
+## How to Handle Gates
+
+## How to Continue After a Step
+
+## Artifact Locations
+
+## Common Workflows
+```

package/src/dew-skills/4-implementation/dew-installation-guide/checklist.md

@@ -0,0 +1,13 @@
+# Installation Guide Checklist
+
+- [ ] Packaging report loaded.
+- [ ] Release notes loaded.
+- [ ] Module structure loaded.
+- [ ] Installation guide created.
+- [ ] Usage guide created.
+- [ ] Command reference created.
+- [ ] Troubleshooting created.
+- [ ] Artifact locations documented.
+- [ ] First-run workflow documented.
+- [ ] Install caveats documented.
+- [ ] Installation doc gate completed.

package/src/dew-skills/4-implementation/dew-installation-guide/customize.toml

@@ -0,0 +1,34 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-installation-guide.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/packaging-report.md",
+  "file:{project-root}/**/final-release-notes.md",
+  "file:{project-root}/**/release-package-checklist.md",
+  "file:{project-root}/src/dew-skills/module.yaml",
+  "file:{project-root}/src/dew-skills/module-help.csv",
+  "file:{project-root}/**/skill-qa-report.md",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+installation_guide_template = "assets/installation-guide-template.md"
+usage_guide_template = "assets/usage-guide-template.md"
+command_reference_template = "assets/command-reference-template.md"
+troubleshooting_template = "assets/troubleshooting-template.md"
+installation_quality_rubric = "assets/installation-quality-rubric.md"
+checklist = "checklist.md"
+
+install_docs_output_path = "{implementation_artifacts}/installation"
+run_folder_pattern = "installation-guide-{project_name}-{date}"
+
+decision_log_path = "{planning_artifacts}/.decision-log.md"
+learning_log_path = "{learning_artifacts}/.learning-log.md"

package/src/dew-skills/4-implementation/dew-installation-guide/steps/step-01-init.md

@@ -0,0 +1,39 @@
+# Step 01 — Installation Guide Initialization
+
+## Mandatory Rules
+
+- Do not create install guide before package release context exists.
+- Do not approve documentation in this step.
+
+## Task
+
+Initialize installation guide workflow.
+
+## Sequence
+
+1. Detect existing install docs.
+
+Look for:
+- `{workflow.install_docs_output_path}/**/installation-guide.md`
+- `{implementation_artifacts}/**/*install*.md`
+
+2. Validate prerequisite:
+- packaging-report.md
+- final-release-notes.md
+
+If missing:
+- return to `dew-package-release`
+
+3. Create workspace:
+
+`{workflow.install_docs_output_path}/{workflow.run_folder_pattern}/`
+
+Create:
+- `installation-guide.md`
+- `usage-guide.md`
+- `command-reference.md`
+- `troubleshooting.md`
+
+4. Continue checkpoint:
+
+`[C] Continue to load package context`

package/src/dew-skills/4-implementation/dew-installation-guide/steps/step-02-load-package-context.md

@@ -0,0 +1,34 @@
+# Step 02 — Load Package Context
+
+## Mandatory Rules
+
+- Installation docs must match package scope.
+- Do not invent unsupported installation methods.
+
+## Task
+
+Load:
+- packaging report
+- release notes
+- module.yaml
+- module-help.csv
+- skill QA report
+
+## Extract
+
+- package scope
+- version
+- included skills
+- caveats
+- module layout
+- install assumptions
+
+## Update
+
+Update install docs.
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to create installation guide`