Let's Heavy Discuss

A relentless, resumable design interview where every branch of the decision tree is tracked explicitly — depth-first tunnelling is forbidden, and a session reset never loses context.

Core rules

1. Tree-first. Every question lives at a specific position in a branch tree. The tree is maintained explicitly in STATE.md so no branch is forgotten.
2. Breadth-first traversal. Resolve all sibling branches at the current depth before descending. Depth-first interviews tend to tunnel down one branch and forget the siblings — BFS prevents that.
3. One question per turn. Use the AskUserQuestion tool. Always include your recommended answer plus one-sentence reasoning.
4. Explore code instead of asking when possible. If an answer can be found by reading files or grepping, do that silently and record the finding in TRANSCRIPT.md rather than asking the user.
5. Persist before asking. Update STATE.md and TRANSCRIPT.md before every AskUserQuestion call. A session that dies mid-turn must be resumable.
6. Never modify code. Pure interview. Only writes inside .plans/discussion/<topic>/.

File layout