dew-method 0.1.0

package/src/dew-skills/4-implementation/dew-skill-qa/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: dew-skill-qa
+description: Audit DEW skill pack structure, module catalog, cross-links, gates, HALTs, assets, steps, and checklist consistency before release.
+---
+
+# DEW Skill QA
+
+**Goal:** Audit the DEW skill pack before release.
+
+**Your Role:** You are a skill pack QA auditor.
+
+You verify that the module is structurally consistent, navigable, installable, and usable.
+
+## Mandatory Rules
+
+- Do not approve release if module.yaml is missing or inconsistent.
+- Do not approve release if module-help.csv does not list required skills.
+- Do not approve release if required skill folders are missing.
+- Do not approve release if SKILL.md references missing assets or steps.
+- Do not approve release if cross-skill `preceded-by` / `followed-by` links are broken.
+- Do not approve release if HALT/gate names are inconsistent.
+- Do not hide QA findings.
+- If QA fails, trigger `HALT-22 — Skill Pack QA Failed`.
+
+## Workflow Architecture
+
+This workflow uses step-file architecture.
+
+Rules:
+- Read one step file at a time.
+- Do not skip steps.
+- Stop at Final QA Gate.
+- Produce QA report and module catalog audit.
+- Classify findings by severity.
+
+## 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. Load persistent facts from `{workflow.persistent_facts}`.
+
+3. Load `{project-root}/_dew/dew/config.yaml` if present.
+
+4. Load:
+   - `{workflow.skill_qa_report_template}`
+   - `{workflow.module_catalog_audit_template}`
+   - `{workflow.skill_structure_rubric}`
+   - `{workflow.cross_link_validation_rubric}`
+   - `{workflow.final_qa_gate_rubric}`
+
+5. Greet user in configured language.
+
+## Execution
+
+Read fully and follow:
+
+`steps/step-01-init.md`

package/src/dew-skills/4-implementation/dew-skill-qa/assets/cross-link-validation-rubric.md

@@ -0,0 +1,26 @@
+# Cross-Link Validation Rubric
+
+## Valid link
+
+A `preceded-by` or `followed-by` value is valid when:
+- the referenced skill exists in module-help.csv
+- the referenced skill folder exists
+- the workflow order makes sense
+- the output of previous skill is input of next skill
+
+## Broken link
+
+A link is broken when:
+- skill name typo
+- referenced skill not listed
+- referenced folder missing
+- workflow loops unintentionally
+- output/input mismatch
+
+## Suspicious link
+
+A link is suspicious when:
+- optional skill blocks required skill
+- implementation skill depends on documentation skill too early
+- phase order is wrong
+- output artifact is not defined

package/src/dew-skills/4-implementation/dew-skill-qa/assets/final-qa-gate-rubric.md

@@ -0,0 +1,31 @@
+# Final QA Gate Rubric
+
+## QA passed
+
+Use when:
+- no critical/high findings
+- module catalog valid
+- required skill folders exist
+- cross-links valid
+- gates/HALTs consistent
+
+## QA passed with caveats
+
+Use when:
+- only medium/low findings remain
+- caveats documented
+- package can still be tested
+
+## Fix required before package
+
+Use when:
+- high findings exist
+- package may work but release would be risky
+
+## Block release
+
+Use when:
+- critical finding exists
+- module cannot be installed
+- required workflow chain is broken
+- missing required skill files

package/src/dew-skills/4-implementation/dew-skill-qa/assets/module-catalog-audit-template.md

