claude-spec-interviewer

Transform Claude Code requests into detailed specs with ADRs and validation plans.

4|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/stark-ai-de/agent-skills --skill claude-spec-interviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-spec-interviewer
Source: https://github.com/stark-ai-de/agent-skills/tree/main/skills/claude-operations/claude-spec-interviewer
Command: npx skills add https://github.com/stark-ai-de/agent-skills --skill claude-spec-interviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill turns rough Claude Code coding requests into precise implementation specs, complete with architectural decisions and validation plans.

Core Features & Use Cases

  • Interview and Spec Creation: Guide users through defining their requirements, challenges, and assumptions to produce a clear implementation spec.
  • Architectural Decision Records (ADR) Integration: Automatically propose and integrate ADRs for durable decisions when needed.
  • Validation and Rollout Planning: Outline validation commands, rollout strategy, and rollback plans.

Quick Start

Use the /claude-spec-interviewer command to initiate the spec creation process for a new project.

Frequently Asked Questions about claude-spec-interviewer

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

FAQPage Schema
How do I create implementation specs for Claude Code requests?

Implementation specs for Claude Code are created by guiding users through structured interviews to define requirements, challenges, and assumptions. The resulting spec includes architectural decisions, validation plans, and execution prompts.

When do I need architectural decision records for my coding project?

Architectural decision records (ADRs) are needed when implementing durable decisions that impact long-term project structure. They are automatically proposed and integrated into your implementation spec to document these architectural choices.

Does the spec interviewer work without existing repository documentation?

The spec interviewer requires repo-local AGENTS.md, CLAUDE.md, .claude/rules, and project documentation to function. It relies on these existing configurations to persist specs and ADRs following repository conventions.

How do I plan validation and rollback strategies for Claude Code implementations?

Validation and rollback strategies are planned by outlining specific validation commands, rollout strategies, and rollback plans directly within the generated implementation spec during the structured interview process.

What is Plan mode for structured spec interviews?

Plan mode for structured spec interviews is a feature that guides users systematically through defining requirements, challenges, and assumptions to produce clear, actionable implementation specifications.