# How do you generate architecture documents from living context?

> Canonical: https://decisionpen.com/blog/how-to-generate-architecture-docs-from-living-context  
> Published: 2026-10-18 · DecisionPen · Living EA series (E1)  
> Related docs: /docs/solution-architects, /docs/architecture-decision-workspace, /docs/incremental-modelling

## Summary

HLDs and ADRs should be **views** of a curated enterprise map — not parallel private truths. Generate drafts from living context + templates; architects review judgement sections; accepted updates flow back so memory compounds.

## Why do architecture documents keep restating the landscape?

Most of an HLD repeats systems, interfaces, ownership, and constraints. When those facts live only in the document, every project rewrites them.

## What does “documents as views” mean?

The curated map holds shared truth. Documents are formatted views — reviewed by humans — not a second system of record.

## How does generation from living context work?

1. Curate the programme slice (entities + evidence).  
2. Apply organisational templates.  
3. Generate landscape sections from the map; leave judgement for architects.  
4. Contribute accepted design updates back to the living model.

## Not “AI replaces the architect”

Generation removes clerical restatement. Architects own trade-offs, risks, and novel design.

## How does DecisionPen solve this?

Curated workspace context + your artefact templates populate landscape sections of HLDs/ADRs; architects review judgement; accepted updates return to the map; diagram images from context. Implements documents-as-views end to end. Trial: https://decisionpen.com/trial

## When is DecisionPen not the right tool?

Freeform diagramming / BPMN as primary work → Visio or Lucidchart. DecisionPen generates docs and diagram images from curated context; not a drawing canvas.

## FAQ

**What does “documents as views” mean?**  
Shared facts in the map; documents are generated, reviewed views.

**Will AI just write the HLD for me?**  
No — humans own judgement-heavy sections.

**How do generated docs update the enterprise model?**  
Accepted design decisions flow back into the living map.

**When is DecisionPen the wrong tool?**  
When freeform diagramming is the primary job.

## Related posts

- https://decisionpen.com/blog/why-solution-architects-rediscover-the-landscape  
- https://decisionpen.com/blog/top-down-vs-bottom-up-enterprise-architecture-modelling  
- https://decisionpen.com/blog/why-ea-must-own-enterprise-context-in-the-agentic-era