runbookify
← All plans
Facilities, Assets & IT Operations / Help Desk / Internal Ticketing

Knowledge Base & Ticket Deflection: Answer the Easy Questions Before They Become Tickets

An internal knowledge base that suggests the right how-to article while someone is typing a ticket — so the easy questions self-serve, the queue shrinks, and a content owner approves every article before staff ever see it.

BeginnerAn afternoonBuilds onNext.jsSupabaseResend
What you'll build

A web tool where staff search a searchable knowledge base and get suggested answers as they type a ticket, authors draft articles (with optional AI assist), a content owner reviews and approves before anything goes live, and you can see deflection stats and export the whole KB as CSV/Markdown.

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)
  • Your existing FAQ / how-to content (docs, a sheet, or pasted text) and your ticket categories
  • Claude Code or any AI coding agent

The problem this kills

Your help desk answers the same handful of questions over and over. How do I reset my badge? Where's the VPN guide? Who approves a new monitor? Each one is a thirty-second answer that still costs a ticket: someone opens it, someone triages it, someone replies, someone closes it. Multiply that by every "quick question" and your queue is full of things that never needed a human at all — while the genuinely hard tickets wait behind them.

The knowledge to answer most of these already exists. It's scattered across old docs, a shared drive, a wiki nobody updates, and the heads of your two most experienced agents. The trick isn't writing more documentation — it's getting the right answer in front of staff at the exact moment they're about to file a ticket, so they self-serve instead of joining the queue. You do not need to be a developer to build that.

What you'll build

A simple internal web tool with two faces. For staff: a fast search box and a ticket form that suggests relevant how-to articles as they type — show them the answer before they hit submit, and many won't need to. For your team: a place to import or write articles, send them through an approval gate, and watch which articles are actually deflecting tickets. Authors draft an article (optionally with AI assist that writes a first draft from your notes), a content owner reviews and approves it, and only then does it go live for staff. Every published article carries a review/expiry date so stale content gets flagged instead of quietly misleading people. And you get deflection stats — views versus tickets avoided — plus a one-click export of the whole KB as CSV or Markdown.

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 — your current help-desk process, where your existing FAQ content lives, your real ticket categories and their naming, your typical and peak ticket volumes, who is allowed to approve content, and the messy questions that trip people up today. It reads a short spec back to you for a thumbs-up, then builds the tool around your answers instead of a generic template. From there it walks the agent through the data model, importing your existing content, the author-and-approve workflow, the AI draft assist (with a mandatory human gate), the staff search and type-ahead suggestions on the ticket form, the deflection tracking, and the CSV/Markdown export. Every step ends with a ready-to-copy prompt.

The governance it includes (this is the point)

This isn't a toy wiki. The plan builds in the controls a real support function needs: login so only your team and staff can use it, row-level security so people only see their own organization's content, a complete audit trail of every draft, edit, approval, and publish (who, what, when), and a hard human-approval gate so nothing — including anything the AI drafts — goes live until a content owner reviews and publishes it. Add review/expiry dates so the KB stays fresh, and a duplicate guard on the article slug so the same article can't sneak in twice. The AI helps you write faster; a person always decides what staff actually see.

Who it's for

Help-desk leads, IT and facilities support teams, and internal comms or ops people who own the "where is the doc for this?" problem. If you can list the questions your team answers ten times a week, you can build this.

You've got this — open the plan, paste the first prompt, and you'll be deflecting your first repeat questions this 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.