FREE RESOURCE · OPEN SOURCE · MIT
/interview is a Claude Code skill that runs a London-ad-agency-depth discovery interview, drills every facet of what you're about to make, turns your answers into a complete spec — then keeps the build safe. Free. Installs in 60 seconds.
Wraps GitHub Spec Kit · works for code and non-code projects
WHY IT EXISTS
You ask one question, you build the wrong thing. The moment you start coding something you haven't fully thought through, every hour after that is at risk.
A senior agency lead doesn't take a brief at face value — they drill “and what does that actually mean?” until there's nothing left to abstract. /interview makes your AI do exactly that — then writes the spec, then keeps the build safe.
HOW IT WORKS
The first thing it asks: what are you building, and how heavy is it? From there it runs a structured discovery and ends with a complete spec.
Code or non-code? QUICK, STANDARD, or FLAGSHIP? The weight sets how deep it drills and how much it stops to check.
It pulls existing context first, then confirms its assumptions instead of re-asking — so the time goes into drilling deeper.
Intent, scope, users, data, systems, constraints, don't-dos, risks, future, success metrics — scaled to the project's weight.
It restates the brief — goal, scope in and out, don't-dos, success criteria — and won't build until you say “yes, that's it.”
constitution.md, spec.md, plan.md, tasks.md — written from your answers, wrapping GitHub Spec Kit for code projects.
It builds as far as the stakes allow — QUICK builds all the way, FLAGSHIP stops at spec + plan for your sign-off.
The more it matters, the more it stops and checks. The lighter it is, the more it just builds.
WHAT YOU GET
14 facets, scaled to the project's weight, with an explicit readback gate so nothing gets built until you confirm it.
constitution.md, spec.md, plan.md, tasks.md. Paste them into a repo, hand them to an agent, or keep them as source of truth.
A tiered control system (Inviolable → Defaults → Preferences) that makes irreversible harm hard. Every rule carries its — Why:.
On Claude Code: hooks + CI so “never commit a secret” and “never DROP TABLE without a backup” are gates, not hopes.
INSTALL IT
The Claude Code track gives you auto-triggering and real enforcement. The chat track needs nothing but copy-paste.
# 1. Clone the kit
$ git clone https://github.com/billy-mangaroa/interview-kit.git
# 2. Drop the skill into Claude Code
$ cp -r interview-kit/claude-code/skills/interview ~/.claude/skills/
# 3. In any project, run it
> /interview
Want auto-triggering on new projects, secret-scanning, and destructive-command guards? The full wiring (hooks, Spec Kit, branch protection) is in INSTALL.md.
No setup needed. Open the prompt, copy it, paste it into a new conversation in Claude, ChatGPT, or Gemini, and answer. At the end it outputs your four spec documents as text.
Get the copy-paste promptUSE IT EFFICIENTLY
Calling a real project QUICK skips the readback and lets it build the wrong thing fast. Match the weight to the stakes and let the depth follow.
It surfaces its assumptions before asking. Confirm or correct in one pass instead of re-explaining — that's where the saved time turns into deeper drilling.
The restate-the-brief step is where you realise what you actually meant. Push back hard here — a mismatch now saves a rebuild later.
Run the chat track, get the four documents, and hand them over: “build this, follow the constitution.” No more lossy back-and-forth.
Even without an interview, the safety constitution + enforcement (secret-scanning, backup-before-migrate, destructive-command confirmation) prevents the most common solo-dev disasters.
Interview yourself first. Get the brief right, get the spec out, and build with the guardrails on. Free and open-source.
MIT-licensed · Wraps GitHub Spec Kit · Built by Build With Billy