weld research¶

Research a specification before planning.

Usage¶

weld research <input> [OPTIONS]

Arguments¶

Options¶

Description¶

Generates a research prompt and runs Claude to analyze:

• Architecture and existing patterns
• Dependencies and integration points
• Risks and open questions

Examples¶

Research a specification¶

weld research specs/feature.md

Write to specific location¶

weld research specs/feature.md -o research.md

Focus on specific concerns¶

weld research specs/feature.md --focus "security concerns"

Suppress streaming output¶

weld research specs/feature.md -o research.md --quiet

Output¶

Research output is written to .weld/research/ by default with a timestamped filename.

Input Validation¶

Before starting the (potentially expensive) Claude operation, weld validates inputs upfront:

• File existence: Verifies the input file exists
• File type: Ensures the path points to a file, not a directory
• Output path: If --output is specified, validates the path is writable

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

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

This prevents wasted API tokens from invalid inputs.

See Also¶

• Workflow - How research fits in the workflow
• plan - Generate a plan after research