domain-interview

Guide Three Amigos-style interviews to capture expert-approved domain knowledge into DOMAIN.md.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/smp4/claude-skills --skill domain-interview
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: domain-interview
Source: https://github.com/smp4/claude-skills/tree/main/dot_claude/skills/domain-interview
Command: npx skills add https://github.com/smp4/claude-skills --skill domain-interview

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill keeps product teams from planning or building features before capturing the expert-vetted domain context, preventing assumptions that lead to misaligned specs and implementations.

Core Features & Use Cases

  • Guided interview phases: Phase 0 through Phase 4 keep orientation, example gathering, terminology confirmation, boundary checking, and approval loops tightly scoped.
  • Role-based capture: Claude voices Business Analyst, Tester, and Developer perspectives to collect rules, edge-case examples, and glossary terms that feed directly into dev-docs/domain/DOMAIN.md.
  • Approval and handoff ritual: Explicit expert sign-off is required before writing files, and the skill documents where to write outputs, how to update issues, and how to trigger follow-on reviews with /review or /new-plan.

Quick Start

Ask Claude to run the domain-interview process for a new feature idea and capture the resulting DOMAIN.md with expert-approved terminology before moving to /new-plan.

Frequently Asked Questions about domain-interview

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

FAQPage Schema
How do I capture domain knowledge before feature planning to avoid misaligned specs?

Capture domain knowledge through Three Amigos-style interviews that extract structured rules, verbatim examples, and terminology from business experts before planning. This guided process verifies assumptions and validates outputs with explicit expert sign-off, ensuring feature specs align with actual domain context.

What is a Three Amigos interview for requirements discovery?

A Three Amigos interview for requirements discovery uses Business Analyst, Tester, and Developer perspectives to collaboratively collect business rules, edge-case examples, and glossary terms. This role-based capture ensures comprehensive domain context is vetted by experts before feature execution.

How do I structure a domain modeling glossary from expert interviews?

Structure a domain modeling glossary by guiding experts through phased interviews: orientation, example gathering, terminology confirmation, and boundary checking. Verbatim examples and confirmed terms are written into a DOMAIN.md file, requiring explicit expert approval before the output is finalized.

Can I use business analysis interviews for feature discovery without prior documentation?

Yes, you can use business analysis interviews for feature discovery without prior documentation by starting at Phase 0 orientation. The process extracts domain context directly from experts through targeted questions, collecting verbatim examples and rules to build the initial glossary and domain documentation.

What's the best way to validate assumptions during domain knowledge extraction?

The best way to validate assumptions during domain knowledge extraction is through an approval and handoff ritual requiring explicit expert sign-off. This ensures all collected rules, terminology, and boundary checks are verified against expert intent before writing any domain files or proceeding to planning.