to-spec
To Spec
Owns: specification framing, decisions, constraints, and implementation intent. It does not serialize tickets, schedule work, implement code, or decide verification claims.
Defaults
Unless the user or destination explicitly requires compatibility, specify the clean target state. Do not add legacy aliases, parallel formats, shims, or migration work by inference. Still identify destructive data changes, breaking external contracts, and irreversible operations.
Save under docs/specs/<slug>.md unless the user provides a path. Update an existing
matching spec rather than creating a duplicate.
Every saved spec includes one ## Artifact Graph section with a stable Artifact ID,
Role: spec, and exactly Standalone: true or one Parent. For an owned spec, update
the owner's reciprocal Children or Produces link in the same change.