Architecture documents
Generate Software Architecture Documents, High- and Low-Level Designs, and Architecture Decision Records from your SRS.
Ragnarock can generate full architecture documents from your completed SRS, saving you from writing them from scratch. The result is a complete Markdown document saved to your Documentation workspace.
Document types
| Type | Name | What it covers |
|---|---|---|
| SAD | Software Architecture Document | End-to-end system overview — components, data flow, tech stack, deployment, and cross-cutting concerns. |
| HLD | High-Level Design | Module breakdown, interface contracts between services, data models, and key design decisions. |
| LLD | Low-Level Design | Detailed component design, class diagrams, API specs, database schema, and algorithms. |
| ADR | Architecture Decision Record | A single architectural decision — its context, the chosen option, rationale, and trade-offs. |
Generate a document
You need a completed SRS first, since these documents are generated from it. There are two ways to start.
- Open Documentation and choose New document.
- Switch to Generate with Ragnarock.
- Pick the document type (SAD, HLD, LLD, or ADR).
- Optionally set a layer or service to scope the document — for example
backend,frontend, ormobile. Leave it blank for a full-system document. - Choose Generate document.
In Ragnarock, type one of /doc sad, /doc hld, /doc lld, or /doc adr. The document
previews in the right-hand panel as it's generated. See
Commands & actions.
What happens next
Generation runs in the background. When it finishes:
- The document appears in your Documentation list with a Completed status.
- If you started from Ragnarock, it also previews in the right-hand panel, where you can expand it full-screen.
You can then open it in the editor to refine it, change its status, or download it as Markdown or PDF.
Scoping by layer is handy for larger systems: generate a backend LLD and a frontend LLD separately rather than one sprawling document.
Generated documents are drafts built from your SRS. Review them for accuracy before treating them as final — and keep your SRS up to date so regenerated documents stay correct.