The Precedent handbook
Find decisions
Find what the team decided before starting the next discussion. Search by reference, words, or meaning, then read the reasoning behind the result.
Search the record
- Choose Search in the sidebar. With an empty query, results show the newest decisions first.
- Enter a topic, title, or reference. At Acme Robotics, try “catalogue search”, “Postgres”, or “AR-041”.
- Use a status filter and the area filter to narrow the results. Choose Owned by me for your records or Review due for decisions needing attention.
- Open a result to read its rationale, alternatives, review date or condition, linked decisions, and evidence. Check its status before relying on it.
The Area filter shows decisions explicitly tagged with that Area. Decisions with several tags appear under each linked Area, subject to your permissions.
The status filters include All, Decided, Drafts, and Superseded or reversed. A draft is not yet a decided choice; a superseded record should lead you to its successor. A decided decision whose proposed change waits for approval also shows the kind of change, such as Reversal proposed, and stays as decided until the change is approved.
The Type filters below them list every Type you can record, each with its icon. Choose one to show only decisions of that Type, or All Types to show every Type again. Each result shows its Type straight after its reference. With Term chosen and an empty query, terms are listed A to Z, each with its whole meaning.
Choose a search mode
The mode controls appear when you enter a query.
| Mode | Use it for |
|---|---|
| Hybrid | The default: combines exact words and meaning. Start here for most questions. |
| Keyword | Known wording, product terms, or a decision reference. |
| Semantic | A concept described in different words from the original decision. Results depend on the deployment’s embedding setup. |
Hybrid and Semantic ask the deployment’s embedding service to read the meaning of your query. If that service fails or does not answer within two seconds, the search returns exact-word matches instead, and the line above the results says that meaning search is unavailable.
If you cannot find a decision
When no decisions match, choose Clear filters to remove Area, Type and status filters and restore Hybrid mode while keeping your search words. You can also try a shorter query or switch to Keyword if you know the title or reference. With no search or filters, an empty list means no decisions are available to you. Confirm you are in the right workspace using the workspace switcher.
If the decision has not been recorded and you have write access, use Record a decision from an empty result (with a Type chosen, the search box empty and no other filter, the link names that Type, such as Record a rule) or choose New decision.
Explore the surrounding context
Open an area to browse decisions for that domain, project, or team. Use linked decisions and the impact map on a record to understand what relies on it. For a question that spans several records, use Ask AI and follow its citations back to the source decisions.