interview-openspec_skill

Overview

This skill conducts a phased Socratic interview to produce OpenSpec artifacts incrementally. It guides you from an initial proposal through specs, design, and implementation tasks, letting you stop after any phase. The skill enforces safety checks and artifact templates so outputs match OpenSpec conventions.

How this skill works

When invoked it prompts you to name the change (or derives a kebab-case name from your input) and initializes a change record with openspec commands. It runs four interview phases: proposal, capability specs, design, and tasks, asking concise multiple-choice questions and writing each artifact using OpenSpec instructions or fallback templates. It detects high-risk operations and requests explicit authorization before proceeding.

When to use it

• Starting a new OpenSpec change that needs structured requirements elicitation.
• When you need a clear, phased output: proposal.md, spec.md, design.md, and tasks.md.
• If multiple stakeholders must converge on goals, scope, and risks before implementation.
• When you want machine-friendly artifacts aligned to OpenSpec tooling and review workflows.

Best practices

• Answer the Socratic prompts in the order presented to preserve context and artifact traceability.
• Provide concrete examples and priorities when selecting options to get more actionable specs.
• Use the built-in risk prompts and authorize explicitly for high-risk items; do not skip safety checkpoints.
• Keep capability names short and kebab-case; the skill derives file paths from those names.
• Review each generated artifact and iterate by re-running relevant phase questions rather than editing raw files directly.

Example use cases

• Kick off a feature change by producing a proposal with business goals and MVP scope.
• Elicit WHEN/THEN requirements for a specific capability and generate specs/<cap>/spec.md.
• Capture architectural decisions and tradeoffs in design.md for cross-team design review.
• Break a change into hierarchical checkbox tasks.md for planning and handoff to engineering.