Inspiration
Teams re-decide things they already settled, and AI agents now build against decisions nobody told them about. The decision usually exists somewhere: in a meeting, a comment, a chat thread. It is just not where the next piece of work starts. Codegeist asks for context that helps teams ship with confidence, including what has already been decided. We built the smallest thing that makes that context show up at the right moment.
What it does
Decision Ledger keeps each decision on the Jira issue where it was made: what was decided, why, and whether it is still in force.
- Issue panel. Record a decision with its reason, an optional link and an optional review date. Replace or withdraw it later; the history stays.
- Already decided elsewhere. Open an issue and the panel lists decisions in force on other issues that mention the same topic.
- Conflict hint. Saving a decision names the other issues with a decision in force on the same topic, so a contradiction is seen at once.
- Decision log. A project page with every decision in force, searchable, with a filter for decisions whose review date has passed.
- Rovo agent. Ask whether something was decided, or ask it to record a decision. Writes go through Rovo's confirmation card.
- MCP tools and a skill. find-decisions, get-decisions, record-decision and withdraw-decision are declared as
rovo:mcptools, with a SKILL.md that tells coding agents to check the ledger before they start work.
How we built it
Forge, Node 24 runtime: jira:issuePanel and jira:projectPage in UI Kit, rovo:agent with four action modules, rovo:mcp, rovo:skill, and jira:entityProperty. Decisions live in an issue property; the entity property module indexes the active decision text, so search is plain JQL and Jira's own permissions decide who sees what. The four actions are written once against a small injected Jira client and run in two places: in Forge functions for the agent, and in the browser for the panel and the project page. No external services and no egress.
Challenges (found by testing on a live site)
- An OR of wildcard text clauses returned nothing whenever the first clause had no match, which silently emptied the "already decided elsewhere" box. We removed wildcards and rely on Jira's own stemming plus a small stemmer for ranking.
- "refunds" did not match "refund" in our own ranking; the agent answered that nothing was recorded. Fixed with stem matching and a test.
- A second decision silently inherited the review date typed for the first one, because the form kept its state. The form is now its own component.
- A controlled UI Kit text field dropped characters while typing in the search box.
What we tested
- 17 automated tests: the pure logic, and the four actions against an in-memory Jira (including that decisions on issues the user cannot see never appear in search).
- On a live Jira site: recording from the panel, review-date validation, replace and history, the already-decided box, the conflict hint, the project page search, and the Rovo agent finding decisions and recording one through the confirmation card. Asked about refunds, the agent listed three decisions and pointed out that one contradicted the other two.
- Not yet tested: calling the MCP tools from an external agent, and the withdraw action through the agent.
Limits
- Matching is by key words and simple stems, not by meaning. "Refund" finds "refunds"; it does not find "money back". The conflict hint says two decisions share a topic, not that they contradict.
- An empty result means no recorded decision was found. It does not prove nothing was decided.
- The search index lags a few seconds behind a save.
What's next
Decisions from Confluence pages and meeting notes, a reminder when a review date passes, and links between a decision and the work that implemented it.
Links
- Code (Apache-2.0): https://github.com/ahmetilhanli/decision-ledger
Built with AI coding assistance (Claude Code). The video narration is an AI-generated voice. All issues in the demo are demo data.
Built With
- forge
- javascript
- jira
- mcp
- rovo
- ui-kit