Architecture Describer

Generate structured IT architecture descriptions with ASCII diagrams.

Output Structure

•Overview - 2-3 sentences describing the system's purpose and high-level architecture
•Components - Bulleted list of all components with brief descriptions
•Connections - Numbered list of all integrations between components
•Diagram - ASCII diagram showing components and annotated connections

ASCII Diagram Conventions

Use box-drawing characters:

code

┌──────────────┐
│  Component   │
└──────────────┘

Arrow styles with annotations:

code

─────▶  unidirectional
◀────▶  bidirectional
──┬──   split/branch
──┴──   merge/join

Annotate arrows with protocol and purpose:

code

┌─────────┐   REST/get orders   ┌─────────┐
│ Service │────────────────────▶│   API   │
└─────────┘                     └─────────┘

┌─────────┐  gRPC/stream jobs   ┌─────────┐
│ Worker  │◀────────────────────│ Broker  │
└─────────┘                     └─────────┘

Vertical connections:

code

┌──────────┐
│  Source  │
└────┬─────┘
     │ JDBC/write
     ▼
┌──────────┐
│    DB    │
└──────────┘

Example Output

Prompt: "Describe Camunda 8 architecture"

Overview

Camunda 8 is a cloud-native process orchestration platform built on a distributed architecture. The core consists of Zeebe (workflow engine with brokers and gateway), operational tools (Operate, Tasklist, Optimize), and supporting infrastructure (Elasticsearch, Identity).

Components

•Zeebe Gateway - Entry point for client applications, routes commands to brokers
•Zeebe Broker Cluster - Distributed workflow engine, processes BPMN workflows, manages state via Raft consensus
•Elasticsearch - Stores process data exported from brokers for querying
•Operate - Web UI for monitoring and troubleshooting process instances
•Tasklist - Web UI for human task management
•Optimize - Web UI for process analytics and reporting
•Identity - Authentication and authorization service (Keycloak-based)
•Workers - External applications that execute job tasks
•Client Applications - Applications that start process instances and interact with the platform

Connections

•Client Applications → Zeebe Gateway: gRPC/start process, create jobs
•Zeebe Gateway → Zeebe Brokers: gRPC/route commands
•Zeebe Brokers ↔ Zeebe Brokers: Raft/replication, leader election
•Zeebe Brokers → Elasticsearch: HTTP/export process records
•Workers ↔ Zeebe Gateway: gRPC/poll jobs, complete jobs
•Operate → Elasticsearch: HTTP/query process data
•Tasklist → Elasticsearch: HTTP/query tasks
•Tasklist → Zeebe Gateway: gRPC/complete tasks
•Optimize → Elasticsearch: HTTP/query analytics data
•Identity → Operate, Tasklist, Optimize: OAuth2/authentication

Diagram

code

┌───────────────────┐     gRPC/start process     ┌─────────────────┐
│ Client            │───────────────────────────▶│  Zeebe Gateway  │
│ Applications      │                            └────────┬────────┘
└───────────────────┘                                     │
                                                          │ gRPC/route
┌───────────────────┐     gRPC/poll & complete           ▼
│     Workers       │◀──────────────────────────▶┌─────────────────┐
└───────────────────┘                            │  Zeebe Broker   │
                                                 │    Cluster      │
                                                 │ ┌─────┬─────┐   │
                                                 │ │ B1 ◀─▶ B2 │   │
                                                 │ └──┬──┴──┬──┘   │
                                                 │    └──▶B3◀┘     │
                                                 │   Raft/replicate│
                                                 └────────┬────────┘
                                                          │
                                         HTTP/export      │
                                         records          ▼
┌───────────────┐                            ┌────────────────────┐
│   Identity    │──OAuth2/auth──────────────▶│   Elasticsearch    │
│  (Keycloak)   │                            └─────────┬──────────┘
└───────┬───────┘                                      │
        │                                              │ HTTP/query
        │ OAuth2/auth                                  ▼
        │                            ┌─────────────────────────────┐
        └───────────────────────────▶│  Operate  Tasklist  Optimize│
                                     └─────────────────────────────┘

Common Architectures Reference

For common systems (Kafka, Kubernetes, Redis, etc.), see references/architectures.md for component lists and typical connection patterns.