What problem does it solve? Writing a new governed document by hand in a Headwater corpus is refused by the PreToolUse hook, and hand-typed front matter drifts from the taxonomy. This Skill routes every new document through the headwater new verb so placement, identifiers, facets, and section headings come from the engine, leaving only judgment calls to the author. ## Core Features & Use Cases - Engine-driven scaffolding: Runs headwater new <kind> --title for all 18 document kinds (decision, obligation_record, evaluation, specification, etc.) and interprets the origin report the verb prints. - Hand-entry guidance: Explains how to fill the fields the engine marks as hand entry — the summary scent facet, section bodies, provenance blocks, and the accepted_by/status lines governed by rulings HW-DR-0034 and HW-DR-0052. - Refusal handling: Maps Unnameable and FacetUndeterminable refusals to the correct escalation path (the taxonomy skill or --facet waiting_on=<value>), never a workaround. - Use Case: When asked to record a finding or file a decision under docs/, invoke this Skill to scaffold the document via the engine, fill the judgment fields, and finish with headwater check until errors reach zero. ## Quick Start Ask the assistant to draft a new decision record titled with your finding, and it will run the headwater new verb, fill the hand-entry fields, and validate the corpus with headwater check.
