Sapling SAP
Guides

The decision interview and proposals

Answer the open decisions of the plan one at a time, with the protocol sentence and the options in front of you. Proposals arrive in an inbox that you accept, decline or improve.

Where the protocol is silent, the plan holds an open decision. A first plan may have twenty. The decision interview takes them one at a time.

The interview#

Run Sapling: Work Through the Open Decisions. For each decision you see:

The decision interview: what good SAPs do, what recent SAPs do, and options, one suggested.
One decision: the protocol sentence, what good SAPs do, what recent public SAPs do, and options.

Decide and write what follows records your answer with your name and today's date. Where Sapling has a generator for the option (for example the multiplicity procedure, an estimand's intercurrent event, a missing-data block, a sensitivity analysis), the blocks that follow are written in the same step as a proposal compiled in its place. Record the answer only keeps the decision without writing blocks. Ask me later and Skip are there too.

Proposals#

A proposal is one change of the plan: a block inserted, replaced or deleted. It carries a short title, a reason, the protocol sentences it cites, and the result of compiling the plan with the change. A proposal that does not compile cannot be accepted.

In the page, a new block has a green edge. A change shows as the block now beside the block proposed, with the changed words marked. A deletion is struck through. Then you choose:

The inbox of the assistant with two proposals from a template, and a proposed tipping-point sensitivity analysis shown in its place in the page with Accept, Edit in a form and Decline.
A proposal in its place in the page, marked "from a template": Accept, Edit in a form, or Decline. A proposal from an AI looks the same and says so.

The assistant panel has an Inbox of proposals, a Chat, and Cards. Each proposal says where it comes from: from the rules, from a template, or an AI proposal. A task such as Answer the review findings or What is missing makes many proposals at once; Accept all that compile and cite the protocol lists what it will apply and asks once.

House rules#

Plain sentences in .sapling/rules.md of the study ("Continuous efficacy endpoints: MMRM with unstructured covariance, Kenward-Roger") are read first when options and proposals are made. A shared file for a company standard is the setting sapling.ai.rules. The protocol wins: when a rule and the protocol disagree, Sapling says so and offers a decision.

More about how this works: the assistant reference.