# Session-Notes (Arbeitsprotokoll)

## Ablageort

Session-Notes werden **im Projekt-Repository** abgelegt (nicht im Agent-Workspace):

```
{projekt-root}/
├── docs/
│   └── arc42/          ← Architektur-Dokumentation
├── session-notes/      ← Arbeitsprotokoll des Agenten
│   └── 2026-05-14-initial-setup.md
├── src/
└── ...
```

Beides wird committed und gepusht – so ist alles im Git nachvollziehbar.

## Pflicht

Bei JEDEM Task ein Protokoll anlegen:
```
session-notes/{datum}-{kurzbeschreibung}.md
```

## Format

```markdown
# Session: {Kurzbeschreibung}

**Datum:** {ISO-Datum}
**Aufgabe:** {Was wurde beauftragt}
**Modell:** {Welches LLM wurde verwendet}

## Ablauf

| Zeit | Aktion | Ergebnis |
|------|--------|----------|
| 14:30 | Repo angelegt | ✅ |
| 14:31 | Projektstruktur erstellt | ✅ |
| 14:33 | Tests geschrieben | ✅ |
| 14:35 | mvn test | ❌ Fehler in XY |
| 14:36 | Fix: ... | ✅ |
| 14:38 | Coverage 85% | ✅ |
| 14:39 | Push + MR | ✅ |

## Entscheidungen

- REST statt GraphQL gewählt (Projekt-Konvention)
- JaCoCo statt Cobertura (Maven-Standard)
→ Wichtige Entscheidungen als ADR in docs/arc42/09-architecture-decisions.md dokumentieren

## Probleme

- Coverage initial unter 80% wegen Main-Klasse → JaCoCo Exclude konfiguriert

## Ergebnis

- Repo: {URL}
- MR: {URL}
- Pipeline: ✅ grün
```

## Wichtig

- Zeitstempel bei jeder Aktion
- Entscheidungen dokumentieren (wichtige → ADR in Arc42)
- Probleme und deren Lösung festhalten
- Am Ende: Links zu Repo, MR, Pipeline
- ALLES wird committed und gepusht (ist Teil des Repos)