---
title: Project-Local Learnings Schema
type: reference
status: aktiv
tags: [convention, learnings, knowledge-management]
date: 2026-06-16
---

# Project-Local Learnings — Konvention

## Zweck

Jedes aktive Code-Projekt unter `/root/projekte/` erhaelt eine `learnings.md` im Projekt-Root. Diese Datei ergaenzt die globale Aria-Corrections-Automation (KAR-738) auf Projekt-Ebene: waehrend CORRECTIONS.md und globale Memory-Files systemweite Patterns sammeln, enthalten `learnings.md`-Files Wissen, das spezifisch fuer genau dieses Repo relevant ist (Eigenheiten des Stacks, Fallstricke der CI-Gates, historisch getroffene Entscheidungen).

## Schema

```yaml
---
title: <Projektname> Learnings
project: <Projektname>
date: YYYY-MM-DD  # Erstellungsdatum
---

## Gotchas
<!-- Fallstricke, die beim ersten Mal ueberrascht haben. Jeder Eintrag mit Datum. -->
- **YYYY-MM-DD** — Beschreibung

## Decisions
<!-- Architektur- und Prozess-Entscheidungen, die nicht aus dem Code offensichtlich sind. -->
- **YYYY-MM-DD** — Entscheidung + Begruendung

## Patterns
<!-- Bewaehhte Muster, die in diesem Projekt konsequent einzuhalten sind. -->
- Pattern-Name — Beschreibung
```

## Aktuelle Dateien

| Projekt | Pfad |
|---------|------|
| Kadi-v2 | `/root/projekte/Kadi-v2/learnings.md` |
| private-ops | `/root/projekte/private-ops/learnings.md` |
| durrani-web | `/root/projekte/durrani-web/learnings.md` |
| durrani-cms | `/root/projekte/durrani-cms/learnings.md` |

## Pflege-Regeln

1. **Immer mit Datum** — jeder neue Eintrag beginnt mit `**YYYY-MM-DD** —`
2. **Nur belegtes Wissen** — kein Erfinden von Patterns; nur Dinge, die aus Code, CLAUDE.md, README oder echten Vorfaellen ableitbar sind
3. **Bei Vorfall sofort nachtragen** — wenn ein Gotcha aufgetreten ist, gehoert es in die naechste PR oder direkt als Commit
4. **Nicht doppeln** — global-relevante Learnings (z.B. "git fetch vor Branch-Arbeit") gehoeren ins globale Memory, nicht hierher
5. **Existierende Dateien nicht ueberschreiben** — beim Setup/Re-Seed: erst pruefen ob vorhanden

## Abgrenzung zu globalen Memory-Files

| Global (MEMORY.md / Brain) | Projekt-lokal (learnings.md) |
|---|---|
| Aria-systemweite Verhaltensregeln | Stack-spezifische Gotchas dieses Repos |
| Cross-Projekt-Patterns | CI-Gates und Check-Befehle dieses Repos |
| Kais-Preferences | Architektur-Entscheidungen dieses Repos |
| Vorfaelle mit systemweiter Auswirkung | Vorfaelle, die nur dieses Repo betreffen |

Angelegt via KAR-750 (2026-06-16).