adopt-not-build-examples

English version. Deutsche Fassung: README.de.md.

Companion repository for the book "Adopt, not Build — Die Wrapper-Disziplin" (Sascha Willomitzer, Chameleon Books, 2026). Apache 2.0.

The book ships in German first; an English translation is in preparation. This repository is bilingual from day one — every README exists in parallel as README.md (English, default) and README.de.md (German). Code and configuration carry English comments, because code is read internationally.

This repo is laid out as a Forgejo / GitHub template: click "Use this template" and you get your own architecture-decision journal, plus skeletons for Helm charts, OpenTofu modules, GitOps layout and triage workshops — all distilled from the book's case studies.

---

What's inside

.
├── 01-adr-vorlage/              ← Architecture-decision template
│   ├── template.md              ← seven sections from chapter 16
│   ├── beispiel-zitadel.md      ← worked example ADR (German)
│   └── sechs-achsen.yaml        ← machine-readable scoring matrix
│
├── 02-companion-helm/           ← Wrap-skeleton for an OSS component
│   ├── Chart.yaml
│   ├── values.yaml
│   ├── templates/               ← NetworkPolicy, ExternalSecret, …
│   └── README.md
│
├── 03-iac-modul/                ← OpenTofu module skeleton
│   ├── main.tf                  ← wrap pattern for a cloud resource
│   ├── variables.tf
│   ├── outputs.tf
│   └── README.md
│
├── 04-gitops-layout/            ← Recommended directory layout (FluxCD)
│   ├── clusters/
│   ├── apps/
│   ├── infrastructure/
│   └── README.md
│
├── 05-triage-sequenz/           ← Workshop material for the triage session
│   ├── facilitator-guide.md     ← three-hour flow
│   └── score-sheet.md           ← six-axis scoring sheet
│
├── 06-renovate-config/          ← Pinning and upgrade discipline
│   └── renovate.json5
│
└── .forgejo/workflows/          ← CI for your own platform
    ├── ci.yml
    └── release.yml

The German folder names (01-adr-vorlage, 05-triage-sequenz, …) match the book chapters they reference; renaming them would break the mental link. Each folder has its own README, in both languages.

---

How to use it

As a template for your own platform

# In Forgejo / GitHub: "Use this template" → create your own repo
git clone git@<your-host>:<your-org>/<your-stack>.git
cd <your-stack>

# Author your first ADR
cp 01-adr-vorlage/template.md docs/adr/ADR-001-my-first-choice.md
$EDITOR docs/adr/ADR-001-my-first-choice.md
```text

The template repo depends on nothing external — you can adopt
individual pieces or ignore them entirely. There is **no** build
pipeline you need to understand before you can use the ADR format.

### As workshop material

`05-triage-sequenz/` contains a full three-hour workshop plan that
walks your team through an honest triage of a wrap choice — the
companion to chapter 16 of the book. Print `facilitator-guide.md`
and `score-sheet.md` as an A4 booklet.

### As a reading companion

When you read the book sequentially, every chapter ends with a pointer
into this repo. Example:

> *"The full Helm chart skeleton that follows this pattern lives in
> the companion repo at `02-companion-helm/`."*

---

## License

Apache 2.0. You may adopt anything from this repo into your own
projects — commercially or not, with or without attribution. If the
patterns work for you, a short note to `swi@thechameleonway.com` or
an [issue on the book repo](https://git.mon.k8b.co/Buecher/adopt-not-build/issues)
is appreciated but not required.

## Contributing

Pull requests welcome — in English or German. If you contribute a
variant ADR, an improved Helm skeleton, or additional triage cards,
you take part in the **give-back discipline** from chapter 19 — and
the repo gets richer with every contribution.