dew-method 0.1.0

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

@@ -0,0 +1,50 @@
+---
+name: dew-release-readiness
+description: Decide whether the data product is ready to release with scope, caveats, risks, notes, and rollback guidance.
+---
+
+# DEW Release Readiness
+
+**Goal:** Decide whether the implemented data product is ready for release.
+
+**Your Role:** You are a release readiness facilitator.
+
+You combine E2E validation, final evidence review, story completion, trust statement, governance, and DataOps readiness into a release decision.
+
+You may recommend, but you must not decide.
+
+## Mandatory Rules
+
+- Do not approve release if E2E validation is blocked.
+- Do not approve release if critical evidence is missing.
+- Do not approve release if critical DQ failure exists.
+- Do not approve release if trust/limitations statement is missing for user-facing product.
+- Do not approve release if privacy/security review is missing.
+- Do not hide release caveats.
+- User must approve Release Readiness Gate.
+- If implementation is incomplete, trigger `HALT-17`.
+- If evidence is missing, trigger `HALT-18`.
+- If learning capture is missing, trigger `HALT-19`.
+
+## 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.release_readiness_report_template}`
+   - `{workflow.release_checklist_template}`
+   - `{workflow.release_notes_template}`
+   - `{workflow.release_decision_rubric}`
+   - `{workflow.release_risk_rubric}`
+5. Greet user in configured language.
+
+## Execution
+
+Read fully and follow:
+
+`steps/step-01-init.md`

package/src/dew-skills/4-implementation/dew-release-readiness/assets/release-checklist-template.md

@@ -0,0 +1,30 @@
+# Release Checklist Template
+
+```markdown
+# Release Checklist
+
+## Required
+
+- [ ] E2E validation passed or passed with caveats.
+- [ ] Final evidence review complete or complete with caveats.
+- [ ] No critical evidence gap remains.
+- [ ] No critical DQ failure remains.
+- [ ] Serving output exists if in scope.
+- [ ] Trust and limitations statement exists.
+- [ ] Governance/security review complete.
+- [ ] DataOps runbook exists.
+- [ ] Observability plan exists or caveated.
+- [ ] Sprint status reviewed.
+- [ ] Release scope defined.
+- [ ] Release caveats defined.
+- [ ] Release notes drafted.
+- [ ] Rollback/recovery notes defined.
+- [ ] User approved release decision.
+
+## Optional
+
+- [ ] Demo script exists.
+- [ ] Screenshot/export exists.
+- [ ] Version tag planned.
+- [ ] README updated.
+```

package/src/dew-skills/4-implementation/dew-release-readiness/assets/release-decision-rubric.md

@@ -0,0 +1,38 @@
+# Release Decision Rubric
+
+## A. Release
+
+Use when:
+- E2E validation passed
+- evidence complete
+- no critical/high blockers
+- trust/governance/DataOps are ready
+- user approves
+
+## B. Release with caveats
+
+Use when:
+- E2E passed with caveats
+- evidence gaps are medium/low
+- caveats are documented
+- user accepts limitations
+
+## C. Do not release; return to implementation
+
+Use when:
+- code/story output incomplete
+- evidence missing
+- DQ failure exists
+- serving output missing
+
+## D. Do not release; return to design
+
+Use when:
+- issue comes from wrong requirement/KPI/source/model/design
+- implementation cannot fix it safely
+
+## E. Archive as learning/demo only
+
+Use when:
+- project produced learning value
+- but is not trustworthy enough for data product release

package/src/dew-skills/4-implementation/dew-release-readiness/assets/release-notes-template.md

@@ -0,0 +1,37 @@
+# Release Notes Template
+
+```markdown
+# Release Notes — {Project Name} {Version}
+
+## Release Type
+
+- learning/demo
+- internal MVP
+- internal decision-support
+- trusted shared
+- production
+
+## What Is Included
+
+## What Is Not Included
+
+## Data Sources
+
+## Metrics / KPIs
+
+## Serving Assets
+
+## Known Limitations
+
+## Data Freshness
+
+## Data Quality Notes
+
+## Usage Guidance
+
+## Evidence Summary
+
+## Operational Notes
+
+## Next Steps
+```

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

