runbookify
← All plans
Compliance, Quality & Risk / CAPA (Corrective / Preventive Action)

8D Problem-Solving Report Builder

Build your own guided 8D tool that walks a customer complaint from D1 (team) through D8 (closure) - the AI drafts each discipline's narrative from your team's notes, and your quality lead approves every step before the report goes to the customer.

IntermediateA weekendBuilds onNext.js (App Router) on VercelSupabase (Postgres, Storage, Auth + RLS)Resend (email to the customer contact + overdue alerts)
What you'll build

A login-protected internal tool where your team opens an 8D for a customer complaint, works D1-D8 with AI-drafted narratives, has the quality lead approve each discipline, finalizes the report, emails it to the customer contact, and exports a customer-ready PDF plus an internal CSV log.

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 free Supabase account
  • A free Vercel account
  • A free Resend account (with a sending domain you can verify)
  • Your current 8D template or a handful of past 8D reports to model the wording on
  • A spreadsheet or list of open complaints/returns (optional - you can start fresh)

The problem this kills

A customer files a complaint or sends back a defective lot, and the clock starts. They want an 8D - the eight-discipline problem-solving report - and they want it fast: an interim containment response in 24 to 48 hours, then a full root-cause and corrective-action report behind it.

So your quality engineers reach for the same tired Word template. They copy last quarter's 8D, fight the formatting, chase the team for notes over email, paste containment actions into the wrong box, and somehow ship a report that says "permanent corrective action implemented" while D3 containment is still blank. The root cause in D4 has nothing to do with the fix in D5. Three complaints are open, two are overdue, and nobody can tell you which.

It's not that your engineers don't know 8D. It's that the tool is a blank document, and a blank document has no memory, no rules, and no idea who approved what.

What you'll build

A small internal web app - one you build yourself this weekend by pasting a plan into an AI coding assistant - that runs the whole 8D the way it's supposed to run:

  • Open an 8D from a customer complaint or return, with the complaint number as the unique key.
  • Walk D1 through D8 as guided steps. Your team drops in rough notes for each discipline; the AI drafts a clean, customer-ready narrative in your house wording.
  • The tool enforces the order that matters: containment (D3) before you're allowed to claim permanent corrective action (D5), and it ties the D5 fix back to the D4 root cause so they can't drift apart.
  • Your quality lead reviews and approves each discipline. Nothing is "done" because the AI said so - it's done because a person signed off.
  • Finalize the 8D, email it to the customer contact through your own domain, and export both a polished PDF for the customer and a CSV row for your internal log.
  • Overdue interim responses get flagged, so a 48-hour containment commitment never quietly slips.

What's inside the Implementation Plan

The plan is a single file you paste into your AI coding assistant. It builds the tool step by step, and each step ends with a ready-to-copy prompt.

The best part comes first: the plan opens by interviewing you about your business. Before it writes a single line of code, the AI asks how your quality team actually works today - what your complaint numbers look like, which customers demand which 8D format, your containment-response deadlines, whether your root-cause method is 5-Whys or fishbone or both, and the messy exceptions you hit in real life. It reads back a short tailored spec, you give it a thumbs-up, and only then does it build. You get a tool shaped around your 8D process - not a generic template with your logo slapped on.

Inside you'll find:

  • The discovery interview that tailors the data model and wording to your shop.
  • A clean step-by-step build: database, login, the D1-D8 workspace, AI drafting, the approval gate, email-out, and PDF + CSV export.
  • The governance baked in from the start (below).
  • A "How to know it works" checklist and a no-integration fallback so you can build it today using a spreadsheet or CSV as your data source.

The governance it includes (this is the point)

This isn't a toy. The plan builds in the controls a quality system actually needs:

  • Login so only your team can open it.
  • Row-level security so each organization only ever sees its own complaints and 8Ds - never another customer's or another site's.
  • A complete audit trail: who drafted, who edited, who approved each discipline, and exactly when.
  • A hard human-in-the-loop approval gate: the AI drafts every narrative, but the quality lead reviews and approves each discipline and the final 8D before anything is issued to the customer. The AI proposes; the human owns the content.
  • Duplicate guards keyed on the complaint / 8D number, so the same complaint can't spawn two open reports.
  • Process rules enforced: containment (D3) before permanent action (D5), and root cause (D4) tied to the corrective action (D5).

Who it's for

Supplier-quality and manufacturing-quality engineers who respond to customer complaints and returns with a required 8D - and the quality leads who have to sign off on every one. If you live in IATF / automotive, aerospace, medical-device, or any supplier scorecard world where 8Ds are a fact of life, this is for you. No coding experience needed: you'll describe your process, and the AI builds the tool around it.

You've got this. Paste the first prompt and let's build it.

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.