Design Doc Interviewer

Overview

Elicit the minimum set of decisions and details needed to produce a clear design document, using short, numbered question batches and progressive refinement.

Workflow

1) Align on format and scope

• Ask for the intended audience, affected systems, and whether there is a preferred template or example to mirror.
• If the user provided a sample doc, follow its section order and tone.
• Identify the target package in this monorepo. If unclear, ask the user to pick one of the packages managed here before proceeding.

1.5) Pre-flight repo context

• Search design/* with emphasis on design/ideas/ for related context before asking detailed questions.
• Summarize any relevant findings and confirm whether they should be incorporated.