Skip to content

CLAUDE.md

Latest commit

 

History

History
39 lines (30 loc) · 1.58 KB

CLAUDE.md

File metadata and controls

39 lines (30 loc) · 1.58 KB

adopt-not-build-examples — Claude-Onboarding

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

Zweck

  • Forgejo-/GitHub-Template-Repo für Buchkäufer:innen.
  • Liefert ADR-Vorlage, Sechs-Achsen-YAML-Schema, Companion-Helm-Chart- Skelett, OpenTofu-Modul-Skelett, GitOps-Layout, Triage-Workshop-Material und Renovate-Konfiguration.
  • Apache 2.0, damit alles in eigene Plattform-Repos übernommen werden darf.

Konventionen

  • Tonalität wie das Buch. Direkt, sachlich, technisch ehrlich, Du-Anrede in den READMEs.
  • Buchverweise. Jeder Ordner verweist explizit auf das passende Kapitel (z.B. „Pattern aus Kapitel 3, Vier-Schichten-Topologie").
  • OSS-Klarnamen. Cilium, FluxCD, Zitadel, Renovate, OpenTofu — alle mit Klarnamen, weil die Komponenten das Argument der Beispiele tragen.
  • Pseudonymisierung der Plattform. Wo Beispiele aus dem TCW-Stack stammen, wird die Plattform generisch als „die Plattform" oder „example-stack" referenziert.

Pflege

  • Commits Conventional Commits (feat:, fix:, docs:, …).
  • Major-Versionen pro Buch-Auflage. Wenn Kapitel des Buchs aktualisiert werden, wird das Beispiel-Repo angepasst.
  • Pull-Requests von Käufer:innen sind willkommen — die werden in einem CHANGELOG anerkannt, weil sie die Rückzahlungs-Disziplin (Kap 19) praktizieren.

Forgejo-Org

Buecher/adopt-not-build-examples auf git.mon.k8b.co. Mirror nach GitHub tcwlab/adopt-not-build-examples für Discoverability bei Käufer:innen, die GitHub-Workflows gewohnt sind.