grill-with-docs

You can generate architecture decision records by conducting structured, interview-based refinement sessions that clarify your design and automatically produce ADRs and glossaries as outputs.

Interview-based refinement is a process that conducts structured interviews to clarify and improve software plans, automatically generating design documentation like ADRs and glossaries throughout the session.

To create a domain glossary during the design process, use an interview-based refinement skill that extracts definitions and terminology as you answer questions about your software architecture.

Yes, this approach requires a separate domain modeling skill to function properly, as it relies on that skill to handle the underlying domain modeling and documentation creation during the interview process.

You should use a structured interview to document software architecture when developing a new feature and you need to ensure the design is thoroughly refined and documented for future reference.

This approach is designed for refining active plans and designs, making it suitable for new software features where you need to simultaneously clarify the architecture and generate accompanying documentation.