Quick start
- Open Jira settings, then choose Apps.
- Select Workflow Linter under the installed apps section.
- Choose Run first scan.
- Review findings in priority order and open each result for evidence and remediation.
Workflow Linter appears on a Jira administration page because Jira restricts workflow configuration access to administrators.
Scanning
The app discovers global and project workflows with Jira Cloud REST v3 workflow search, then reads complete transition graphs through Jira's bulk workflow endpoint. The same deterministic analysis service powers on-demand and weekly scheduled scans.
- Ordinary rate limits and temporary Jira failures are retried automatically.
- The latest successful result remains available when a refresh fails.
- Diagnostics classify failures without exposing raw Jira response bodies.
Understanding findings
Each finding includes severity, confidence, workflow context, exact evidence, impact, and remediation guidance. Factual findings identify structural defects. Heuristic findings identify designs that deserve administrator review.
Intentional designs can be suppressed without changing Jira. Suppression identifiers remain stable for the same workflow, rule, subject, and evidence.
Rule catalog
| ID | Severity | Confidence | Detects |
|---|---|---|---|
| WL001 | Critical | Factual | No initial transition |
| WL002 | High | Heuristic | Multiple initial transitions |
| WL003 | Critical | Factual | Missing transition target |
| WL004 | Critical | Factual | Directed transition without a source |
| WL005 | Critical | Factual | Missing transition source |
| WL006 | Medium | Factual | Deprecated status still present |
| WL007 | High | Factual | Status unreachable from the initial path |
| WL008 | High | Factual | Reachable non-Done dead end |
| WL009 | High | Factual | Reachable status with no path to Done |
| WL010 | High | Heuristic | Workflow has no Done-category status |
| WL011 | Medium | Heuristic | Global transition to Done exposes no validator metadata |
| WL012 | Medium | Heuristic | Global transitions dominate the workflow |
| WL013 | Medium | Heuristic | Same transition name leads to different targets |
| WL014 | Medium or High | Heuristic | Elevated status or transition complexity |
Every result includes a stable ID and practical remediation. Heuristics are intentionally labeled and can be suppressed.
Exports
CSV and JSON exports contain the stored finding detail visible in the app. Use CSV for spreadsheet review and JSON for internal tooling or long-term evidence capture. When a storage warning is shown, lower-priority detail may be omitted while aggregate counts remain accurate.
Safety limits
- Up to 1,000 workflows across 20 Jira API pages.
- Detailed storage for the 200 highest-priority findings.
- Up to 500 finding suppressions.
- One bounded latest successful report rather than an accumulating history.
Troubleshooting
The first scan does not run
Confirm you opened Workflow Linter as a Jira administrator and retry. Open Show diagnostics for the failure class and timestamps.
A workflow or finding is missing
Check for workflow-limit or stored-report warnings. Aggregate counts remain intact even when lower-priority detail is bounded.
A finding is intentional
Use Suppress intentional exception. You can restore the finding later.
Still need help?
Email support@workflowlinter.com with the diagnostics block, approximate time, app version, and a description with sensitive tenant information removed. Never send passwords or API tokens.