Help

How to use Speclr

Consistency reviewer: contradictions between your stories

How Speclr checks your stories for contradictions in the background during Refinement, how it raises a finding in the conversation, and what your answer does. Professional and Business plans.

Updated

While you refine stories, Speclr’s consistency reviewer checks in the background whether what you just agreed contradicts another story, the Vision Statement or the story map. It never changes anything on its own: it brings what it found into the conversation, and you decide.

It complements the conflict check that runs in every Refinement turn. That one catches a statement that contradicts an existing entry the moment you make it (see Resolve conflicts). The consistency reviewer catches what only shows up across stories, later.

What it looks for

  • Contradictions between storiesA rule, data field, scenario or requirement in one story says the opposite of one in another.
  • Clashes with what is settledA story goes against the Vision Statement, the story map, Memory or the Constitution.
  • Gaps a story relies onA scenario depends on something no story on the map provides, or names a story the map calls differently.

It does not report a statement that only narrows another, such as a longer return period during campaigns, and it does not point out features the story map simply does not cover.

  1. Refine as usual

    The check starts after a Refinement turn that added or changed something it can check: a business rule, an actor, a data field, a scenario, a non-functional requirement or a boundary. That includes the conversation of a finished story. A turn that only links an existing rule, or changes nothing, starts no check.

    It runs in the background and does not count against your token budget. You do not see it working; if a check fails, nothing is shown and the next one picks up its changes. The first check of a project looks at all of its knowledge.

  2. Speclr raises a finding instead of its next question

    The next time you write in a story that holds one side of a finding, Speclr’s reply brings it up instead of asking its next interview question. It names the statements that clash and where they come from.

    A contradiction between two stories can be raised in either of them. A clash with something settled, such as the Vision Statement, is raised only in the story whose statement needs review. Other stories are not interrupted.

  3. Answer it in your own words

    • One holds: say which. Speclr adjusts or replaces the other statement, and the finding is settled.
    • Both are right: Speclr dismisses the finding. It is not raised again.
    • Not now: the finding is put aside, as is any answer that settles nothing. It comes back only if one of its statements changes and the contradiction is still there.
    • The change belongs to another story: Speclr hands your decision over. That story raises it with your decision in its next turn.
    • Something is missing: tell Speclr how you will handle it, for example that a story for it will be added in Planning. Speclr dismisses the finding; it does not create stories.

How replacements show

When your answer makes one business rule replace another, the replaced rule is kept in the project’s history, with your words as the reason. In the Story Artifact, the entry that won is tinted amber and carries an arrows icon; point at the icon to see "Replaced “…”" with the statement it replaced. In Context, the filter "Replaced" shows replaced entries, and an entry’s "History" names what it replaced and why.

It never blocks you

An open finding does not stop you from finishing a story or a phase. It waits in the conversation until you answer it.

Findings lapse when things change

If one of its statements is changed, replaced or deleted, a finding is no longer raised. If the contradiction is still there, a later check records it again.

Which plans include it

The consistency reviewer works on the Professional and Business plans. After a downgrade, findings already recorded are still raised, but no new checks run. See Plans and what they include.