Maintainer-Handbuch – [PROJEKT_NAME]

Zielgruppe: Entwickler & Maintainer – Menschen, die den Code verstehen, erweitern oder reviewen. Voraussetzung: Entwicklungserfahrung mit dem eingesetzten Stack.

Architektur

Für Repos mit einem Namen beginnend mit rd13_ gilt als Grundannahme:

Der Runner läuft in Docker.
Alle Services werden über Caddy als Proxy bereitgestellt.
Die zentrale Proxy-Infrastruktur liegt im Repo rd13_system_proxy.

┌──────────────────────────────────────────────────────────┐
│  TODO: Architektur-Diagramm (ASCII oder Mermaid)          │
└──────────────────────────────────────────────────────────┘

Wichtige Komponenten:

Komponente	Verantwortlichkeit	Ort
…	…	`src/…`

Projektstruktur

[PROJEKT_NAME]/
├── data/                   ← Persistente Daten (gitignored)
│   └── <service>/          ← Ein Unterordner pro Service
├── docs/
│   ├── USER.md             ← Endnutzer-Dokumentation
│   ├── ADMIN.md            ← Administrator-Dokumentation
│   ├── MAINTAINER.md       ← Dieses Dokument
│   └── history/
│       ├── prompts/        ← Vollständige Agent-Konversationen (committed)
│       └── summary/
│           └── PROJECT_CONTEXT.md ← Aktueller Projektzustand für Agent-Kontext
└── …                       ← Source Code

Entwicklungsumgebung aufsetzen

git clone <repo>
cd <repo>
# Dependencies installieren
# Dev-Server starten

Architekturentscheidungen (ADRs)

ADR-Dateien liegen unter docs/adr/. Format: NNN-titel.md.

Nr.	Titel	Status	Datum
000	Template	accepted	…

Coding-Konventionen

Branches: feat/<ticket>-beschreibung, fix/<ticket>-beschreibung
Commits: Conventional Commits (feat|fix|chore|docs|refactor|test|ci)
Tests: tests/ spiegelt Source-Struktur, ≥ 80% Coverage
Linting: …

Agent-Kontext & History

Der Agent liest beim Start immer docs/history/summary/PROJECT_CONTEXT.md. Nach Abschluss einer Aufgabe wird dort der Projektzustand aktualisiert.

Vollständige Konversationen: docs/history/prompts/ (committed – History bleibt vollständig erhalten)
Komprimierter Kontext: docs/history/summary/PROJECT_CONTEXT.md (committed)

Neues Feature hinzufügen

docs/history/summary/PROJECT_CONTEXT.md lesen – aktuellen Stand verstehen
Issue / Ticket anlegen
Branch: git checkout -b feat/<ticket>-beschreibung
Implementieren + Tests schreiben
Dokumentation in docs/USER.md oder docs/ADMIN.md aktualisieren
git commit – Quality Gate läuft automatisch (pre-commit hook)
PR erstellen + Review

Designentscheidungen

Entscheidung	Begründung
…	…

3.3 KiB Raw Blame History Unescape Escape