Conrad Schulz 95d03603cf fix: history/prompts/ is committed, not gitignored

Full agent conversation history is preserved in git.
Only data/ remains gitignored (persistent service data).

2026-05-31 12:51:15 +00:00

3 KiB

Raw Blame History

Maintainer-Handbuch – [PROJEKT_NAME]

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

Architektur

┌──────────────────────────────────────────────────────────┐
│  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 (gitignored)
│   └── 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 history/summary/PROJECT_CONTEXT.md. Nach Abschluss einer Aufgabe wird dort der Projektzustand aktualisiert.

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

Neues Feature hinzufügen

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 KiB Raw Blame History Unescape Escape