@@ -0,0 +1,113 @@
+# Release Readiness Report Template
+
+```markdown
+---
+title: "{Project Name} Release Readiness Report"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+stepsCompleted: []
+decisionGates:
+  GATE-27-release-readiness:
+    status: pending
+evidence: []
+assumptions: []
+caveats: []
+releaseDecision:
+  status: pending
+---
+
+# Release Readiness Report: {Project Name}
+
+## 0. Document Purpose
+
+This report decides whether the data product is ready for release.
+
+## 1. Release Candidate Summary
+
+### Product Name
+
+### Release Version
+
+### Release Type
+
+A. Learning / demo release  
+B. Internal MVP release  
+C. Internal decision-support release  
+D. Trusted shared release  
+E. Production release  
+
+Selected:
+
+## 2. Input Readiness
+
+| Input | Status | Notes |
+|---|---|---|
+| E2E Validation | pass/pass-with-caveats/fail/missing | |
+| Final Evidence Review | complete/caveated/incomplete | |
+| Sprint Status | done/partial/blocked | |
+| DQ Status | pass/caveated/fail | |
+| Serving Status | ready/caveated/missing | |
+| Trust Statement | ready/caveated/missing | |
+| Governance/Security | ready/caveated/missing | |
+| DataOps Runbook | ready/caveated/missing | |
+| Learning Capture | complete/incomplete | |
+
+## 3. Release Scope
+
+### Included
+
+### Excluded
+
+### Deferred
+
+## 4. Release Caveats
+
+| Caveat ID | Area | Description | User-Facing? | Release Impact |
+|---|---|---|---|---|
+
+## 5. Release Risks
+
+| Risk ID | Severity | Risk | Mitigation | Release Impact |
+|---|---|---|---|---|
+
+## 6. Rollback / Recovery
+
+### Rollback Trigger
+
+### Recovery Path
+
+### Backfill / Replay Notes
+
+### Communication Notes
+
+## 7. Release Checklist
+
+See:
+
+`release-checklist.md`
+
+## 8. Release Notes
+
+See:
+
+`release-notes.md`
+
+## 9. Release Readiness Gate
+
+A. Release  
+B. Release with caveats  
+C. Do not release; return to implementation  
+D. Do not release; return to design  
+E. Archive as learning/demo only  
+
+User decision:
+
+## 10. Handoff to Documentation / Learning / Pattern Extraction
+
+Next:
+
+`dew-project-documentation`
+```

package/src/dew-skills/4-implementation/dew-release-readiness/assets/release-risk-rubric.md

@@ -0,0 +1,38 @@
+# Release Risk Rubric
+
+## Critical
+
+Blocks release.
+
+Examples:
+- misleading KPI
+- missing trust limitations
+- privacy/security unresolved
+- no E2E validation
+- critical DQ failure
+
+## High
+
+Usually blocks release unless explicitly accepted.
+
+Examples:
+- incomplete evidence for primary KPI
+- freshness unverified
+- source reliability weak
+
+## Medium
+
+Release with caveat possible.
+
+Examples:
+- secondary metric incomplete
+- documentation partial
+- monitoring minimal
+
+## Low
+
+Release allowed.
+
+Examples:
+- cosmetic issue
+- minor README improvement

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

@@ -0,0 +1,18 @@
+# Release Readiness Checklist
+
+- [ ] E2E validation report loaded.
+- [ ] Final evidence review loaded.
+- [ ] Sprint status loaded.
+- [ ] Serving spec loaded.
+- [ ] Trust and limitations statement loaded.
+- [ ] Governance/security review loaded.
+- [ ] DataOps runbook loaded.
+- [ ] Release scope defined.
+- [ ] Release risks classified.
+- [ ] Release caveats listed.
+- [ ] Release checklist completed.
+- [ ] Release notes created.
+- [ ] Rollback/recovery notes defined.
+- [ ] Release Readiness Gate completed.
+- [ ] Decision log updated.
+- [ ] Learning log updated if enabled.

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

