cx-project

Figma ↔ Jira Sync

Connects a Figma design file to a Jira ticket and keeps both in sync as the design moves through phases. Manages cover updates, ticket description sections, and status transitions.

Sub-commands

cx-project init | review | ready | status

init

Connect a Figma file to a Jira ticket. Updates the Figma cover (title, ticket key, status badge) and appends a Design section to the ticket description.

review

Move a project to review phase. Updates cover to "IN REVIEW", changes Jira link to the Review page, transitions ticket to Awaiting Feedback.

ready

Mark as build-ready. Updates cover to "BUILD-READY", changes link to Build-Ready page, transitions ticket to Awaiting Devs.

status

Check current state of a project — ticket status, Figma link, last updated.

Design phases

🧠 Exploration → 🟡 In Review → ✅ Build-Ready

Each phase maps to a Figma page in the Design Handoff template and a Jira workflow status.

What it updates

Location	What changes
Figma Cover	Project Title, Ticket Key (hyperlinked), Status Badge
Jira Description	Design section with phase emoji + Figma page link
Jira Status	Transitions: In Progress → Awaiting Feedback → Awaiting Devs

MCP tools used

Figma Console MCP

Cover text updates, page navigation, status badge changes

Docs →

Atlassian Cloud MCP

Issue reading, description updates, status transitions, search

Docs →

Getting started

Before running cx-project init, prepare your Figma file:

Duplicate the Design Handoff template

Open the template in Figma and click the dropdown arrow next to the title → "Duplicate to your drafts". This gives you a personal copy with all pages pre-configured.

Open Template in Figma

Rename the file

Double-click the file name in Figma and rename it to match your project (e.g. "CX-4690 — Cashout Redesign").

Connect the Bridge Plugin

In your duplicated file: Plugins → Development → Figma Desktop Bridge. Wait for "Local · ready".

Run cx-project init in Kiro

The agent links the file to your Jira ticket, updates the cover, and sets the Figma link in the ticket description.

Prerequisites

Figma Desktop with Bridge Plugin (for cover updates)
Atlassian Cloud authentication (browser login on first use)
Figma file uses the Design Handoff template (Exploration, Review, Build-Ready pages)