Documentation
Product
Jira Backlog

Jira Backlog

What it is

The Jira Backlog is a Jira-style work item system embedded inside every board. It allows PMs to generate, edit, and review a structured backlog without leaving the board context.

Work items and sticky notes coexist on the same board — notes capture thinking and research; work items capture the deliverable scope.

Accessing the backlog

Click the Jira Backlog tab in the left sidebar. The tab shows:

  • A table of all work items
  • The AI generation action bar at the top
  • A context panel showing sticky notes for AI generation reference

Work item structure

FieldDescription
KeySequential identifier (e.g. EPIC-001, STORY-003)
Typeidea, discovery, prototype, epic, story, task, subtask, or bug
SummaryOne-line title
DescriptionDetailed Markdown body
Statustodo, in_progress, in_review, done, or cancelled
Priorityhighest, high, medium, low, or lowest
ParentHierarchy link (epics contain stories; stories contain tasks)
Acceptance criteriaChecklist items (can be marked complete)
No-gosExplicit out-of-scope constraints
DependenciesLinks to blocking or blocked-by items
Source notesLinks back to the sticky notes this item was derived from

AI generation workflow

Work item generation follows a multi-step hierarchy:

StepTypes generated
1Ideas
2Discoveries
3Prototypes
4Epics and Stories
5Tasks and Subtasks

Click Generate [next step] in the Jira Action Bar to generate the next missing tier. The AI uses your sticky notes as context.

You can also:

  • Regenerate selected items — improve specific items by selecting them and clicking Regenerate.
  • Generate children — decompose a selected parent item into child items.

Editing work items

Click any work item row to open it in the full-screen Work Item Editor — a TipTap WYSIWYG editor with:

  • Structured sections (Description, Acceptance Criteria, No-gos)
  • Inline AI suggestions via @subagent annotation buttons
  • Text selection toolbar for field-level AI rewrite

Changes are debounced (800ms) and flushed on editor close — so edits don't generate a network request on every keystroke.

Inline AI review

Click Review Project in the Jira Action Bar to run AI analysis across all work items and sticky notes simultaneously. The AI:

  • Identifies gaps, inconsistencies, or missing acceptance criteria
  • Injects inline suggestions as @subagent blockquotes in the work item editor
  • Each suggestion has action buttons to accept, rewrite, or dismiss

Syncing work items

Work items are synced to D1 via the same push pipeline as notes. They are included in the jiraItems field of the sync payload. Soft deletes use deletedAt timestamps.

Hierarchy and key format

TypeKey prefixExample
IdeaIDEAIDEA-001
DiscoveryDISCDISC-001
PrototypePROTOPROTO-001
EpicEPICEPIC-001
StorySTORYSTORY-001
TaskTASKTASK-001
SubtaskSUBSUB-001
BugBUGBUG-001

Keys are assigned sequentially per type within a board. Deleted items' keys are not reused.

See also