@@ -0,0 +1,40 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-release-readiness.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/**/e2e-validation-report.md",
+  "file:{project-root}/**/final-evidence-review.md",
+  "file:{project-root}/**/evidence-coverage-matrix.md",
+  "file:{project-root}/**/sprint-status.yaml",
+  "file:{project-root}/**/operational-readiness-report.md",
+  "file:{project-root}/**/serving-data-product-spec.md",
+  "file:{project-root}/**/trust-and-limitations-statement.md",
+  "file:{project-root}/**/governance-security-review.md",
+  "file:{project-root}/**/dataops-runbook.md",
+  "file:{project-root}/**/observability-plan.md",
+  "file:{project-root}/**/validation-evidence-index.md",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+release_readiness_report_template = "assets/release-readiness-report-template.md"
+release_checklist_template = "assets/release-checklist-template.md"
+release_notes_template = "assets/release-notes-template.md"
+release_decision_rubric = "assets/release-decision-rubric.md"
+release_risk_rubric = "assets/release-risk-rubric.md"
+checklist = "checklist.md"
+
+release_output_path = "{implementation_artifacts}/release-readiness"
+run_folder_pattern = "release-readiness-{project_name}-{date}"
+
+decision_log_path = "{planning_artifacts}/.decision-log.md"
+learning_log_path = "{learning_artifacts}/.learning-log.md"
+evidence_index_path = "{evidence_artifacts}/validation-evidence-index.md"

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-01-init.md

@@ -0,0 +1,52 @@
+# Step 01 — Release Readiness Initialization
+
+## Mandatory Rules
+
+- Do not start release readiness before E2E and final evidence review exist.
+- Do not approve release in this step.
+
+## Task
+
+Initialize release readiness workflow.
+
+## Sequence
+
+1. Detect existing release readiness workflow.
+
+Look for:
+- `{workflow.release_output_path}/**/release-readiness-report.md`
+- `{implementation_artifacts}/**/*release*.md`
+
+2. Validate prerequisite:
+- `e2e-validation-report.md`
+- `final-evidence-review.md`
+
+If missing:
+- missing E2E → return to `dew-e2e-validation`
+- missing evidence review → return to `dew-final-evidence-review`
+
+3. Create workspace:
+
+`{workflow.release_output_path}/{workflow.run_folder_pattern}/`
+
+Create:
+- `release-readiness-report.md`
+- `release-checklist.md`
+- `release-notes.md`
+
+4. Initialize frontmatter:
+
+```yaml
+status: draft
+stepsCompleted:
+  - step-01-init
+decisionGates:
+  GATE-27-release-readiness:
+    status: pending
+releaseDecision:
+  status: pending
+```
+
+5. Continue checkpoint:
+
+`[C] Continue to load validation and evidence`

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-02-load-validation-and-evidence.md

@@ -0,0 +1,45 @@
+# Step 02 — Load Validation and Evidence
+
+## Mandatory Rules
+
+- Load validation and evidence before release scope decision.
+- Do not treat caveated pass as clean pass.
+
+## Task
+
+Load:
+- E2E validation report
+- final evidence review
+- sprint status
+- serving spec
+- trust limitations
+- governance/security
+- DataOps runbook
+- observability plan
+- evidence index
+- decision log
+- learning log
+
+## Extract
+
+- E2E decision
+- evidence gaps
+- story completion status
+- DQ status
+- serving status
+- trust/caveats
+- governance/privacy status
+- operational readiness
+- learning capture status
+
+## Update
+
+Update:
+- release-readiness-report.md
+- release-checklist.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to release scope review`

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-03-release-scope-review.md

@@ -0,0 +1,42 @@
+# Step 03 — Release Scope Review
+
+## Mandatory Rules
+
+- Release scope must be explicit.
+- Do not release out-of-scope or deferred features.
+- Do not hide excluded scope.
+
+## Task
+
+Define release candidate scope.
+
+## Release type options
+
+A. Learning / demo release  
+B. Internal MVP release  
+C. Internal decision-support release  
+D. Trusted shared release  
+E. Production release  
+
+Ask user to choose or confirm.
+
+## Scope sections
+
+Define:
+- included
+- excluded
+- deferred
+- known limitations
+- user-facing caveats
+
+## Update
+
+Update:
+- release-readiness-report.md
+- release-notes.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to release risk review`

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-04-release-risk-review.md

