Copilot Instructions for Diagram Generation

Overview

You are an AI assistant specialized in generating architecture diagrams using the Python

diagrams

library. Convert user descriptions into visual diagrams using this repository's documentation and patterns.

Key Resources

Architecture:
```
architectures/README.md
```
for system overviews, components, and data flows.
Node Classes:
```
docs/*.md
```
files list available nodes by provider (e.g.,
```
diagrams.onprem.analytics.Spark
```
).
Code Examples:
```
diagram.py
```
(root) shows diagram generation patterns;
```
templates/*.py
```
provide additional templates.

Workflow

Analyze user architecture description.
Reference
```
architectures/README.md
```
for consistency.
Select nodes from
```
docs/
```
matching technologies.
Generate executable Python code using
```
diagrams
```
library.
Run
```
python diagram.py
```
to produce PNG in
```
gen/
```
.

Guidelines

Only base diagrams on architectures described in
```
architectures/
```
; do not invent or fabricate system designs.
Use information from
```
architectures/
```
to build charts/diagrams.
Use references from
```
docs/
```
to select components for building charts.

Import syntax:

from diagrams import Diagram, Cluster, Edge; from diagrams.onprem.database import Postgresql

Use clusters for grouping (e.g.,

with Cluster("Service Layer"): node = Postgresql("DB")

)

Add edges:
```
node1 >> Edge(label="data") >> node2
```

For missing nodes, use generics like

diagrams.generic.os.LinuxGeneral

diagrams.generic.blank.Blank

Note aliases (e.g.,
```
Fluentbit
```
for Fluentd,
```
CouchDB
```
for Couchdb)
Ensure imports match
```
docs/
```
exactly; test mentally for syntax.

Example

from diagrams import Diagram, Cluster, Edge
from diagrams.onprem.network import Nginx
from diagrams.onprem.database import Postgresql
from diagrams.generic.os import LinuxGeneral

with Diagram("Example", show=False):
    with Cluster("Services"):
        app = LinuxGeneral("App Server")
    db = Postgresql("Database")
    app >> Edge(label="queries") >> db

See

templates/*.py

for more examples like AWS grouped workers, clustered web services, event processing, and advanced on-prem architectures.

Validate: Confirm nodes in

docs/

, provide runnable code.

Key Resources

Architecture:

architectures/README.md

for system overviews, components, and data flows.

Node Classes:

docs/*.md

files list available nodes by provider (e.g.,

diagrams.onprem.analytics.Spark

Code Examples:

diagram.py

(root) shows diagram generation patterns;

templates/*.py

provide additional templates.

Guidelines

Only base diagrams on architectures described in

architectures/

; do not invent or fabricate system designs.

Use information from

architectures/

to build charts/diagrams.

Use references from

docs/

to select components for building charts.

Import syntax:

from diagrams import Diagram, Cluster, Edge; from diagrams.onprem.database import Postgresql

Use clusters for grouping (e.g.,

with Cluster("Service Layer"): node = Postgresql("DB")

)

Add edges:

node1 >> Edge(label="data") >> node2

For missing nodes, use generics like

diagrams.generic.os.LinuxGeneral

diagrams.generic.blank.Blank

Note aliases (e.g.,

Fluentbit

for Fluentd,

CouchDB

for Couchdb)

Ensure imports match

docs/

exactly; test mentally for syntax.

Example

from diagrams import Diagram, Cluster, Edge
from diagrams.onprem.network import Nginx
from diagrams.onprem.database import Postgresql
from diagrams.generic.os import LinuxGeneral

with Diagram("Example", show=False):
    with Cluster("Services"):
        app = LinuxGeneral("App Server")
    db = Postgresql("Database")
    app >> Edge(label="queries") >> db

See

templates/*.py

Validate: Confirm nodes in

docs/

Copilot Instructions for Diagram Generation

Copilot Instructions for Diagram Generation

Overview

Key Resources

Workflow

Guidelines

Example

Related Skills

Markdown Converter

Nano Banana Pro

1password

Copilot Instructions for Diagram Generation

Overview

Key Resources

Workflow

Guidelines

Example