Core Workflows

Use these workflows during planning, refinement, and review meetings.

Create a decision

  1. Open Simple Decision Log in your Jira project.
  2. Click New Decision.
  3. Add title, status, decision date, and rationale.
  4. Assign DACI roles.
  5. Link relevant Jira issues.
  6. Save.

Practical example

Decision: Standardize on Storybook for UI documentation

  • Rationale: Reduce review friction and improve handoff quality
  • Driver: Design Systems Lead
  • Approver: Engineering Manager
  • Contributors: Frontend Team
  • Informed: QA, Product
  • Linked issues: WEB-221, WEB-238

Edit a decision

Update decisions when context changes.

  1. Find the decision with search or filters.
  2. Open it and click Edit.
  3. Update fields such as status, linked issues, or rationale.
  4. Save changes.

Tip: Keep the original rationale and append an “Update” note so history remains readable.

Delete a decision

Delete only when the entry is invalid or duplicate.

  1. Open the decision.
  2. Click Delete.
  3. Confirm the action.

Deletion is permanent.

Daily usage pattern

  • During planning: create new decisions as agreements are made
  • During delivery: link decisions to active Jira issues
  • During review: update status and impact to reflect outcomes