nixos-config/profiles/opencode/skill/librarian/references/diagrams.md

Mermaid Diagram Patterns

Create diagrams for:

• Architecture (component relationships)
• Data flow (request → response)
• Dependencies (import graph)
• Sequences (step-by-step processes)

Architecture

graph TD
    A[Client] --> B[API Gateway]
    B --> C[Auth Service]
    B --> D[Data Service]
    D --> E[(Database)]

Flow

flowchart LR
    Input --> Parse --> Validate --> Transform --> Output

Sequence

sequenceDiagram
    Client->>+Server: Request
    Server->>+DB: Query
    DB-->>-Server: Result
    Server-->>-Client: Response

When to Use

Type	Use For
graph TD	Component hierarchy, dependencies
flowchart LR	Data transformation, pipelines
sequenceDiagram	Request/response, multi-party interaction
classDiagram	Type relationships, inheritance
stateDiagram	State machines, lifecycle

Tips

• Keep nodes short (3-4 words max)
• Use subgraphs for grouping related components
• Arrow labels for relationship types
• Prefer LR (left-right) for flows, TD (top-down) for hierarchies