interview-me
Reading as

You: I want a weekly digest email for our app. You know what I mean.

I can’t read your mind. So let me ask.

interview-me is a skill for your coding agent. It asks one question at a time until it can say your idea back and you answer “that’s right.” Then it writes the brief and builds.

npx interview-me install

Adds one skill folder for each agent you use. npx interview-me uninstall removes it.

Your turn. Answer as if it were your idea.
Question 1: What's the real challenge: what do people miss today?

  1. Read src/emails/. You already send receipts with React Email, so I'll build on that.

    Question 1 of 3: What's the real challenge: what do people miss today?

    Pick one. Nothing happens for a few seconds if you don’t.

A guess costs more than three questions.

Without

  1. You describe it in two sentences.
  2. The agent builds straight away.
  3. It’s confident, polished, and not what you meant.
  4. You spend an hour explaining what you could have said up front.

With interview-me

  1. You describe it in two sentences.
  2. The agent reads what’s there, then asks what it can’t know.
  3. You answer, mostly with one click, until it says it back right.
  4. It builds from a brief you’ve confirmed.

Every interview ends in a brief.

It covers six things, broad to specific, and skips anything you’ve already answered. It stops when it can explain your idea to a stranger and you’d agree. Say “just go” and it writes the brief with the gaps marked as assumptions.

The highlighted lines are yours. Everything in the brief comes from your answers.

Brief: weekly digest

docs/briefs/weekly-digest.md
Core

The agent asks: Who is it for, and what changes for them?

A short Monday email showing teammates what they missed.

The real challenge

The agent asks: What's the real challenge here for you?

Teammates' work gets buried under notifications.

Picture

The agent asks: Walk me through the last time this got in your way.

Monday, 9am, coffee. One scroll and you're caught up.

References

The agent asks: What's the closest thing out there?

A good changelog: short, visual, one image.

Edges

The agent asks: If you say yes to this, what are you saying no to?

Never sent on quiet weeks. Never longer than one screen.

Success

The agent asks: How will you know, within ten seconds, that it's right?

People reply to it instead of archiving it.

Not just features. Anything you can’t quite say yet.

Designs, APIs, data models, writing, pricing, research, hard decisions. Each kind of problem gets its own questions on top of the six. With no filesystem, it works in any chat and puts the brief in its reply.

Built from five books on asking good questions.

Each one changed what the agent asks. Pick a book to see the exact questions it puts into the skill. Quotes are only used where we could verify them word for word; full citations are in sources.md.

Book 1 of 5. Use the arrow keys or tap a spine.

Rob Fitzpatrick, 2013

The Mom Test

You want facts and commitments, not compliments.

What the agent does with it

  • Past over future

    Instead of: Would you read a weekly digest?

    It asks: When did you last miss something a teammate shipped?

  • Dig under the feature

    Instead of: Which filters should it have?

    It asks: What would filters let you do that you can't do now?

  • Don't pitch

    Keeps its own ideas back until the brief is confirmed.

You: Next time my idea is fuzzy, interview me first.

Install it once, and it’s there when you need it.

npx interview-me install

Finds the agents you use and adds an interview-me folder to each one's skills folder. Add --global for every project.

npx interview-me uninstall

Removes those folders again. Nothing else is touched.

Works with

Claude Code Codex CLI Cursor GitHub Copilot Gemini CLI OpenCode Grok Build Hermes Agent Pi Antigravity