Help

How to use Speclr

Review your files in Discovery

For Discovery: how to choose files for Review Files, how Speclr goes through their findings section by section, what agreeing and rejecting do to each finding, and how the review ends.

Updated

Why review files with Speclr

  • You decideNothing from a file goes into the Vision until you agree to it in the conversation.
  • Contradictions surfaceWhere two findings disagree, Speclr asks you instead of picking one.
  • Sources stay attachedA section written in the review lists the findings it rests on.
  1. Choose the files

    In Discovery, with no session running, click "Review Files". In place of the chat input you see "Choose the files to go through. We work through the Vision section by section." and a checkbox per file.

    Beside each file stands its number of open findings, for example "4 open", or "all reviewed", "no findings", "being read", "not read" or "couldn't read". Only files that have been read can be ticked. Files with open findings are ticked already.

    The line below counts the open findings of your choice and how many Speclr set aside as not relevant for Discovery.

  2. Start the review

    Click "Start review", or "Cancel" to get the chat input back. "Start review" needs at least one file.

    A first message names the files and the open findings, for example "Reviewing pilot-interviews.pdf: 9 open findings." Speclr then starts on the first section the findings speak to. While the review runs, the Vision header shows "Reviewing files" with the number of findings still open.

  3. Decide section by section

    For each section, Speclr quotes what the files say, with file and page, and proposes a wording. Where the section already has text, it keeps what still holds and adds what the findings bring. Choose one of the options it offers, or answer in your own words.

    Where two findings contradict each other, Speclr puts the question to you with both sources. Your answer decides which one goes in.

  4. See what happens to each finding

    • Agreed: Speclr writes the section and lists the findings under it as sources. They are taken over. The section carries no "Prefill" badge.
    • Turned down: the finding is rejected, with your reason if you gave one.
    • Not discussed: it stays open for the next review.

    Speclr never takes over or rejects a finding on its own. Where to see each finding's state: Add files and use the findings.

  5. End the review

    When the last open finding is decided, Speclr says "Every finding of the chosen files is decided." and offers "End the review" or "Continue in Interactive Mode", which carries on as an ordinary interview.

    You can stop earlier with "End session" in the chat input. The closing summary says how many findings were taken over, rejected and are still open. Start Review Files again to continue with the open ones.

Start it from the chat

Ask for a review in the chat while no session runs. Speclr then reviews every read file that has open findings, without asking you to choose. If none has, it tells you so.

Findings set aside

Findings that do not matter for Discovery are set aside as not relevant and are not raised in the review. To bring one back, open its file in Files and choose "Set open".

Nothing left to review

If the chosen files have no open findings, the first message says so and the review ends straight away. Review Files is offered in Discovery only.