interview-dev

Runs a full development loop with pre-implementation interviews and independent post-implementation code reviews.

Updated Sep 16, 2022
One-click install
npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill interview-dev-ryuya-matsunawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: interview-dev
Source: https://github.com/ryuya-matsunawa/dotfiles/tree/main/agents/.agents/skills/interview-dev
Command: npx skills add https://github.com/ryuya-matsunawa/dotfiles --skill interview-dev-ryuya-matsunawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial implementation tasks often fail because requirements are ambiguous and self-review misses real defects. This Skill enforces a disciplined loop: explore the codebase, ask only material questions, get plan approval, implement, then have an independent reviewer agent audit the diff until it is clean. ## Core Features & Use Cases - Material Ambiguity Interview: Asks 3-5 targeted questions (max 7), one at a time, only when the answer would change the implementation direction, each with a recommended answer. - Approval-Gated Planning: Produces a structured implementation plan covering changed files, steps, decisions, and verification checks, and waits for explicit user approval before coding. - Independent Review Loop: Launches a separate reviewer agent (up to 3 rounds) that inspects git diff HEAD and untracked files against project conventions, bug risks, and security concerns, then fixes all findings. - Use Case: When asked to add a new feature or fix a non-trivial bug, the Skill interviews you about approach, data handling, permissions, and rollout, implements the approved plan, and iterates with an independent reviewer until no issues remain. ## Quick Start Ask the assistant to implement a non-trivial feature or fix, or invoke it directly with /interview, and it will interview you, plan, implement, and self-review the code.

Frequently Asked Questions about interview-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use interview-dev to implement a new feature?▼

Invoke it with /interview or simply ask to implement, add, fix, or build something non-trivial. The Skill explores relevant docs and code, asks 3-5 targeted questions, presents a plan for approval, implements it, and runs an independent review loop until the diff is clean.

What kinds of questions does the pre-implementation interview ask?▼

It only asks questions whose answers would change the implementation direction, covering approach, data handling and migrations, permissions, visible behavior, verification, and rollout. Each question includes a recommended answer, and the total never exceeds seven.

How does the independent code review loop work?▼

After implementation, a separate reviewer agent is launched that fetches changes via git diff HEAD and lists untracked files, then checks for bugs, project convention violations, and security issues. Findings are fixed and the review repeats up to three times.

When should I not use this interview-driven development workflow?▼

Skip it for trivial changes where requirements are already unambiguous, since the interview and approval gate add overhead. It is designed for non-trivial tasks where no plan exists yet and implementation direction could go multiple ways.

What happens if the reviewer still finds issues after three rounds?▼

The loop stops after a maximum of three review rounds. Any unresolved findings are reported directly to the user so they can decide how to proceed rather than looping indefinitely.