The Precedent handbook
Getting started
Record the choice, preserve the reasoning, and know when to revisit it. Start with one decision your team has already made.
Every record is one of seven Types: choices, rules, exceptions, how-tos, facts, lessons and terms. See The seven Types.
A useful record starts with why.
At Acme Robotics, AR-041 records the choice to use Postgres full-text search instead of Elasticsearch. It explains the tradeoff, names an owner, and says what would make the team reconsider.
Write your first decisionSet up your workspace
- Sign in using an available provider or a sign-in link. If a sign-in link has not arrived, wait a minute before requesting another; repeated requests may take longer. Your first sign-in creates your account. If you were invited, use the invited email address to join that workspace. Otherwise, create a workspace for your team; returning members can choose an existing one. Use the workspace name in the app sidebar to switch between workspaces.
- If you create a workspace, give it your team's name. Acme Robotics uses AR- references, such as AR-041. Each decision gets a stable reference you can share.
- Use the Area created during setup, or open Areas to add another. An Area groups related records, such as Infrastructure or Search. See Organise with Areas.
- As a workspace administrator, invite teammates in Settings → Users. On the Free plan a workspace has one member; upgrade to Teams under Settings → Billing before inviting. Self-hosted deployments without billing have no Billing tab and no Free plan. If you were invited, use the invited email address to sign in. See roles and workspace settings.
Record one real choice
- Choose New decision. Write what was decided in the first field, which is named after the Type, and describe it in Summary.
- Add the rationale and the alternatives that lost. Choose an owner, at least one area, and a review date or condition.
- Choose Save as draft to keep working or attach evidence. When the checklist is complete, the owner chooses Approve, or Ask for approval when their Areas need someone else. The draft becomes Decided once it has the approvals its Areas require.
- Open the saved record and share its URL or reference. Other people can read it if their workspace and area access allow it.
Find your way around
Bring in decisions from your tools
You can use the app without connecting an AI model or an assistant. When you want to capture decisions from existing conversations or make them available to your assistant, start here.
Get help without losing your place
Choose Docs in the app sidebar. On a phone, open the app menu first. The Back to app button stays at the top of every guide and returns to the page you came from, including its search filters or Settings tab.
Use Find a guide to search guide titles and topics. On mobile, open Browse guides. Each guide has section links and a next guide at the bottom. If you arrived here directly, Open app takes you to your workspaces.
For subscription questions, see Plans and billing. For help with a problem you cannot resolve, email [email protected] with the page and what you expected to happen.