Генерация SPEC-документа с критериями приёмки

documentation

vc-generate-spec is a Claude Code skill that produces the authoritative product-discovery SPEC artifact — a plain-language requirements document intended for user review — by turning RESEARCH findings and stated user intent into verifiable acceptance criteria before INNOVATE or PLAN begins. The skill writes a single file `{slug}_SPEC_{dd-mm-yy}.md` containing nine mandatory sections: Summary, User Stories / Jobs To Be Done, Behavioral Outcomes, an ASCII flow or state diagram, Acceptance Criteria (each with `proven by:` and `strategy:` fields), Out Of Scope, Constraints, Open Questions, and Background / Research Findings. All engineer-only content — file paths, library names, schema decisions — is moved to Background, keeping the main body readable for non-technical stakeholders. In interactive sessions, any unanswered Open Questions trigger `SPEC_INTENT_BLOCKED` and halt the skill; once questions are resolved, it saves the file and emits `PHASE_COMPLETE: SPEC`. Teams running structured product discovery workflows use this skill as the formal contract between research and implementation.