# brewhubphl/coolify-hetzner-specialist architecture

> Architecture diagram of the GitHub repository brewhubphl/coolify-hetzner-specialist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/brewhubphl/coolify-hetzner-specialist
- Repository: https://github.com/brewhubphl/coolify-hetzner-specialist

## Overview

This repository packages an agent skill for operating Coolify on Hetzner; it is a knowledge product, not a deployed service. The user invokes the specialist with a request, such as fleet onboarding, and receives guidance. Its documented subject areas include Coolify, Hetzner provisioning, Traefik, Compose services, Doppler secrets, backups, and fleet onboarding. The tree also contains integration examples and reference material. The README supports the product identity and usage flow, but the skill and pattern contents were not sampled, so links among those materials are left unverified.

Main entry points: [`SKILL.md`](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/SKILL.md) (Specialist skill), [`patterns/coolify-fundamentals.md`](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/coolify-fundamentals.md) (Coolify fundamentals), [`patterns/hetzner-provisioning.md`](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/hetzner-provisioning.md) (Hetzner provisioning), [`patterns/traefik-routing.md`](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/traefik-routing.md) (Traefik routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Skill entry"]
  node_skill["Specialist skill<br/>[SKILL.md]"]
  node_principles["Operating principles<br/>[PRINCIPLES.md]"]
end

subgraph group_platform["Platform patterns"]
  node_coolify["Coolify fundamentals"]
  node_hetzner["Hetzner provisioning"]
  node_traefik["Traefik routing<br/>[traefik-routing.md]"]
  node_compose["Compose services"]
end

subgraph group_operations["Operations patterns"]
  node_doppler["Doppler secrets<br/>[doppler-secrets.md]"]
  node_backups["Backups and DR<br/>[backups-dr.md]"]
  node_fleet["Fleet onboarding"]
end

subgraph group_reference["Examples and references"]
  node_integration["BrewHub integration"]
  node_docs["Official docs links"]
  node_glossary["Domain glossary<br/>[glossary.md]"]
  node_book["Docker deep dive<br/>[README.md]"]
end

node_user(("Skill user"))

node_user -->|"invokes"| node_skill
node_skill -.->|"guides onboarding"| node_fleet
node_skill -.->|"covers Coolify"| node_coolify
node_skill -.->|"covers provisioning"| node_hetzner
node_skill -.->|"covers routing"| node_traefik
node_skill -.->|"covers services"| node_compose
node_skill -.->|"covers secrets"| node_doppler
node_skill -.->|"covers backups"| node_backups

click node_skill "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/SKILL.md"
click node_principles "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/PRINCIPLES.md"
click node_coolify "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/coolify-fundamentals.md"
click node_hetzner "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/hetzner-provisioning.md"
click node_traefik "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/traefik-routing.md"
click node_compose "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/docker-compose-services.md"
click node_doppler "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/doppler-secrets.md"
click node_backups "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/backups-dr.md"
click node_fleet "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/fleet-onboarding.md"
click node_integration "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/examples/brew-hub-integration.md"
click node_docs "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/official-docs-links.md"
click node_glossary "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/glossary.md"
click node_book "https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/book-summaries/poulton-docker-deep-dive/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_principles,node_user toneBlue
class node_coolify,node_hetzner,node_traefik,node_compose toneAmber
class node_doppler,node_backups,node_fleet toneMint
class node_integration,node_docs,node_glossary,node_book toneRose
```

## Components

### Skill entry

- [Specialist skill](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/SKILL.md): `SKILL.md`
- [Operating principles](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/PRINCIPLES.md): `PRINCIPLES.md`

### Platform patterns

- [Coolify fundamentals](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/coolify-fundamentals.md): `patterns/coolify-fundamentals.md`
- [Hetzner provisioning](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/hetzner-provisioning.md): `patterns/hetzner-provisioning.md`
- [Traefik routing](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/traefik-routing.md): `patterns/traefik-routing.md`
- [Compose services](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/docker-compose-services.md): `patterns/docker-compose-services.md`

### Operations patterns

- [Doppler secrets](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/doppler-secrets.md): `patterns/doppler-secrets.md`
- [Backups and DR](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/backups-dr.md): `patterns/backups-dr.md`
- [Fleet onboarding](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/patterns/fleet-onboarding.md): `patterns/fleet-onboarding.md`

### Examples and references

- [BrewHub integration](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/examples/brew-hub-integration.md): `examples/brew-hub-integration.md`
- [Official docs links](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/official-docs-links.md): `references/official-docs-links.md`
- [Domain glossary](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/glossary.md): `references/glossary.md`
- [Docker deep dive](https://github.com/brewhubphl/coolify-hetzner-specialist/blob/master/references/book-summaries/poulton-docker-deep-dive/README.md): `references/book-summaries/poulton-docker-deep-dive/README.md`

### Other components

- **Skill user**

## Connections

- Skill user → Specialist skill: invokes (evidence: `README.md`)
- Specialist skill → Fleet onboarding: guides onboarding
- Specialist skill → Coolify fundamentals: covers Coolify
- Specialist skill → Hetzner provisioning: covers provisioning
- Specialist skill → Traefik routing: covers routing
- Specialist skill → Compose services: covers services
- Specialist skill → Doppler secrets: covers secrets
- Specialist skill → Backups and DR: covers backups
