Eidos

Every exclusion and deviation, decided and dated.

Write each line of inquiry down once: the question, the claims, and what would change your mind, written before the results. Every exclusion, deviation, and analysis choice is logged against it and confirmed by the person who owns the call, so the lab’s method outlives the student who knew it. It sits beside your lab notebook, not in place of it.

Free for macOS, Windows, and Linux. No account, no subscription.

An investigation in a sleep and memory programme open in Eidos: its claims with their evidence and strength, what would change the lab’s mind, and what the design cannot tell you, with the decisions made for it (two exclusions, a deviation, and two calls still waiting to be confirmed) in the panel beside it.
One investigation: the claims, the falsifier written in advance, and every call made for it, beside the page.

Sound familiar?

The method lives in someone’s head.

And that someone defends in May.

  1. An oral tradition

    The protocol is whatever the last postdoc did. It is written down nowhere, and you learn it by standing next to them.

  2. Which version did we run?

    Two copies of the method, the same file name, different thresholds, and nobody sure which one the first sample used.

  3. Reasons, reconstructed

    Seven participants excluded, a recall time moved, a measure swapped. By the time the paper is written, the reasons are a guess.

How it fits

One file per line of inquiry, judged against four frames.

Install the research framework and the programme gets four frames that every investigation is judged against, and one file per investigation, grouped by strand. An investigation says what is being asked and what would settle it. It is not a lab notebook, a protocol, or a task list.

Frames
Question, Prior Work, Method, and Ethics: what you ask, what is known, the standard of evidence decided in advance, and who is affected.
Investigations
One per line of inquiry, by strand: Intent, Open Questions, Claims & Evidence, What Would Change Our Mind, Out of Scope, and Method. A note variant keeps early ones short.
Status
Draft, Open, Running, Answered, Inconclusive, or Abandoned. A question that came back empty stays, because the attempt is part of what the lab knows.
Roles
Researcher, Reviewer, and Sponsor. An AI agent answers a reviewer with the weakest claim first, and a sponsor in plain language.
The investigations of a research programme as a table, grouped by strand (recordings, models, replication), each with its question as a summary and its status: Running, Open, Answered, Inconclusive, Abandoned, or Draft.

What you will use most

The pieces that keep a method honest.

  • Decisions

    Every call, confirmed by its owner

    Declare your own kinds of decision (Deviation, Exclusion, Analysis) and log each one against the investigation it touches. A call a student or an agent made waits, unconfirmed, until the person who owns it confirms it.

  • Git

    The version you actually ran

    In a Git repository, every frame and investigation shows its history: who changed it, when, and a diff against today. The method a sample used is a commit, not a guess.

  • Blueprints

    A check before the paper

    The check lists every investigation missing a section its template asks for, such as the falsifier or Out of Scope, or a property such as its strand, on a laptop and in CI.

  • Backlog

    The work beside the question

    Scoring nights, freezing a notebook, uploading tables: tasks on a board, each pointing at the investigation it serves, so the investigation never fills up with to-dos.

  • Assets

    Approvals and figures, linked

    Consent forms, ethics approvals, and figures linked to the investigations they belong to. Raw data stays where it lives now.

  • AI Agent

    An agent with the investigation open

    Claude Code or Codex beside the page, with the open investigation as context. A new student can ask how the lab scores a night and point it at the Method frame.

Pre-registration, kept

Every deviation in one table

Exclusions, deviations, and analysis choices land in one table with the investigation they were made for, who logged them, and their status. An agent’s call arrives as Proposed, assigned to the person who owns it. When the paper needs its deviations section, the list is already there.

The decisions of a research programme as a table: exclusions, deviations, and analysis choices, each with the investigation it was made for and who logged it; five confirmed, and two still Proposed and assigned to the PI, one of them logged by the agent.

History

Which version of the method did we use?

Keep the root in a Git repository and every frame shows its own history: who changed the standard of evidence, on which day, and the words that changed, with a diff beside the page. Nobody has to keep method_final2.md.

The Method frame of a research programme, with its standard of evidence and threats to validity, and its file history beside it: three commits by two people, from October 2025 to August 2026, each with a Diff button.

For the computational side

The same files from a terminal

The desktop app is optional. The CLI on npm reads the same root, so the check runs in CI beside your analysis code, and an agent in your terminal can list the calls still waiting.

$ npm install -g eidosmd
$ eidos install @BuildableWorks/research
$ eidos decisions --unconfirmed
unconfirmed (2)
  D-K68  Report slow spindles as exploratory, not as a test  ·  Proposed  analysis  @priya  assigned @ana
  D-M70  Count spindles from the central average, not Fz  ·  Proposed  deviation  @claude  assigned @ana
$ eidos check
✓ no findings

Start here

Install the research framework.

Frames for question, prior work, method, and ethics, and investigations grouped by strand. It does not ship a collection for protocols: add one under Framework settings, with the sections your lab’s protocols share, and each protocol is checked against it like any other page.

A question, a study, or a programme

Research@BuildableWorks/research

Frames for question, prior work, method, and ethics, and investigations grouped by strand.

  • Frames
  • Investigations
$ eidos install @BuildableWorks/research

In the app: New Root, then pick it from the list.

See it in the Registry
The Question frame of a research programme: the question in one sentence, why it matters, what would count as an answer (decided before the data), and what the programme is not asking.

Write the method down before the next student starts.

Download Eidos MD, install the research framework, and write your programme’s question and its standard of evidence. It is free, and the files stay in your lab’s own repository.

Free for macOS, Windows, and Linux. Your files stay plain text in a folder you own.