api
Use to derive the API contract for a feature — an OpenAPI 3.1 document at docs/features/{slug}/contracts/openapi.yaml plus a…
Clarify and stress-test an engineering idea before roadmap or specification. Use for a product, feature, or technical change whose problem, outcome, scope, or key assumptions are unsettled: "interview {slug}", "idea brief", "stress test this idea", "/sdd:interview {slug}", "бриф
$ npx -y skills add genkovich/sdd --skill interview --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/interviewContext preview
The summary Claude sees to decide when to auto-load this skill.
Clarify and stress-test an engineering idea before roadmap or specification. Use for a product, feature, or technical change whose problem, outcome, scope, or key assumptions are unsettled: "interview {slug}", "idea brief", "stress test this idea", "/sdd:interview {slug}", "бриф
name: interview
model: inherit
effort: high
agents: [researcher, devils-advocate]
description: >
Clarify and stress-test an engineering idea before roadmap or specification. Use for a product,
feature, or technical change whose problem, outcome, scope, or key assumptions are unsettled:
"interview {slug}", "idea brief", "stress test this idea", "/sdd:interview {slug}",
"бриф ідеї", "розбери цю ідею", "погрилити ідею". Reuses existing context, adapts questions
to uncertainty, checks decision-changing facts, and requests independent critique when risk
warrants it. Returns a short brief with decisions, evidence, unknowns, and a justified next
step. Does not implement code, design the architecture, or write specify's detailed requirements.Turn an unsettled engineering idea into a **traceable decision**: what problem to address, for whom, within which constraints, and what evidence is still needed. One interviewer owns the conversation; optional helpers research or critique a bounded question, never interview the user.
Brief prose follows `artifact_language`; headings/tokens stay stable per [`../_shared/artifact-language.md`](../_shared/artifact-language.md).
The idea owner supplies intent and tradeoffs. Read their message, supplied ticket/links, any existing `docs/idea-brief.md`, and relevant project instructions/map. Use the current conversation as input: never ask the person to repeat an answer already given. A slug is optional; reuse or propose one without spending a question unless identity is ambiguous.
Primary scope: product, feature, technical change. An already actionable bug belongs to `fix`; an already settled feature can go to `specify`. For a non-engineering idea, explain the scope and offer a general discussion; do not force it through engineering checks or overwrite a project brief.
needs an answer. Pre-filled examples and a simulated person's choices are not actual user answers.
uncertain identity → ask how it relates; do not merge or replace it silently.
Resolve the question ceiling from explicit `--depth=easy|medium|hard`, else saved `interview_depth`, else `medium`. No opening depth-selection question. The adaptive interview exception and ceilings live in [`../_shared/interview-depth.md`](../_shared/interview-depth.md). State the ceiling and the current reason for research/critique in one short line. Stop early when the decision is clear; depth never forces research or a quota of questions.
Ask **one substantive question at a time**, adapting to the answer. Use choices for decisions and open text for facts/experience; recommend a decision only when its basis is clear. The interview-specific exception in [`../_shared/ask-style.md`](../_shared/ask-style.md) overrides its generic long-menu requirements. Use the host's actual question channel per [`../_shared/tool-adapters.md`](../_shared/tool-adapters.md). Research tools cannot answer for the owner.
Evidence classes: **owner-reported**, **source-verified**, **assumption**, **unknown**. Agreement with a recommendation is a decision, not independent evidence for its factual premises. Never turn a hypothetical failure signal into an observed incident. Keep sources and limits visible.
1. **Gather context.** Apply the gates above. Preserve the raw idea verbatim. Classify product / feature / technical change. Read supplied material, the existing brief, instructions, and a relevant architecture map. Use scoped code reading to answer a named question; do not run a full `survey` or scan unrelated areas. List known facts and consequential unknowns. 2. **Choose the next useful question.** Owner intent/tradeoff → ask. Discoverable fact → inspect or research. Unknown requiring new observations → name an experiment/data source. Prioritize answers that can change direction, scope, or whether to proceed. Probe concrete problems, affected actors, observable outcomes, constraints, non-goals, and existing workarounds. **Write as you go** ([`../_shared/write-and-commit.md`](../_shared/write-and-commit.md)): when the gates allow writes, after the **first real owner answer** copy [`templates/idea-brief.md`](templates/idea-brief.md) to `docs/idea-brief.md` (§1 = raw words, `status: Draft`), then write each section as soon as its content settles. Same-idea existing brief → patch the changed section in place; a different or uncertain idea is never written over before the owner says how it relates. No-write mode → the gates above win, nothing lands. 3. **Check decision-changing facts.** Follow [`references/research.md`](references/research.md): local evidence first, primary external sources when needed; use `sdd:researcher` in explicit `fact-check` mode for a bounded gap. Inspect its evidence before relying on it. Return to step 2 only for a new decision or contradiction, not to repeat an answered question. 4. **Stress-test the direction.** Select fitting lenses from [`references/probing-frames.md`](references/probing-frames.md). Include existing contracts, reversibility, operational ownership, and how success/failure will be observed. Consequential access/data/public-contract changes, hard-to-reverse commitments, or an explicit stress-test request → `sdd:devils-advocate` in explicit `interview` mode, at most three grounded findings. The helper sees the raw idea, acce
A self-contained Claude Code plugin that carries a feature from a one-line idea to reviewed, verified, shipped code through 23 atomic, stack-agnostic skills and a TDD implementation engine — with a living decomposition roadmap above the per-feature flow and a
Use to derive the API contract for a feature — an OpenAPI 3.1 document at docs/features/{slug}/contracts/openapi.yaml plus a…
Use to run an ambiguity sweep over a written spec.md and close every under-specified point before planning or design proceeds —…
Use to classify a feature into XS/S/M/L/XL and write docs/features/{slug}/.size plus the pipeline route…
Use to create and tune the per-project settings file `.claude/sdd.local.md` — the one place that decides how deeply the pipeline…
Use to design the data model AND generate the actual forward + rollback migrations in one pass — shippable SQL, not a plan.…
Use to record a post-hoc or asynchronous architecture decision as a MADR ADR when it was NOT captured during the synchronous…