interview · jarrodwatts — Claude Code command: what it does, how to install
interview runs a long question-and-answer session about a plan file and writes the finished spec back to the same path.
no license ★ 1,064 updated 2026-01-21
.claude/commands/interview.mdWhat interview does
The command opens a plan file and starts asking you questions through AskUserQuestion. It digs into implementation choices, interface details, risks and tradeoffs, and skips the obvious ones. When nothing is left open, it rewrites that file as a finished spec.
One markdown file holds the prompt and the tool list: AskUserQuestion, Read, Glob, Grep, Write, Edit. No shell there, so it will not run your build or test suite. It reads files and edits them. You hand it the plan path as the argument, and that path goes straight into the prompt.
The output lands in the file it read. Keep the earlier draft in git or as a copy, because the original gets overwritten.
What it helps with
- turn a rough plan into a spec before coding starts
- surface tradeoffs you had not considered
- fill gaps in a UI flow description
- ask the awkward questions early
- end up with one spec file instead of scattered notes
Example prompts for the agent
- Run
/interview plans/checkout.mdand keep asking until the plan is airtight. /interview docs/auth-plan.md— push me on the edge cases.- Use
/interview plans/import.mdand save the result back to the file.
How to install interview
Manually: put the files in place
.claude/commands/interview.mdCall it with /interview. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/interview.mdCall it with /prompts:interview. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/interview.prompt.mdManually: put the files in place
.gemini/commands/interview.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about interview
How do I install interview in Claude Code?
Add the command file at .claude/commands/interview.md inside your project.
What does interview do?
It reads a plan file, asks detailed non-obvious questions with AskUserQuestion, then writes the revised spec back to the same file.
Which tools can the command use?
AskUserQuestion, Read, Glob, Grep, Write and Edit. There is no shell, so it will not run builds or tests.
Similar slash commands
All slash commands for Agent setup: memory, context, orchestration →interview by other authors comes first.