Mermaid Diagrams In Generated Wiki Pages

Diagrams are part of high-quality wiki generation, not decoration. Where a flow, lifecycle, or data model is easier to grasp visually, embed a Mermaid diagram in a fenced ```mermaid block on the most relevant page.

Choosing a diagram type

• sequenceDiagram for runtime and request flows across components (auth flows, request lifecycles, agent tool loops).
• stateDiagram-v2 for lifecycles and state machines (job states, connection states, run phases).
• erDiagram for the data model: entities and their relationships.
• flowchart TD for branching control flow and decision logic.

Discipline