interview-me

A Claude Code skill that interviews you like a senior architect before you write code.

Why This Exists

When you're building alone, there's no one to challenge your assumptions. Requirements start as vague ideas, edge cases get discovered in production, and security concerns become afterthoughts.

interview-me is the senior architect you wish you had on the team. It reads your requirement, checks whether your existing code is even relevant (and asks before scanning it — or runs in greenfield mode if there's nothing yet), then asks hard questions one at a time — pushing back on contradictions, probing edge cases, and hard-blocking on security gaps. Outputs a production-grade markdown spec with decisions log and implementation order.

Optionally publishes a diagram-first spec preview as a shareable Claude Artifact — flow diagrams, an at-a-glance summary, and a dependency graph on a private claude.ai link you can share with teammates for review before finalizing.

Install

mkdir -p ~/.claude/skills/interview-me
curl -o ~/.claude/skills/interview-me/SKILL.md \
  https://raw.githubusercontent.com/Sorbh/interview-me/main/interview-me/SKILL.md
curl -o ~/.claude/skills/interview-me/STYLE_PRESETS.md \
  https://raw.githubusercontent.com/Sorbh/interview-me/main/interview-me/STYLE_PRESETS.md

Usage

/interview-me path/to/requirements.md
/interview-me "I want to build a user auth system with OAuth"

If this saves you from one bad architectural decision, consider giving it a star.

License

MIT