runbookify
← All plans
Customer Support & Service / Knowledge Base & Macros

Ticket-to-KB Article Drafter: Turn Solved Tickets Into Reusable Docs

Take a resolved ticket thread and let AI draft a clean, on-brand KB article — problem, cause, step-by-step fix — with every customer detail stripped, then have an SME review and approve before it's marked publish-ready.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where you paste or import a resolved ticket thread, AI drafts a structured, PII-free KB article in your brand's voice, an SME edits and approves it, and the tool saves it as publish-ready with a markdown export plus a CSV for your knowledge-base tool.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.

Before you start

  • A Supabase account (free)
  • A Vercel account (free)
  • A Resend account (free)
  • A few resolved ticket threads (pasted or CSV)
  • One or two sample KB articles for tone and structure
  • Claude Code or any AI coding agent

The problem this kills

Your best agents solve genuinely hard problems every week. The fix lives in a closed ticket, in one person's head, and nowhere else. So the next agent hits the same issue, reopens the same investigation, and burns the same hours — while the customer waits for an answer that already exists.

Everyone agrees the team should document this stuff. Nobody has time. Writing a clean knowledge-base article from a messy ticket thread is real work: you have to figure out what the actual problem was, what caused it, the exact steps that fixed it, and then rewrite the whole thing in the brand's voice with every customer name, email, and account number scrubbed out. By the time you've done that, three more tickets are waiting. So the article never gets written, and the tribal knowledge stays tribal.

You don't need to be a developer to fix this. You can build a tool that does the first draft for you and keeps a human in charge of what actually gets published.

What you'll build

A simple internal web tool. You paste in a resolved ticket thread (or import a CSV of them) and point it at a sample article so it learns your structure and tone. The AI reads the thread, works out the problem, the cause, and the step-by-step fix, and drafts a clean KB article — with a single clear title and searchable keywords. Before you ever see it, the tool aggressively strips personal details: customer names, emails, phone numbers, account and order numbers, anything that shouldn't live in a public help doc.

Then the important part: an SME (subject-matter expert) reviews the draft, edits anything the AI got wrong, and clicks Approve. Only then is the article marked publish-ready. The tool exports it as markdown and as a CSV in the columns your knowledge-base tool expects, so you can publish it wherever your docs live. Each article is keyed to its source ticket ID, so the same thread can't quietly get turned into two articles.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — which help desk you use, how your ticket threads are shaped and named, what your KB articles look like today, your brand voice rules, which personal details must always be removed, and your messy edge cases — and then it tailors the data model, the redaction rules, and every later step to your answers. This is not a generic template; the agent reflects a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through importing or pasting threads, the PII-stripping pass, the AI drafting step that matches your sample article, the SME review-and-approve screen, and the markdown + CSV export — each step with a ready-to-copy prompt. There's also a fallback so you can build the whole thing today even with no API to your help desk.

The governance it includes (this is the point)

This tool touches real customer conversations, so it ships with the controls a support org needs: login so only your team can use it, row-level security so you only ever see your own organization's tickets and drafts, a complete audit trail of who drafted, edited, and approved which article and when, a hard human-approval gate so nothing is marked publish-ready until an SME signs off, and duplicate guards keyed on the source ticket ID so the same thread can't be turned into two articles. PII redaction runs before a human ever reads the draft, and approval is blocked until the SME confirms the article is clean.

Who it's for

Senior agents, team leads, and SMEs who solve the hard problems but never have time to document them — plus knowledge managers who are tired of nagging people to write articles that never get written. If you can describe what a good article looks like in your shop, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll watch your first solved ticket turn into a clean, publish-ready article the same afternoon.

Gated download

Enter your email — the plan downloads instantly and a copy lands in your inbox.

By submitting your email you'll also receive the weekly runbookify newsletter. You can unsubscribe at any time.