cad-new-project --brief: accept a design brief from a freeform discovery session #107

New issue

Closed

opened 2026-08-12 16:36:59 +00:00 by john · 0 comments

john commented

2026-08-12 16:36:59 +00:00

Owner

--brief makes the workflow real: read the brief first, ask only what it leaves open. Do NOT script the discovery interview itself - it works because it is freeform; build the socket, not the interview.

Ships with a one-page docs/ entry on the discovery workflow (freeform conversation -> design brief -> --brief init) and what a good brief answers - the problem, the user, the non-goals, the constraints that are real - linked from the README getting-started path. A page, not a methodology: steps would turn it back into the scripted interview this deliberately is not.

The verbatim project did this by hand: a freeform discovery conversation produced DESIGN-BRIEF.md, and its first commit is literally 'restart from the design brief'. The deep questioning then re-asked things the brief had already settled. --brief <file> makes the workflow real: read the brief first, ask only what it leaves open. Do NOT script the discovery interview itself - it works because it is freeform; build the socket, not the interview. Ships with a one-page docs/ entry on the discovery workflow (freeform conversation -> design brief -> --brief init) and what a good brief answers - the problem, the user, the non-goals, the constraints that are real - linked from the README getting-started path. A page, not a methodology: steps would turn it back into the scripted interview this deliberately is not.