Job Safety Analysis (JSA) Builder
Build a tool that turns one-off safety paperwork into a consistent, searchable JSA library — break a task into steps, list hazards, rate the risk, assign controls, route it through an EHS approval, and publish a printable JSA.
A login-protected JSA library where supervisors draft a Job Safety Analysis, the tool computes the risk rating, an EHS lead approves it, and you publish a versioned, printable JSA — with a full audit trail.
Before you start
- A free Supabase account
- A free Vercel account
- A free Resend account
- Your current risk matrix (severity x likelihood) and a sample JSA or two
The problem this kills
Job Safety Analyses live everywhere except where you need them. One is a Word doc on a supervisor's desktop, another is a PDF in an email thread, a third is a laminated sheet taped to a machine that nobody has updated since the last line change. When an auditor, a new hire, or an incident investigator asks "show me the current JSA for this task," you spend an afternoon hunting — and half of what you find uses a different risk scale, skips controls, or was never actually reviewed by anyone qualified.
The result is inconsistent risk ratings, hazards that get missed because there's no standard way to walk a task step by step, and "approved" JSAs that nobody actually approved. That's exactly the gap an auditor writes you up for.
What you'll build
A single, login-protected web tool where a supervisor breaks a job into steps, lists the hazards on each step, and assigns the controls — and the tool does the risk math for them using your risk matrix. When the draft is ready, it routes to an EHS lead who reviews and approves (or sends it back). Only then does it publish as a numbered, dated, versioned JSA that anyone on the team can find, print, and use for training and work authorization. Change a control next quarter? It creates a new revision and keeps the old one for the record.
What's inside the Implementation Plan
The plan is a runbook you paste into an AI coding agent (Claude Code), which builds the tool with you step by step — no coding background needed.
It opens by interviewing you about your business so the tool fits how you actually run safety, not a generic template. It asks about your current JSA process, your exact risk matrix (the severity and likelihood scales and the labels you use), your task and equipment naming, your approval rules, and the messy exceptions — then shapes the data model, the risk calculation, and every later step around your answers. You confirm a short spec before anything gets built.
From there it walks you through: setting up the database and login, building the step-by-step JSA editor, wiring up your configurable risk matrix, the EHS approval gate (with extra approval for high residual-risk tasks), publishing and versioning, the printable JSA, and the CSV import/export fallback so it works even before you connect any other system.
The governance it includes (this is the point)
- Login so only your team can open the tool.
- Row-level security so each site or organization only sees its own JSAs.
- A human-in-the-loop approval gate — a supervisor drafts, an EHS lead reviews and approves, and only an approved JSA gets published. High residual-risk tasks get flagged for an extra approval.
- Versioning — every change creates a new revision, and the old one stays on the record.
- A complete audit trail — who drafted, who approved, what changed, and when.
- Duplicate guards — the same task + revision can't be published twice.
Who it's for
EHS coordinators, production supervisors, and safety committees who own job safety analyses and are tired of chasing scattered documents — and who want one consistent, reviewable, auditable library that holds up when someone asks to see it.
You've got this — paste the first prompt and let the agent interview you.