T-RKWR-auto-define-cites-real-helper-surface

Status: closed/done · Impact: medium · Complexity: small

Goal

When /sdlc:task-auto-define (or a human spec author) cites an existing helper for an implementer to reuse, the citation should match that helper’s actual public surface. In T-VWH3 the spec said frontmatter is “parsed with the existing lib/util/yaml helper,” but that module is dumper-only; the implementer had to substitute the yaml package’s parse (repo convention). Close the drift between cited intent and the helper’s real API — either by tightening the spec-authoring guidance so cited helpers are surface-checked, or by adding a parse export to lib/util/yaml so the citation becomes accurate. Originates from T-VWH3-ts-index-generator-script in git@github.com:sksizer/dev.git.

Task spec said frontmatter is “parsed with the existing lib/util/yaml helper” but that module is dumper-only; the implementer substituted the yaml package’s parse (repo convention) — spec-authoring drift between intent and the cited helper’s actual surface.

— T-VWH3-ts-index-generator-script post-mortem