Help

How to use Speclr

Add files and use the findings

Add notes, interviews, specs and photos to a project, check what Speclr found in them, and use the findings in Discovery. Includes file types and limits.

Updated

Notes, interviews, specs and whiteboard photos often hold what Discovery asks about. Add them to the project and Speclr reads them into a transcript and a list of findings that the whole team sees.

What Speclr makes of a file

  • A transcriptText is read as it is; photos and scanned pages are read by the model. Passages it was unsure about are marked.
  • FindingsEach thing it found, typed as Statement, Decision, Idea, Constraint or Question.
  • Material for DiscoveryPre Fill, Auto and Review Files build on the findings. Nothing counts as known until you confirm it.
  1. Add files

    Choose "Add files" in the composer when you start a project, or later in Files: open Files in the side bar and choose "Add files".

    Files are read by Anthropic’s Claude in the USA, so leave out personal data you do not need. See Privacy and your data.

    File types
    PDF, Word (.docx), Markdown, text, JPEG, PNG
    Size
    up to 20 MB, photos up to 7 MB
    Pages
    up to 50 per document
    Files
    up to 10 per project
  2. Let Speclr read them

    A status line above the chat input shows "Reading" and the file, in every phase. You can start any mode meanwhile; a Pre Fill started before a file is read leaves that file out.

    When the last file is done, a message says "All N files are read" with "See findings". In Files, each file then shows "Read" and its number of findings, or "Couldn't read" with "Retry".

  3. Check what Speclr found

    Open a file in Files. Switch between "Original" ("Photo" for an image) and "Transcript"; the transcript cannot be edited. Below, "Speclr found N things in this file" lists the findings.

    The eye button marks a finding's passage in the transcript. Delete a finding that is wrong with its bin button.

  4. Use the findings in Discovery

    Pre Fill and Auto use the findings that matter for Discovery and list them as a section's sources. To go through files with Speclr, start Review Files, choose the files and "Start review". It works through the Vision section by section and writes a section only with your agreement.

Finding states

Each finding shows its state in Discovery, and the file shows how many are reviewed, for example "12 of 17 reviewed in Discovery".

  • Open: not discussed yet. New findings start open.
  • Taken over: written into a Vision section, which is named.
  • Rejected: turned down in Review Files, with your reason.
  • Not relevant: set aside as not mattering for Discovery. Choose "Set open" to bring it back.

Taken over and Rejected are set in Review Files only, not by hand.

When a file is refused

  • Wrong type: "… cannot be read. Add a PDF, Word, Markdown, text, JPEG or PNG file."
  • HEIC photo: "… is a HEIC photo. Export it as JPEG and add it again."
  • Size, pages or number of files: the message names the limit, such as "A project holds at most 10 files."

Deleting files and findings

Point at a file in Files and choose its bin button. Its transcript and findings go with it. Vision sections built from a deleted finding keep their text and lose the source. A file added again is read from the start.

Memory and the Constitution

Memory, next to Files, holds general facts Speclr picked up about the project. The Constitution holds what everything in the project has to comply with.