How do I reconcile spec artifacts after editing?

[kafumanto]

Hi! I'm new and just tried OpenSpec. I have a question I haven't found an answer to in the documentation.

How can I reconcile spec artifacts after manually editing them, before "/opsx:apply" and starting the implementation?

For example: I change a detail in proposal.md and would like to realign the design.md and tasks.md files before implementation (or I change something in design.md..
the problem is the same). How can I do this?

Thanks!

[alesky78]

/opsx:explore

Reviewing the skill details reveals that exploration mode does more than just prepare the context for a new feature;
it can also modify the markdown files of a specification.

For instance, I use it to update design.md.
Similarly, when I want to maintain spec.md as a purely functional document, I use it to migrate technical details into design.md, ensuring the specification remains clean

[clay-good]

Good question, and there is a command for it now: /opsx:update.

Its entire job is the thing you described: revise a change's existing planning artifacts and keep them coherent with one another, planning only, no code. Edit a detail in proposal.md, run /opsx:update, and it tells you which parts of design.md and tasks.md now disagree and offers the fixes before you get anywhere near /opsx:apply.

Shipped in v1.6.0 via #1340. Docs: docs/commands.md.

There is also a page written for exactly the question you asked: docs/editing-changes.md.

@alesky78's /opsx:explore answer is still the right move when the idea itself needs rethinking. /opsx:update is the one for "the plan is fine, the files just drifted apart."

[kafumanto]

Thanks! This new /opsx:update command looks like exactly what I was looking for!
It's a great new addition for me, I strongly prefer to have more "visibility" over what the AI agent is doing (edit -> update -> apply), rather than running "continue" and not having a clear vision of what will happen next.
Thank you very much also for all the helpful links you shared!