grill-with-docs

To conduct an architecture review and document domain decisions, initiate a collaborative questioning session against your existing project documents to challenge your plan and generate ADRs in-place.

You need architecture decision records during planning review when a team must capture strategic design choices and context as they emerge from rigorous Q&A scrutiny of an architectural plan.

To start a grilling session, present your architectural plan and existing domain documents; the iterative questioning process will guide you and document any ADRs that emerge.

Yes, you need existing domain documents present or created during sessions, because the architecture review requires user collaboration with these documents to facilitate deep design scrutiny.

Yes, you can update context documentation and glossaries during an architecture review, as the session supports creating and refining these documents alongside architecture decision records.

The best way to document design choices from a planning review is through an interactive Q&A session that iteratively questions your plan and records the findings directly as architecture decision records.