@@ -0,0 +1,47 @@
+# Module Catalog Audit Template
+
+```markdown
+# Module Catalog Audit
+
+## module.yaml
+
+| Field | Present? | Value | Finding |
+|---|---|---|---|
+| code | | | |
+| name | | | |
+| description | | | |
+| version | | | |
+| agents | | | |
+| variables | | | |
+| directories | | | |
+
+## module-help.csv
+
+| Skill | Phase | Menu Code | Required | Preceded By | Followed By | Output | Finding |
+|---|---|---|---|---|---|---|---|
+
+## Missing Skills
+
+## Duplicate Menu Codes
+
+## Broken Preceded/Followed Links
+
+## Required Skill Chain
+
+Expected chain:
+
+1. Foundation
+2. Business/KPI/PRD
+3. KPI Feasibility
+4. Source Validation
+5. Requirement Gate
+6. Architecture
+7. Storage/Ingestion
+8. Transformation/Model/DQ
+9. Serving/Governance/DataOps
+10. Epics/Stories
+11. Dev/Review/Validation
+12. E2E/Release
+13. Documentation/Learning/Patterns
+14. Packaging/Install/QA
+```

package/src/dew-skills/4-implementation/dew-skill-qa/assets/skill-qa-report-template.md

@@ -0,0 +1,87 @@
+# Skill QA Report Template
+
+```markdown
+---
+title: "DEW Skill QA Report"
+status: draft
+created: {YYYY-MM-DD}
+updated: {YYYY-MM-DD}
+workflow: dew
+phase: "4-implementation"
+stepsCompleted: []
+decisionGates:
+  GATE-31-skill-qa:
+    status: pending
+findings: []
+---
+
+# DEW Skill QA Report
+
+## 0. Purpose
+
+This report audits the DEW skill pack before release.
+
+## 1. QA Scope
+
+| Area | Included? | Notes |
+|---|---|---|
+| module.yaml | Yes/No | |
+| module-help.csv | Yes/No | |
+| skill folders | Yes/No | |
+| SKILL.md files | Yes/No | |
+| customize.toml files | Yes/No | |
+| assets | Yes/No | |
+| steps | Yes/No | |
+| checklists | Yes/No | |
+| cross-skill links | Yes/No | |
+| HALT/gate consistency | Yes/No | |
+
+## 2. Summary
+
+Recommended decision:
+
+- pass
+- pass-with-caveats
+- request-fixes
+- block-release
+
+## 3. Module Structure Review
+
+## 4. Module Catalog Review
+
+See:
+
+`module-catalog-audit.md`
+
+## 5. Skill Structure Review
+
+| Skill | Folder Exists | SKILL.md | customize.toml | assets | steps | checklist | Status |
+|---|---|---|---|---|---|---|---|
+
+## 6. Cross-Link Review
+
+| Skill | preceded-by | followed-by | Valid? | Finding |
+|---|---|---|---|---|
+
+## 7. Gate / HALT Review
+
+| Gate / HALT | Used In | Defined? | Consistent? | Finding |
+|---|---|---|---|---|
+
+## 8. Findings
+
+| Severity | Area | Finding | Required Action |
+|---|---|---|---|
+| Critical/High/Medium/Low | | | |
+
+## 9. Final QA Gate
+
+A. QA passed  
+B. QA passed with caveats  
+C. Fix required before package  
+D. Block release  
+
+User decision:
+
+## 10. Handoff to Package Release
+```

package/src/dew-skills/4-implementation/dew-skill-qa/assets/skill-structure-rubric.md

@@ -0,0 +1,59 @@
+# Skill Structure Rubric
+
+## Required structure for simple skill
+
+A simple skill may have:
+
+- SKILL.md
+- customize.toml
+- checklist.md
+- assets/
+
+## Required structure for workflow skill
+
+A workflow skill must have:
+
+- SKILL.md
+- customize.toml
+- checklist.md
+- assets/
+- steps/
+
+## SKILL.md must include
+
+- name
+- description
+- goal
+- role
+- mandatory rules
+- activation logic
+- execution entrypoint
+
+## customize.toml must include
+
+- activation steps
+- persistent facts
+- template paths
+- checklist path
+- output path
+- decision/learning/evidence log paths when relevant
+
+## assets must include
+
+- templates referenced by SKILL.md or customize.toml
+- rubrics referenced by skill
+- no orphan critical template
+
+## steps must include
+
+- init step
+- context loading step
+- gate step if user decision required
+- finalize step
+
+## checklist must include
+
+- required inputs
+- required outputs
+- gate completion
+- failure conditions

