CUSTOMER SUPPORT

Draft a KB rewrite from the question that beat it

When a docs rewrite issue is opened in Linear, an agent reads the original article and the failing customer questions, drafts an improved version in Confluence.

CategoryCustomer Support
Enginepaperclip
Difficultyadvanced
Triggerevent
Steps5
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerLinear issue labeled rewrite-readyLinearLinear
  • ActionRead current article and failing questionsConfluenceConfluence
  • LogicIdentify content gaps the article failed to cover
  • ActionCreate proposed revision draft in ConfluenceConfluenceConfluence
  • OutputComment draft link and change summary on Linear issueLinearLinear

What it does

Turns a flagged failing article into a ready-to-review rewrite. Triggered by a rewrite issue, an agent reads the current Confluence article plus the real customer questions that escalated past it, identifies the gaps, and produces a revised draft that directly answers those questions while keeping the article's structure and voice.

When to use it

Use this once you have a stream of flagged articles and want to compress the time from "this article fails" to "here's a fixed draft." It does the first pass so a human editor reviews and approves rather than starts from scratch.

How it works

  1. 1A Linear webhook fires when an issue is labeled rewrite-ready in the Docs project.
  2. 2The agent reads the linked article from Confluence and pulls the failing questions captured on the issue.
  3. 3It analyzes what the article missed and drafts a revised version that addresses each unanswered question.
  4. 4The draft is created as a new Confluence page in a review space, marked as a proposed revision.
  5. 5The agent comments on the Linear issue with the draft link and a short summary of what changed and why.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect LinearIssues, projects, cycles, triage.
  2. 2
    Connect ConfluenceSpaces, pages, blueprints.
  3. 3
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  4. 4
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  5. 5
    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.