Skip to documentation content

Use Verachi

Decisions

Capture, edit, link, and review decisions that sit on top of Slack, Jira, and GitHub.

UpdatedMay 11, 2026

On this page

Decisions are the durable record of what changed, why it changed, and which evidence supports it.

Verachi does not replace Slack, Teams, Jira, or GitHub. It records the decision and points back to the source.

What a decision includes

FieldPurpose
TitleShort name for the decision
ResolutionWhat was decided
Rationale & contextWhy this direction was chosen
SourceManual, Slack, Teams, Jira, GitHub, document, meeting, or transcript
Source linkLink back to the original evidence
StatusDraft, Published, or Superseded
ProjectsThe projects this decision belongs to
RiskCurrent risk posture for the decision
People involvedCreator, reviewers, approvers, and latest review state
DiscussionTeam comments and review history
GraphRelated decisions, projects, and evidence

Create a decision

Manually

  1. Open Projects.
  2. Open the project that the decision belongs to.
  3. Click New decision from the project work area.
  4. Add a title.
  5. Open More details if you want to add the summary, source, type, date, or link.
  6. Save.

After saving, use the detail page to review people involved, add discussion, connect relationships, and flag risks.

From an integration

Use Integrations to connect a source and create a rule.

Supported sources:

  • Slack reaction rules
  • Microsoft Teams message rules
  • Jira issue rules
  • GitHub label or pull request rules

Captured decisions should still be reviewed before you rely on them.

Decision statuses

StatusMeaning
DraftWork in progress
PublishedCurrent decision
SupersededReplaced by another decision

In the database, Published maps to the internal status active.

Detail sections

SectionUse it for
People involvedCreator, approvers, reviewers, and evidence source
DetailsRationale, metadata, linked context, and risk posture
GraphNearby decisions, projects, and evidence
DiscussionReview discussion and approval comments

Common actions

  • Edit a decision to change the title, resolution, source, type, date, or relationships.
  • Ask Verachi from a decision to start a grounded chat with that decision attached.
  • Flag risk when the decision may block or weaken work.
  • Publish a draft when it is ready.
  • Supersede a decision when a newer one replaces it.