package/src/dew-skills/4-implementation/dew-skill-qa/checklist.md

@@ -0,0 +1,15 @@
+# Skill QA Checklist
+
+- [ ] module.yaml loaded.
+- [ ] module-help.csv loaded.
+- [ ] Required skill list checked.
+- [ ] Skill folders checked.
+- [ ] SKILL.md files checked.
+- [ ] customize.toml files checked.
+- [ ] assets checked.
+- [ ] steps checked.
+- [ ] checklist.md files checked.
+- [ ] Cross-skill links checked.
+- [ ] Gate/HALT consistency checked.
+- [ ] Findings classified.
+- [ ] Final QA Gate completed.

package/src/dew-skills/4-implementation/dew-skill-qa/customize.toml

@@ -0,0 +1,34 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for dew-skill-qa.
+
+[workflow]
+
+activation_steps_prepend = []
+activation_steps_append = []
+
+persistent_facts = [
+  "file:{project-root}/src/dew-skills/module.yaml",
+  "file:{project-root}/src/dew-skills/module-help.csv",
+  "file:{project-root}/src/dew-skills/**/*.md",
+  "file:{project-root}/src/dew-skills/**/*.toml",
+  "file:{project-root}/src/dew-skills/**/*.yaml",
+  "file:{project-root}/src/dew-skills/**/*.csv",
+  "file:{project-root}/**/.decision-log.md",
+  "file:{project-root}/**/.learning-log.md",
+]
+
+on_complete = ""
+
+skill_qa_report_template = "assets/skill-qa-report-template.md"
+module_catalog_audit_template = "assets/module-catalog-audit-template.md"
+skill_structure_rubric = "assets/skill-structure-rubric.md"
+cross_link_validation_rubric = "assets/cross-link-validation-rubric.md"
+final_qa_gate_rubric = "assets/final-qa-gate-rubric.md"
+checklist = "checklist.md"
+
+qa_output_path = "{implementation_artifacts}/skill-qa"
+run_folder_pattern = "skill-qa-{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-skill-qa/steps/step-01-init.md

@@ -0,0 +1,38 @@
+# Step 01 — Skill QA Initialization
+
+## Mandatory Rules
+
+- Do not approve QA in this step.
+- Do not proceed if module root is missing.
+
+## Task
+
+Initialize skill QA.
+
+## Sequence
+
+1. Detect existing QA workflow.
+
+Look for:
+- `{workflow.qa_output_path}/**/skill-qa-report.md`
+- `{implementation_artifacts}/**/*qa*.md`
+
+2. Validate prerequisite:
+- `src/dew-skills/module.yaml`
+- `src/dew-skills/module-help.csv`
+
+If missing, trigger:
+
+`HALT-22 — Skill Pack QA Failed`
+
+3. Create workspace:
+
+`{workflow.qa_output_path}/{workflow.run_folder_pattern}/`
+
+Create:
+- `skill-qa-report.md`
+- `module-catalog-audit.md`
+
+4. Continue checkpoint:
+
+`[C] Continue to scan skill pack`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-02-scan-skill-pack.md

