ENGINEERING

Reconcile Figma rename against Storybook stories before merging the MR

On a Figma rename, checks whether the renamed component still has a matching Storybook story; if the story name drifted, it updates both the Code Connect mapping and the story…

CategoryEngineering
Enginesim
Difficultyadvanced
Triggerevent
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerFigma component renamedFigmaFigma
  • ActionRead Code Connect map for mapped sourceFigmaFigma
  • ActionSearch GitLab repo for matching Storybook storyGitLabGitLab
  • LogicStory drifted? continue; missing? alert and stop
  • ActionUpdate mapping in Figma and rewrite story titleFigmaFigma
  • OutputOpen GitLab MR with synced changesGitLabGitLab

What it does

Closes the loop between Figma names, Code Connect, and Storybook. When a component is renamed in Figma it verifies a Storybook story still maps to the code component; if the story title is now out of sync it rewrites both the story and the Code Connect mapping and opens a GitLab MR. If no story exists at all, it raises the gap instead of guessing.

When to use it

Use it when your design system treats Storybook as the source of truth for component documentation and renames must stay consistent across Figma, Code Connect, and stories simultaneously.

How it works

  1. 1A Figma rename event triggers the flow.
  2. 2Read the Code Connect map to find the mapped source file and component.
  3. 3Search the GitLab repo for the matching Storybook story.
  4. 4Branch: if a story exists but the title drifted, continue; if none exists, alert in Slack and stop.
  5. 5Update the Code Connect mapping in Figma and rewrite the story title in the repo.
  6. 6Open a GitLab MR with the synced story and mapping changes.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect FigmaFiles, frames, comments, assets.
  2. 2
    Connect GitLabRepos, MRs, pipelines, registry.
  3. 3
    Connect SlackChannels, DMs, threads, mentions.
  4. 4
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  5. 5
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  6. 6
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.