Resolve conflicts
How Speclr spots contradictions in your project’s domain knowledge while you refine a story, where open conflicts show, and how to settle one in the story’s chat, during or after the session.
Updated
A conflict is two entries of your project’s domain knowledge that contradict each other, such as "Return period is 14 days" and "Return period is 30 days". Speclr does not pick a winner. It asks, and you decide.
How a conflict arises
- While you refine a storyWhen something you say contradicts an existing rule, actor, data field or glossary term, Speclr flags it and asks you in the same turn.
- Narrower is not a conflict"30 days during promotional campaigns" only adds a condition, so it is recorded without a conflict.
- One actor, two names"Administrator" for the same person as "Admin" is always a conflict. The same name twice links the existing actor.
Find open conflicts
The Conflicts button in the side bar counts the entries in an open conflict; a pair counts as two. With nothing in conflict it cannot be chosen.
Choosing it opens Context with the "Conflicts" filter on, across all categories and with the search cleared. Choose it again to return to the artifact. While a draft of version 2 or later is on screen, it includes the draft’s entries. See Context.
In a Story Artifact, a red warning icon marks a disputed rule, actor or data field. Point at it: "Unresolved conflict with “…”".
Look at both sides
Open an entry tagged "Conflict". "Open conflict" shows both statements side by side, each with its phase and story, and "Raised in … · not settled yet" with the date. Choose the story’s name to open it in Refinement.
Settle it in the story’s chat
Tell Speclr which statement holds, or that both hold in different situations. This works during the session and after it has ended. After the session, Speclr does not bring the conflict up on its own: you do. If you talk about something else, the conflict stays open.
- One holds: the other is replaced. Stories that linked it now read the one that holds.
- Both hold: both stay, and nothing is replaced.
Your words become the reason
Say why when you settle it, for example "the club refunds since the statute change in 2025". In Context, the History of the entry that holds then shows the old statement struck through, your words, who said them and a link to the conversation. Speclr keeps only words that appear unchanged in your message; otherwise it says "No reason recorded."
After it is settled
The entry that holds carries amber arrows in the Story Artifact, "Replaced “…”", and "Replaces 1" in Context. Choose "Replaced" in Context to see the old entry as well.
Conflicts that settle themselves
If the other entry leaves the project because no story links it any more, the conflict is gone. Knowledge Discovery, Exploration and Planning add is never flagged as a conflict.
Contradictions that only show up across stories later are brought up by the consistency reviewer.