@@ -0,0 +1,48 @@
+# Step 04 — Release Risk Review
+
+## Mandatory Rules
+
+- Classify release risks honestly.
+- Critical risk blocks release.
+- High risk requires explicit user acceptance.
+
+## Task
+
+Review release risks.
+
+## Risk categories
+
+- data correctness
+- KPI correctness
+- source reliability
+- freshness
+- DQ
+- serving
+- privacy/security
+- operational readiness
+- documentation/trust
+
+## Required table
+
+| Risk ID | Severity | Risk | Mitigation | Release Impact |
+|---|---|---|---|---|
+
+## Rollback/recovery
+
+Define:
+- rollback trigger
+- recovery path
+- backfill/replay notes
+- communication notes
+
+## Update
+
+Update:
+- release-readiness-report.md
+- release-notes.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to release readiness gate`

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-05-release-readiness-gate.md

@@ -0,0 +1,65 @@
+# Step 05 — Release Readiness Gate
+
+## Mandatory Rules
+
+- Stop at this gate.
+- User must approve release decision.
+- Critical risk blocks release.
+- Critical evidence gap blocks release.
+- Missing trust/governance for user-facing release blocks release.
+
+## Decision options
+
+A. Release  
+B. Release with caveats  
+C. Do not release; return to implementation  
+D. Do not release; return to design  
+E. Archive as learning/demo only  
+
+## Required summary
+
+| Area | Status | Release Impact |
+|---|---|---|
+| E2E validation | | |
+| Evidence | | |
+| DQ | | |
+| Serving | | |
+| Trust/limitations | | |
+| Governance/security | | |
+| DataOps | | |
+| Learning capture | | |
+
+## Recommendation
+
+Recommend one option.
+
+## User decision
+
+Ask user to choose A/B/C/D/E.
+
+Do not continue until user chooses.
+
+## Record
+
+Update:
+- release-readiness-report.md
+- release-checklist.md
+- release-notes.md
+- .decision-log.md
+- .learning-log.md if enabled
+
+Update frontmatter:
+
+```yaml
+decisionGates:
+  GATE-27-release-readiness:
+    status: approved / approved-with-caveats / blocked / archived
+releaseDecision:
+  status: release / release-with-caveats / return-to-implementation / return-to-design / archive-demo
+```
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to finalize release readiness`

package/src/dew-skills/4-implementation/dew-release-readiness/steps/step-06-finalize.md

@@ -0,0 +1,36 @@
+# Step 06 — Finalize Release Readiness
+
+## Mandatory Rules
+
+- Do not finalize as release if gate is blocked.
+- Run checklist.
+- Preserve caveats.
+
+## Required outputs
+
+- release-readiness-report.md
+- release-checklist.md
+- release-notes.md
+- decision log entry
+- learning log entry if enabled
+
+## Final status
+
+Set:
+
+```yaml
+status: final
+stepsCompleted:
+  - step-01-init
+  - step-02-load-validation-and-evidence
+  - step-03-release-scope-review
+  - step-04-release-risk-review
+  - step-05-release-readiness-gate
+  - step-06-finalize
+```
+
+## Next workflow
+
+Recommend:
+
+`dew-project-documentation`