README.de.md

adopt-not-build-examples

Deutsche Fassung. English version: README.md.

Begleit-Repository zum Buch „Adopt, not Build — Die Wrapper-Disziplin" (Sascha Willomitzer, Chameleon Books, 2026). Apache 2.0.

Dieses Repo ist als Forgejo-/GitHub-Template angelegt: Klick auf „Use this template" und du hast ein eigenes Architektur-Tagebuch plus Skelett für Helm-Charts, OpenTofu-Module, GitOps-Layout und Triage-Workshops — alles aus den Fallstudien des Buchs herausdestilliert.

Das Buch erscheint zuerst auf Deutsch; eine englische Übersetzung ist in Vorbereitung. Dieses Repository ist von Anfang an zweisprachig — alle README-Dateien existieren parallel als README.md (Englisch, Default) und README.de.md (Deutsch). Code und Konfiguration tragen englische Kommentare, weil Code international gelesen wird.

---

Was du hier findest

.
├── 01-adr-vorlage/              ← Architektur-Entscheidungs-Schablone
│   ├── template.md              ← die sieben Sektionen aus Kap 16
│   ├── beispiel-zitadel.md      ← konkretes ADR aus Kap 4
│   └── sechs-achsen.yaml        ← maschinenlesbare Bewertungs-Matrix
│
├── 02-companion-helm/           ← Wrap-Skelett für eine OSS-Komponente
│   ├── Chart.yaml
│   ├── values.yaml
│   ├── templates/               ← NetworkPolicy, ExternalSecret, …
│   └── README.md
│
├── 03-iac-modul/                ← OpenTofu-Modul-Skelett
│   ├── main.tf                  ← Wrap-Pattern für eine Cloud-Resource
│   ├── variables.tf
│   ├── outputs.tf
│   └── README.md
│
├── 04-gitops-layout/            ← Empfohlene Verzeichnisstruktur (FluxCD)
│   ├── clusters/
│   ├── apps/
│   ├── infrastructure/
│   └── README.md
│
├── 05-triage-sequenz/           ← Workshop-Material zur Triage-Sitzung
│   ├── facilitator-guide.md     ← Drei-Stunden-Ablauf
│   └── score-sheet.md           ← Sechs-Achsen-Bewertungsbogen
│
├── 06-renovate-config/          ← Pinning- und Upgrade-Disziplin
│   └── renovate.json5
│
└── .forgejo/workflows/          ← CI für deine eigene Plattform
    ├── ci.yml
    └── release.yml

Jeder Ordner hat eine eigene README, die das Pattern erklärt und auf das passende Buch-Kapitel verweist.

---

Wie du es nutzt

Als Template für die eigene Plattform

# In Forgejo / GitHub: "Use this template" → eigenes Repo erstellen
git clone git@<dein-host>:<deine-org>/<dein-stack>.git
cd <dein-stack>

# Erste eigene ADR anlegen
cp 01-adr-vorlage/template.md docs/adr/ADR-001-meine-erste-wahl.md
$EDITOR docs/adr/ADR-001-meine-erste-wahl.md
```text

Das Template-Repo nutzt nichts an externer Infrastruktur — du kannst die
Bausteine einzeln übernehmen oder ganz ignorieren. Es gibt **keine**
Build-Pipeline, die du verstehen musst, bevor du das ADR-Format nutzen
kannst.

### Als Workshop-Material

Das Verzeichnis `05-triage-sequenz/` enthält einen kompletten
Drei-Stunden-Workshop-Plan, mit dem du dein Team durch eine
ehrliche Triage-Sitzung führen kannst — passend zu Kapitel 16. Drucke
`facilitator-guide.md` und `score-sheet.md` als A4-Block aus.

### Als Lese-Begleitung

Wenn du das Buch sequenziell liest, sind die Verweise von Kapitel zu
Repo-Ordner in jedem Kapitel-Schluss vermerkt. Beispiel:

> *„Das vollständige Helm-Chart-Skelett, das diesem Pattern folgt, liegt
> im Begleit-Repo unter `02-companion-helm/`."*

---

## Lizenz

Apache 2.0. Du darfst alles aus diesem Repo in deine eigenen Projekte
übernehmen — kommerziell oder nicht, mit oder ohne Attribution. Wenn du
mit den Patterns Erfolg hast, freue ich mich über eine kurze
Notiz an `swi@thechameleonway.com` oder einen
[Issue im Buch-Repo](https://git.mon.k8b.co/Buecher/adopt-not-build/issues).

## Mitarbeit

Pull-Requests willkommen — gerne auf Deutsch oder Englisch. Wenn du
eine eigene ADR-Variante, ein verbessertes Helm-Skelett oder zusätzliche
Triage-Karten beisteuerst, nimmst du an der **Rückzahlungs-Disziplin**
aus Kapitel 19 teil — und das Repo wird mit jeder Spende reicher.