ghostgeist

Inspiration

Every engineering team knows the rule: "No PR without a Jira ticket." Yet in every engineering organization we've worked in, 20% to 30% of real engineering effort bypasses Jira entirely. When a production service crashes at 2 AM, when a senior engineer refactors a brittle auth module, or when a security patch needs to ship immediately, developers open a GitHub PR first and tell themselves they'll file the ticket later. They rarely do.

Existing Jira-GitHub integrations only work if a human manually puts PROJ-123 in the branch or PR title. We built GhostGeist to answer a simple question: What if Jira could proactively discover untracked engineering work on GitHub, understand the code diff in the context of your existing Jira backlog, and let you reconcile it with a single click—without ever spamming your board?

What It Does

GhostGeist is an Engineering Shadow Work Reconciliation Platform built natively on Atlassian Forge:

1. Passive Untracked PR Discovery: Scans open GitHub Pull Requests and uses boundary-checked regex analysis alongside a Forge KVS reconciliation ledger to isolate PRs missing Jira issue keys.
2. Context-Aware AI Triage (GitHub Diffs + Jira Project Context): Combines the PR's file patches from GitHub with live project metadata and recent issues from Jira REST API v3, using Google Gemini 3.8 Flash (with structured JSON schema enforcement and multi-model fallback) to synthesize:
   • Standardized Jira summary and technical description
   • Project-validated Issue Type (Bug, Task, Story)
   • Fibonacci Story Point estimate (1, 2, 3, 5, 8) with architectural rationale
   • Semantic duplicate detection (alerting the user if an existing open Jira issue already covers the PR)
3. Interactive Jira Command Center (@forge/react UI Kit 2): Embeds a native project page in Jira with shadow capacity stat cards, auto-triage badges, and an editable review modal.
4. 1-Click Bi-Directional Reconciliation: Creates a strict Atlassian Document Format (ADF) Jira issue, attaches an official GitHub remote link to the Jira ticket, updates the GitHub PR with the new Jira key, and records the link in Forge KVS.
5. Omnichannel Agent Execution (rovo:mcp + rovo:agent + skill.md): Exposes three Forge action tools (get-untracked-prs, triage-pr-gemini, create-jira-ticket-from-pr) to both Atlassian Rovo Chat and external IDE agents (Cursor, Claude Desktop, Antigravity).

How Project Meets the Main Technology Requirement

GhostGeist is built 100% natively on Atlassian Forge (nodejs24.x runtime) and integrates deeply with Jira Cloud and Atlassian Rovo:

• jira:projectPage Module: Renders a native UI Kit 2 (@forge/react) command center inside Jira Software projects.
• Jira Cloud REST API v3 via @forge/api: Uses api.asUser().requestJira(...) and api.asApp().requestJira(...) to query project issue-type schemes (/rest/api/3/project/{key}), search existing project issues (/rest/api/3/search/jql), create ADF-formatted issues (/rest/api/3/issue), and bind remote GitHub links (/rest/api/3/issue/{key}/remotelink).
• Forge Key-Value Storage (@forge/kvs): Persists encrypted API credentials and the reconciliation ledger server-side with zero secret exposure over @forge/bridge.
• Atlassian Rovo (rovo:mcp, rovo:agent, and action Modules): Exposes GhostGeist's capabilities both as an in-product Rovo Agent and as an external Model Context Protocol (MCP) server.

Bonus Prize Write-Ups

1. Best App with Atlassian MCP

GhostGeist implements the rovo:mcp module (ghostgeist-mcp) in ghostgeist/manifest.yml, exposing three structured action tools over Atlassian's managed MCP server:

• get-untracked-prs: Audits open GitHub PRs and filters out tracked/reconciled work.
• triage-pr-gemini: Inspects code diffs alongside Jira project context to return a structured JSON ticket proposal.
• create-jira-ticket-from-pr: Creates the ADF Jira issue, attaches the GitHub remote link, and records the reconciliation. We also authored a comprehensive open-source skills/ghostgeist/skill.md file containing tool schemas, client configurations for Claude Desktop and Cursor (mcp-remote), sequence diagrams, and human-in-the-loop system prompt guardrails so any developer can reconcile shadow work directly from their IDE.

2. Best Agents — Rovo / Assignable Agents

GhostGeist declares a native rovo:agent module (ghostgeist-auditor-agent) paired with three reusable action modules in ghostgeist/manifest.yml. Once installed on a site, teams can immediately invoke the GhostGeist Shadow Work Auditor inside Rovo Chat to audit repositories, estimate unbudgeted engineering story points, and convert untracked PRs into linked Jira tickets conversationally.

