Help

How to use Speclr

Finish a phase

How to finish Discovery, Exploration or Planning: commit the phase’s version with a comment, clear what holds it back, and move on to the next phase.

Updated

What finishing a phase does

  • Commits a versionThe artifact is saved as a numbered version with your comment.
  • Freezes the phaseA finished phase is read-only. It changes only through a new version.
  • Opens the next phaseFinishing Discovery lets Exploration start, Exploration Planning, Planning Refinement.
  1. Open the finish step

    Once at least one session has run to its end in the phase and none is running, the chat footer offers "Finish Discovery…", "Finish Exploration…" or "Finish Planning…" next to the session modes.

    Speclr can also suggest finishing, and the finish step opens by itself. It never finishes a phase; nothing is committed until you do.

    Refinement has no phase finish: you finish its stories one by one, see Finish a story.

  2. Clear what holds it back

    • A running session. The dialog says "A session is still running…" and offers "End session". The session writes its closing summary, then you can commit in the same dialog.
    • Elements marked for review. Resolve them as handled or not relevant; "Show markers" takes you there.
    • A team member or Speclr still editing the artifact. Try again once they are done.
    • With team alignment on: if not everyone is ready, you need a justification. See Team alignment.
  3. Write the comment and commit

    The dialog is titled "Finish Discovery · Version 1", for example. It says what you commit: the Product Vision Statement, the User Story Map or the Milestone Plan.

    Write a "Commit comment", what the team agreed on in this version. It is required. Then choose "Commit version N".

    Commit comment
    required, up to 2,000 characters
    Who can commit
    any member of the project team
  4. Carry on in the next phase

    After the first version of a phase is committed, Speclr takes you to the next phase’s workspace. Committing a later version leaves you where you are.

A finished phase is read-only

The bar above the artifact shows "Finished" and "Read-only". No session modes and no edits are offered. You can still ask about it in the conversation; the answer changes nothing.

To change it, choose "Start version N+1…", see Versions and drafts.

Phases follow each other

A phase starts once every earlier phase is finished. Until then its workspace says "… has not started yet" and offers to go to the phase the project is in.

Troubleshooting

  • No "Finish …" button: no session has run to its end yet, or one is still running.
  • "Write a commit comment first.": the comment is empty.
  • "Finishing failed. Please try again.": nothing was committed; your comment is kept.