> For the complete documentation index, see [llms.txt](https://synapseworks.gitbook.io/synapseworks-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://synapseworks.gitbook.io/synapseworks-docs/decision-register/overview.md).

# Decision Register Overview

## Purpose

Explain how Decision Register creates an audit-style history from Jira issue change events.

## Who it is for

* Jira administrators and project leads
* PMO, governance, and audit teams
* Engineering managers reviewing delivery drift

## Prerequisites

* Decision Register app installed on Jira Cloud
* Access to Jira projects and issue history data

## Product page

Website: [Decision Register for Jira](https://synapseworks.org/apps/decision-register/)

## Steps

1. Open Decision Register from the Jira Global Page or Admin Page.
2. Configure run filters for scope and period.
3. Run a scan to generate decision entries from issue history.
4. Review grouped or table output, counts, and metadata.
5. Export results for reporting or audit sharing.

## Capability summary

* Forge app exposed as Jira Global Page and Admin Page
* Generates audit-style register from issue change history
* Detects estimate, priority, scope or sprint, rollback or reopen, assignee, due date, and release or fix version changes
* Entry fields include issue key, summary, when, who, from, and to
* Supports run filters: project selection, time range, max issues scanned, issue types, and only-my-changes
* Estimate field handling supports auto-detect and optional `customfield` override
* Results in grouped or table views with per-group visibility controls
* Type counts and run metadata included
* Issue links in results for fast verification
* Export options: CSV plus fallback copy-to-clipboard
* Per-user preferences persisted in Forge storage with reset-to-defaults
* Resilience includes retries for rate-limit and server errors, first-run init message, and partial-result warnings

## Rovo positioning

Decision Register complements Atlassian AI/Rovo by adding structured, auditable change evidence for governance and operational review.

## Common issues

* Empty output is often caused by narrow filter scope or short time windows.
* Large scans can return partial warnings; use run metadata and rerun with adjusted limits.

## Related pages

* [Quickstart](/synapseworks-docs/decision-register/quickstart.md)
* [Detections](/synapseworks-docs/decision-register/detections.md)
* [Configuration](/synapseworks-docs/decision-register/configuration.md)
* [Export](/synapseworks-docs/decision-register/export.md)
* [Security and data](/synapseworks-docs/decision-register/security-data.md)
* [Troubleshooting](/synapseworks-docs/decision-register/troubleshooting.md)
* [Documentation index](/synapseworks-docs/index.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://synapseworks.gitbook.io/synapseworks-docs/decision-register/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.