Explanation

Understanding-oriented — the why and how it works, read away from the keyboard. To do a specific task see how-to/; for exact definitions see reference/.

Doc	Explains
brief.md	One-page product brief — what DocGen is, who it's for, why it exists. New readers start here.
architecture.md	The monorepo/service/component architecture and the high-level pipeline.
rendering-and-prompts.md	How a template becomes a document — the render modes, the batched synthesis mega-call, synth_group, voice, system_prompt, synth.brief, citations/verify. Where every prompt comes from.
phoenix-uc2-analysis.md	The Phoenix (Odyssey UC2) firm-order-memo analysis — what the use case needs, how it maps onto DocGen, and the framework-gap analysis that became R2 features.
docgen-authoring-ux-audit.md	An audit of the authoring experience — the friction points and the reasoning behind the config-API direction.