weld interview¶

Refine a specification through interactive Q&A.

Usage¶

weld interview <file> [OPTIONS]

Arguments¶

Options¶

Description¶

Outputs a prompt for Claude Code that:

1. Asks in-depth questions using the AskUserQuestion tool
2. Covers implementation, UI/UX, edge cases, tradeoffs
3. Rewrites the specification when complete

This helps ensure specifications are complete before planning.

Examples¶

Interview a specification¶

weld interview specs/feature.md

Focus on specific topic¶

weld interview specs/feature.md --focus "edge cases"

Focus on security concerns¶

weld interview specs/auth.md --focus "security"

Input Validation¶

Before starting the Claude operation, weld validates inputs upfront:

• File existence: Verifies the specification file exists
• File type: Ensures the path points to a file, not a directory

When validation fails, you'll see a clear error message with an actionable hint:

Error: specs/ is a directory, expected a file
Hint: Provide a valid specification file path

This prevents wasted time from invalid inputs.

See Also¶

• Workflow - How interview fits in the workflow
• research - Research after refining the spec
• plan - Generate a plan from the refined spec