3. Best Marketplace Published App

GhostGeist was engineered from day one to meet Atlassian Marketplace security, reliability, and UX standards:

• Zero External Backend Infrastructure: Runs entirely inside Atlassian's serverless Forge runtime.
• Zero Client Secret Leakage: API tokens are stored server-side in @forge/kvs and masked as boolean flags on the frontend bridge.
• Strict Egress Whitelisting: Outbound fetch calls are restricted solely to api.github.com and generativelanguage.googleapis.com.
• 100% UI Kit 2 Compliance: Uses native @forge/react primitives with zero custom HTML/CSS injection and passes forge lint with 0 errors and 0 warnings.

Atlassian Installation Link

https://developer.atlassian.com/console/install/8f916e76-19dc-490d-8440-d6ff0cf9122d?signature=AYABeAiuMcCeLavdcTWOgAn%2BE%2F4AAAADAAdhd3Mta21zAEthcm46YXdzOmttczp1cy13ZXN0LTI6NzA5NTg3ODM1MjQzOmtleS83MDVlZDY3MC1mNTdjLTQxYjUtOWY5Yi1lM2YyZGNjMTQ2ZTcAuAECAQB4CxqLTo9l4lqXuFjNim1xJM%2Bp%2F3TVP9xHS2BrU5DRRucB1P6Eto63k78iuvrNITOSwQAAAH4wfAYJKoZIhvcNAQcGoG8wbQIBADBoBgkqhkiG9w0BBwEwHgYJYIZIAWUDBAEuMBEEDNvj4TMCYpfhpEaaPgIBEIA7AzDa0tjeiSuqUQqhvrJJdLsoK0RiP%2B2vvK3S18HWXvShy4wakbezFezX8qIfOrM3CEqWfWgX2nPbkZgAB2F3cy1rbXMAS2Fybjphd3M6a21zOmV1LXdlc3QtMTo3MDk1ODc4MzUyNDM6a2V5LzQ2MzBjZTZiLTAwYzMtNGRlMi04NzdiLTYyN2UyMDYwZTVjYwC4AQICAHi9bVMAkme4qVQX1fQHo6ePw3H40A7cGfz7yrmSfBWMXgFphpOPKMykrrveD6ylIpTlAAAAfjB8BgkqhkiG9w0BBwagbzBtAgEAMGgGCSqGSIb3DQEHATAeBglghkgBZQMEAS4wEQQMYwyN2sckWxCJS1uvAgEQgDu25O%2FQQQmfrnuQ5v2WQ3BzAR%2FcSOKMAkTHSl6XlfYjWH5j6yVenAk1HB12RlHjnOPPIsOuyAK8Tp9ZxAAHYXdzLWttcwBLYXJuOmF3czprbXM6dXMtZWFzdC0xOjcwOTU4NzgzNTI0MzprZXkvNmMxMjBiYTAtNGNkNS00OTg1LWI4MmUtNDBhMDQ5NTJjYzU3ALgBAgIAeDYASx0XCjkny4iLV6vz%2BKtEGSGT6kdt0QRpkn6D%2FlVEAcjOYKh1BCv7d1W6NATkqpwAAAB%2BMHwGCSqGSIb3DQEHBqBvMG0CAQAwaAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAxdjI8MZ%2FYN2GDUJc0CARCAO8WrJYz8YuQbd3c4nWyL2dsdiMWujOkWcM5BBsz4O1jP7mZfffCju755mDv9rKM8zKOZHyIqs%2BwuPrWpAgAAAAAMAAAQAAAAAAAAAAAAAAAAAIWAOeP9E2j%2BkB2%2Bxgko%2B2T%2F%2F%2F%2F%2FAAAAAQAAAAAAAAAAAAAAAQAAADJALpoJfSguh5Q4Ky%2FCHGd5dHm7%2BEsPtRo5ABGPWZj4jfWybZnQP7UntPx2aXQmRFmJIP1TMCUZ4YmYMRgy2QCpSxs%3D&product=jira

Built With

• atlassian-document-format
• atlassian-forge
• atlassian-rovo
• claude-desktop
• cursor
• forge-kvs
• gemini-3.8-flash
• github-api
• google-gemini
• javascript
• jira-cloud
• jira-rest-api
• model-context-protocol
• node.js
• react
• ui-kit-2