The OpenSpec update I want first is the one that writes nothing

Description and use

Using OpenSpec’s dry‑run preview shows that custom local notes will be removed, confirming that the update replaces entire command files.

Problem

Determining whether OpenSpec’s update command will modify custom local notes before applying changes.

Outcome

The dry‑run preview correctly identified that the custom note would be replaced, and the subsequent update removed the note, confirming that OpenSpec replaces entire command files rather than preserving local edits.

Workflow

• 1. Add a local note to a generated OpenSpec command file.
• 2. Run openspec update --dry-run --json to preview changes.
• 3. Verify that the preview reports no file hash changes and that the note is marked for replacement.
• 4. Apply the update with openspec update and observe the note’s removal.

Evidence

OpenSpec 1.15.0 adds update --dry-run, with a JSON form that lists planned file actions.

Source

The preview reported a replacement. Every file hash stayed the same.

Source

Then I ran the update. The local note disappeared.

Source