Project Health Guard

Jira app that scores project hygiene, finds drift, and creates an actionable Fix Plan (tickets) in one click—so admins keep teams shipping fast.

Comment

Inspiration

As Jira projects scale, teams start to “drift”: issues miss owners, priorities are inconsistent, descriptions are empty, and work silently stalls. Jira Admins/PMOs often discover this too late—during a sprint review, an incident, or when delivery slips. We wanted a lightweight, production-friendly way to continuously check project hygiene and turn governance into fast, actionable work.

What it does

Project Health Guard is a Forge app for Jira that:

  • Scans a project’s recent issues on demand (directly from the Jira project page)
  • Computes a simple health score (0–100) and highlights hygiene risks:
    • Missing assignee
    • Missing priority
    • Missing description
    • Stale issues (no updates for N days)
  • Creates an actionable remediation plan in Jira with one click via Create Fix Plan

The goal is not just reporting, but a closed-loop workflow: detect → score → act.

How we built it

  • Built on Atlassian Forge
  • UI is implemented with Forge UI Kit as a Jira project page module
  • Data comes from Jira REST API (issue search + fields needed for hygiene checks)
  • The fix plan is generated by creating a Jira issue via the API
  • No external services or API keys required (works out of the box in a Jira Cloud dev instance)

Challenges we ran into

  • Ensuring the scan runs against the correct project context (the project the user is currently viewing)
  • Keeping the MVP reliable and judge-friendly without requiring complex configuration
  • Choosing checks that are simple, explainable, and map to real operational impact

Accomplishments that we're proud of

  • A working, installable Forge app that runs inside Jira
  • A clear, measurable health score with a breakdown
  • A closed-loop action: one-click creation of a Fix Plan directly in Jira

What we learned

  • The highest-leverage Marketplace ideas often tie directly to governance, quality, and operational ROI
  • “Actionable” beats “insightful”: turning findings into Jira work items makes the value immediately visible
  • Simple checks can still deliver strong impact when they reduce admin overhead and prevent delivery drift

What's next for Project Health Guard

  • Generate a richer Fix Plan (Epic + multiple tasks, mapped to each issue category)
  • Add configurable policy packs (Scrum / Kanban / ITSM-lite) per organization
  • Bulk quick-fixes with audit trail (e.g., apply labels, add description templates, suggest owners)
  • Trend charts (health score over time) and scheduled scans

Built With

Share this project:

Updates