Help

How to use Speclr

Risks

How Speclr finds potential risks, how your team tracks, rates and mitigates them in the risk register, and where risks show up in the plan and exports.

Updated

The risk register lists what could go wrong in your project: uncertain events that rest on something in your plan, such as a Vision section, a story or a business rule. Speclr finds potential risks; your team decides which to track.

How risks work

  • Found in the backgroundAfter a commit, at the end of a session and every 10 turns, Speclr checks for potential risks, without using your tokens.
  • Decided by the teamA potential risk becomes a risk only once someone tracks it, in the register or in the chat.
  • Kept small in the planA plan change adds a story, milestone, scenario or NFA against a risk.
  1. Open the risk register

    Choose Risks in the side bar beside the artifact, in any phase, or press G, then K. Its badge counts what is new since you last opened it. The notifications "Risk recorded" and "Potential risk found" offer "Open register".

    The grid places each entry by "Probability" and "Impact": a filled dot with its number for a risk, a hollow dot for a potential risk. The score is probability times impact, 1 to 25.

  2. Decide on a potential risk

    Open a row under "Potential risks" to see why Speclr found it and what it rests on, then answer:

    • "Accept & track": tracked with the strategy Accept; the plan stays as it is.
    • "Mitigate & track": answer "How do you keep it small?" and choose "Track as risk". Your answer becomes its mitigation note.
    • "Decide later" or "No risk": the entry moves under "Not tracked", and Speclr does not bring it up again.

    The first answer counts, in the register or in the chat. A tracked risk gets the next number, such as R-001.

  3. Rate and track a risk

    Open a risk to set "Probability", "Impact", "Strategy" and "Status": Open, Observed, Occurred or Closed. A risk cannot be deleted; a closed one leaves the grid.

    A rating marked "Estimated by Speclr" is confirmed when you change a level or choose "Confirm rating". "Note" adds a mitigation in your own words.

  4. Put a mitigation into the plan

    Choose "Plan change" in an open risk. Speclr suggests changes such as a "New story", "Scenario" or "New milestone"; "Something else…" turns your own sentence into one. Suggestions need a story map and use your tokens.

    Choose "Add to the plan". A finished target asks first: "Start draft and add" starts its next version as a draft. An open draft takes it, for example with "Add to Anna's draft". See Versions and drafts.

    Each plan change shows "In draft v3", "In the plan" or "Removed from the plan".

Risks in the chat

In Discovery, Exploration and Refinement, Speclr may show a potential risk on your current work as a card: "How do you want to handle this risk?", with the same four answers. Whoever writes next answers it; a reply that does not decide counts as "Decide later". After "Mitigate & track", Speclr offers up to two plan changes, or "Keep it as a note".

Where risks show up

  • In the plan: an element a plan change added or moved carries the risk's number on the story map; a scenario or NFA says "Mitigates R-001 · …".
  • In the wiki: in Notion, Confluence or the Azure DevOps wiki, page "12. Risks and assumptions" lists the tracked risks below those from the Vision.
  • In the repository: docs/risks.md holds the register, a story's spec gets a "Risks" section, and its feature file marks a mitigating scenario with # Mitigates R-001: …. A finished story's download carries the same.

Potential risks and plan changes in a draft are not exported. Risk changes go with the next export; until then the "Pages" or "Foundation" row in Project settings says "Risks changed since the last export".

Needs review

When a commit changes, replaces or deletes an element a risk rests on, the risk shows "Needs review" and what changed. Adjust or close it, or choose "Mark as reviewed".

Who can change risks

Risk management is available on the Professional and Business plans, to every member of the project team. On other plans, Speclr finds no new potential risks, and Risks shows existing entries read-only. See Plans and what they include.

Risks, Context or Constitution?

A risk may happen; Context holds what is known, the Constitution how Speclr works.