Product
Break a spec into Linear issues
Share a Notion spec with Merlin in Slack and get it split into Linear issues. Each issue covers one piece of work with acceptance criteria, listed in build order.
@Merlin from now on, when someone in #product shares a Notion spec and asks you to break it down, split it into pieces of work that can each be reviewed on their own. Create one issue per piece in the Product team's backlog with acceptance criteria and a link to the spec, without assigning anyone. Reply with the issues in the order they should be built, and list any part of the spec that is too vague to file.
- Starts whenA PM asks
@Merlinin#productto break down a spec and pastes the Notion link Merlin worksClaude Code or Codex reads the spec through Notion's MCP and splits it into pieces of work that can each be reviewed on their own
- You getOne Linear issue per piece with acceptance criteria, and the issues in build order in the thread
Tools
- Slack
- Notion
- Linear
Capabilities
- Integrations
- Your agent's MCP
How it works
From a Notion spec to Linear issues in build order.
Mention
@Merlinin#product, paste the Notion link and ask for a breakdown. Teammates can say where to cut in the same thread.Claude Code or Codex reads the spec through Notion's MCP and splits it into pieces of work that can each be reviewed on their own.
One issue per piece lands in the Product backlog with acceptance criteria and a link to the spec, unassigned. The reply lists them in build order, plus anything too vague to file.
Mention @Merlin in #product, paste the Notion link and ask for a breakdown. Teammates can say where to cut in the same thread.
Claude Code or Codex reads the spec through Notion's MCP and splits it into pieces of work that can each be reviewed on their own.
One issue per piece lands in the Product backlog with acceptance criteria and a link to the spec, unassigned. The reply lists them in build order, plus anything too vague to file.
Acme
Channels
general
eng
product
support-eng
data
finance
it-help
legal
Direct messages
Merlin
Nina
Omar
product
24
Today
Nina11:20
@Merlin can you break the bulk invites spec into issues? notion.so/acme/Bulk-invites-4f2a
Message #product
Before and after
A finished spec turns into a backlog the team can pick up.
Without Merlin
A PM rereads the spec, cuts it into pieces and retypes each one into Linear.
- 01Reread the spec
- 02Cut it into pieces of work
- 03Ask an engineer where to split it
- 04Create the first issue
- 05Copy its acceptance criteria
- 06Copy the spec link
- 07Repeat for four more issues
- 08Put them in build order
- 09Post the list in #product
With Merlin
One mention gets the spec filed as issues, in order, while the team is still in the thread.
@Merlinin#productwith the spec linkAsked by the PM in SlackReads the spec and splits itClaude Code with Notion's MCP
- One issue per piece, in build orderUnassigned, with acceptance criteria
Setup
Add Merlin to #product, connect Linear and give your agent Notion.
Set these up once and anyone in #product can hand Merlin a spec. The issues land unassigned, so the team still decides who builds what.
- 01Connect a machineRuntimeInstall the Merlin desktop app or CLI on a computer running Claude Code or Codex. You can also use a machine a teammate shares with your workspace.
- 02Add Merlin to SlackIntegrationsInstall the Slack app and add Merlin to the channel you work in. A private channel needs
/invite @Merlin. - 03Add Notion to your agentYour agent's MCPConnect the Notion MCP server to Claude Code or Codex on the machine that runs this. Its credentials stay on that machine.
- 04Connect LinearIntegrationsOnce you connect your Linear workspace, Merlin can read the linked issue and comment there too.
- 05Ask from a machine that can open the specRuntime
Merlin picks your own machine first, so the spec is read with your Notion sign-in. A shared machine can only read the pages its owner can open in Notion.
- 06Paste the setup promptGuidanceAn owner or admin sends the prompt below to @Merlin once, and it becomes workspace guidance for every future run.
Prompt
Tell Merlin how to break down a spec once.
@Merlin from now on, when someone in #product shares a Notion spec and asks you to break it down, split it into pieces of work that can each be reviewed on their own. Create one issue per piece in the Product team's backlog with acceptance criteria and a link to the spec, without assigning anyone. Reply with the issues in the order they should be built, and list any part of the spec that is too vague to file.
Once, when you paste it
- PromptYou paste the prompt to @Merlin
- GuidanceMerlin saves your rules as workspace guidance
Every time someone mentions Merlin in Slack
- IntegrationThe Slack app spots the mention
- RuntimeMerlin picks an available machine
- ContextThe run gathers context
- WorkClaude Code or Codex reads the spec through Notion's MCP
- SteeringYour team steers the work in the thread
- ResultMerlin files the issues and lists them in order
Related use cases
More tasks you can hand to Merlin.
- Integrations
Product
Write a spec from a rough Linear issue
Delegate a rough idea in Linear to Merlin and get a spec written into the issue. It covers the problem, how the product works today, a proposal and acceptance criteria.
Rough issue delegated to MerlinA spec in the issue description - Integrations
Engineering
Build a small feature from a Linear issue
Delegate a small, clear feature to Merlin in Linear. It builds it with tests on a teammate's machine and links the pull request on the issue.
Feature issue delegated to MerlinPull request with tests, linked on the issue - Integrations
Product
Check a pull request against its spec
Mention Merlin on a pull request to check it against the Linear issue it closes. You get a comment that says which acceptance criteria pass and which don't.
@usemerlin-aiin a pull request commentA pass or fail comment per criterion
Bring your coding agents into the tools your team already uses.
Let your whole team hand work to Claude Code and Codex today. Connect one machine and add Merlin to Slack, Linear or GitHub. 14-day free trial, no API keys, no card.