-
Notifications
You must be signed in to change notification settings - Fork 5.1k
Open
Description
Context
I generated an initial plan with /speckit.plan and used it to derive tasks. Later I realized the plan was missing an item, so I ran /speckit.clarify to add it to the spec and then ran /speckit.plan again.
On the second run, plan.md was overwritten and replaced with the default template, instead of updating/merging the existing plan. Other files produced by the previous plan appeared to be updated correctly with the clarified content, but plan.md specifically was reset.
Expected behavior
One of the following (any of these would be acceptable):
/speckit.plandetects an existingplan.mdand updates it (merge/append) rather than replacing it./speckit.plancreates a new file likeplan.v2.md(orplan.<timestamp>.md) and preserves the old one./speckit.planrefuses to overwrite and prints an explicit message like “plan.md exists, use --overwrite or --new-plan”.
Actual behavior
- Re-running
/speckit.planoverwroteplan.mdand replaced it with the template content. - Previously generated artifacts (other than
plan.md) seemed to reflect the changes introduced by/speckit.clarify.
Repro steps
- Create a spec and run
/speckit.planto generateplan.md. - Create tasks from it (optional).
- Run
/speckit.clarifyto add missing details to the spec. - Run
/speckit.planagain. - Observe
plan.mdgets replaced by template content.
Questions / Ask
- Is there an established workflow for updating a plan after
/speckit.clarifywithout losing the previousplan.md? - If not, can
/speckit.planbe changed to avoid destructive overwrites (merge, versioned plan files, or explicit overwrite flag)?
Suggested fix
Default behavior should be non-destructive:
- Keep the previous plan and write a new versioned plan, or
- Update existing
plan.mdin-place, or - Require an explicit overwrite option.
Metadata
Metadata
Assignees
Labels
No labels