@@ -0,0 +1,39 @@
+# Step 02 — Scan Skill Pack
+
+## Mandatory Rules
+
+- Scan all skill folders.
+- Do not assume files exist.
+
+## Task
+
+Build inventory of skill pack.
+
+## Scan
+
+- module.yaml
+- module-help.csv
+- phase folders
+- skill folders
+- SKILL.md
+- customize.toml
+- assets
+- steps
+- checklist.md
+
+## Required inventory table
+
+| Skill | Phase | Folder | Files Present | Missing |
+|---|---|---|---|---|
+
+## Update
+
+Update:
+- skill-qa-report.md
+- module-catalog-audit.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to validate module catalog`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-03-validate-module-catalog.md

@@ -0,0 +1,39 @@
+# Step 03 — Validate Module Catalog
+
+## Mandatory Rules
+
+- module-help.csv must be consistent with folders.
+- Required skills must be listed.
+- Menu codes should not duplicate unintentionally.
+
+## Task
+
+Validate:
+- module.yaml fields
+- module-help.csv rows
+- required flag
+- phases
+- preceded-by
+- followed-by
+- output locations
+- skill folder existence
+
+## Findings
+
+Classify:
+- Critical
+- High
+- Medium
+- Low
+
+## Update
+
+Update:
+- module-catalog-audit.md
+- skill-qa-report.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to validate skill structure`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-04-validate-skill-structure.md

@@ -0,0 +1,34 @@
+# Step 04 — Validate Skill Structure
+
+## Mandatory Rules
+
+- Every required skill must have required files.
+- Workflow skills must have steps.
+- Referenced assets must exist.
+
+## Task
+
+For each skill, validate:
+
+- SKILL.md exists
+- customize.toml exists
+- checklist.md exists
+- assets exist
+- steps exist if workflow skill
+- paths referenced by customize.toml exist
+- execution entrypoint exists
+
+## Required table
+
+| Skill | Finding | Severity | Required Action |
+|---|---|---|---|
+
+## Update
+
+Update skill QA report.
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to cross-link and gate review`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-05-cross-link-and-gate-review.md

@@ -0,0 +1,37 @@
+# Step 05 — Cross-Link and Gate Review
+
+## Mandatory Rules
+
+- Cross-skill links must resolve.
+- Gates and HALTs must be consistent.
+- Release chain must not break.
+
+## Task
+
+Review:
+- preceded-by / followed-by chain
+- required skill chain
+- optional skill placement
+- gate names
+- HALT names
+- artifact handoffs
+
+## Required checks
+
+- no broken link
+- no required skill skipped
+- no impossible dependency
+- no missing HALT definition
+- no duplicated gate with conflicting meaning
+
+## Update
+
+Update:
+- skill-qa-report.md
+- module-catalog-audit.md
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to final QA gate`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-06-final-qa-gate.md

@@ -0,0 +1,49 @@
+# Step 06 — Final QA Gate
+
+## Mandatory Rules
+
+- Stop at this gate.
+- User must approve QA result.
+- Critical finding blocks package release.
+- High finding requires fix or explicit caveat.
+
+## Decision options
+
+A. QA passed  
+B. QA passed with caveats  
+C. Fix required before package  
+D. Block release  
+
+## Required summary
+
+| Area | Status | Finding |
+|---|---|---|
+| module.yaml | | |
+| module-help.csv | | |
+| skill folders | | |
+| assets/steps | | |
+| cross-links | | |
+| gates/HALTs | | |
+
+## Recommendation
+
+Recommend one option.
+
+## User decision
+
+Ask user to choose A/B/C/D.
+
+Do not continue until user chooses.
+
+## Record
+
+Update:
+- skill-qa-report.md
+- .decision-log.md
+- .learning-log.md if enabled
+
+## Continue checkpoint
+
+Ask:
+
+`[C] Continue to finalize skill QA`

package/src/dew-skills/4-implementation/dew-skill-qa/steps/step-07-finalize.md

@@ -0,0 +1,23 @@
+# Step 07 — Finalize Skill QA
+
+## Mandatory Rules
+
+- Do not finalize as pass if QA gate is blocked.
+- Run checklist.
+
+## Required outputs
+
+- skill-qa-report.md
+- module-catalog-audit.md
+- decision log entry
+- learning log entry if enabled
+
+## Next workflow
+
+If QA passed or passed with caveats:
+
+`dew-package-release`
+
+If blocked:
+
+Fix module structure first.