chore: add Claude tooling and optimize token efficiency

- .claude/scripts/bump.sh: one-command version bump + commit + push - .claude/scripts/new-feature.sh: branch creation helper - .claude/session-context.md: session start context - CLAUDE.md: reduced to dispatch table, no rule duplication - docs/project-structure.md: restructured as dense module reference Version: 0.2.1
2026-04-05 22:32:58 +02:00
parent 80c73595d2
commit 6af5df32f6
8 changed files with 235 additions and 47 deletions
--- a/.claude/scripts/bump.sh
+++ b/.claude/scripts/bump.sh
@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+# bump.sh – Version erhöhen, CHANGELOG aktualisieren, committen und pushen
+#
+# Verwendung:
+#   bash .claude/scripts/bump.sh patch "Beschreibung der Änderung"
+#   bash .claude/scripts/bump.sh minor "Beschreibung der Änderung"
+#   bash .claude/scripts/bump.sh major "Beschreibung der Änderung"
+
+set -euo pipefail
+
+BUMP_TYPE="${1:-patch}"
+MESSAGE="${2:-}"
+
+if [[ -z "$MESSAGE" ]]; then
+  echo "Fehler: Beschreibung fehlt."
+  echo "Verwendung: bash .claude/scripts/bump.sh [patch|minor|major] \"Beschreibung\""
+  exit 1
+fi
+
+ROOT="$(git rev-parse --show-toplevel)"
+VERSION_FILE="$ROOT/VERSION"
+CHANGELOG_FILE="$ROOT/CHANGELOG.md"
+
+# Aktuelle Version lesen
+CURRENT=$(cat "$VERSION_FILE" | tr -d '[:space:]')
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
+
+# Version erhöhen
+case "$BUMP_TYPE" in
+  major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
+  minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
+  patch) PATCH=$((PATCH + 1)) ;;
+  *)
+    echo "Fehler: Ungültiger Typ '$BUMP_TYPE'. Erlaubt: patch, minor, major"
+    exit 1
+    ;;
+esac
+
+NEW_VERSION="$MAJOR.$MINOR.$PATCH"
+DATE=$(date +%Y-%m-%d)
+
+echo "Bump: $CURRENT → $NEW_VERSION ($BUMP_TYPE)"
+
+# VERSION aktualisieren
+echo "$NEW_VERSION" > "$VERSION_FILE"
+
+# CHANGELOG-Eintrag einfügen (nach der ersten ---)
+ENTRY="## [$NEW_VERSION] - $DATE\n\n### Changed\n- $MESSAGE\n\n---\n"
+# Füge nach der ersten '---' Zeile ein
+awk -v entry="$ENTRY" '/^---$/ && !inserted { print; printf "%s", entry; inserted=1; next } { print }' \
+  "$CHANGELOG_FILE" > "$CHANGELOG_FILE.tmp" && mv "$CHANGELOG_FILE.tmp" "$CHANGELOG_FILE"
+
+# Commit und Push
+git -C "$ROOT" add "$VERSION_FILE" "$CHANGELOG_FILE"
+git -C "$ROOT" commit -m "chore: bump version to $NEW_VERSION
+
+$MESSAGE
+
+Version: $NEW_VERSION"
+git -C "$ROOT" push
+
+echo "Fertig: Version $NEW_VERSION committed und gepusht."
--- a/.claude/scripts/new-feature.sh
+++ b/.claude/scripts/new-feature.sh
@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+# new-feature.sh – Feature- oder Fix-Branch aus develop erstellen und pushen
+#
+# Verwendung:
+#   bash .claude/scripts/new-feature.sh feature <name>
+#   bash .claude/scripts/new-feature.sh fix <name>
+#   bash .claude/scripts/new-feature.sh debug <name>
+
+set -euo pipefail
+
+TYPE="${1:-}"
+NAME="${2:-}"
+
+if [[ -z "$TYPE" || -z "$NAME" ]]; then
+  echo "Verwendung: bash .claude/scripts/new-feature.sh [feature|fix|debug] <name>"
+  exit 1
+fi
+
+case "$TYPE" in
+  feature|fix|debug) ;;
+  *)
+    echo "Fehler: Ungültiger Typ '$TYPE'. Erlaubt: feature, fix, debug"
+    exit 1
+    ;;
+esac
+
+BRANCH="$TYPE/$NAME"
+ROOT="$(git rev-parse --show-toplevel)"
+
+# Sicherstellen dass develop aktuell ist
+echo "Wechsle zu develop und aktualisiere..."
+git -C "$ROOT" checkout develop
+git -C "$ROOT" pull origin develop
+
+# Branch erstellen und pushen
+echo "Erstelle Branch: $BRANCH"
+git -C "$ROOT" checkout -b "$BRANCH"
+git -C "$ROOT" push -u origin "$BRANCH"
+
+echo "Fertig: Branch '$BRANCH' erstellt und gepusht."
+echo "Aktiver Branch: $(git -C "$ROOT" branch --show-current)"
--- a/.claude/session-context.md
+++ b/.claude/session-context.md
@@ -0,0 +1,42 @@
+# Session-Kontext
+
+> Claude liest diese Datei zu Beginn jeder Session.
+> Claude aktualisiert sie am Ende jeder Session (Version, Branch, offene Arbeit).
+
+---
+
+## Aktueller Stand
+
+| Feld | Wert |
+|---|---|
+| **Version** | 0.2.1 |
+| **Aktiver Branch** | feature/grundstruktur |
+| **Basis-Branch** | develop |
+| **Zuletzt geändert** | 2026-04-05 |
+
+## Offene Arbeit
+
+- [ ] Techstack festlegen
+- [ ] feature/grundstruktur → develop mergen (wenn Techstack entschieden)
+
+## Zuletzt abgeschlossen
+
+- Repo-Infrastruktur aufgebaut (CLAUDE.md, Standards, Branching, README, PR-Template)
+- .gitattributes, bump.sh, new-feature.sh, session-context.md eingeführt
+- Branch Protection + Squash-Merge serverseitig konfiguriert
+
+## Schnellreferenz
+
+```bash
+# Version bumpen
+bash .claude/scripts/bump.sh patch "Was wurde geändert"
+
+# Neuen Branch erstellen
+bash .claude/scripts/new-feature.sh feature <name>
+
+# Aktueller Branch
+git branch --show-current
+
+# Status
+git status
+```
--- a/.claude/settings.local.json
+++ b/.claude/settings.local.json
@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(curl -s -o /dev/null -w \"%{http_code}\" https://tea.jr-family.de/api/v1/repos/Admin/gartenmanager)",
+      "Bash(git -C c:/Projekte/Home/gartenmanager config --get credential.helper)",
+      "Bash(git credential:*)",
+      "Bash(python3 -m json.tool)",
+      "Bash(git -C c:/Projekte/Home/gartenmanager credential fill)",
+      "Bash(python3 -c \"import sys,json; r=json.load\\(sys.stdin\\); print\\('allow_squash_merge:', r.get\\('allow_squash_merge'\\), '| default_merge_style:', r.get\\('default_merge_style'\\)\\)\")"
+    ]
+  }
+}
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,19 @@ Format: `[MAJOR.MINOR.PATCH] - YYYY-MM-DD`

 ---

+## [0.2.1] - 2026-04-05
+
+### Changed
+- `CLAUDE.md` auf reine Dispatch-Tabelle reduziert (keine Regelwiederholungen)
+- `docs/project-structure.md` als dichte Modulreferenz-Vorlage strukturiert
+
+### Added
+- `.claude/scripts/bump.sh` – Version + CHANGELOG + commit + push in einem Befehl
+- `.claude/scripts/new-feature.sh` – Feature/Fix/Debug-Branch aus develop erstellen
+- `.claude/session-context.md` – Sessionstart-Kontext (Version, Branch, offene Arbeit)
+
+---
+
 ## [0.2.0] - 2026-04-05

 ### Added
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -4,17 +4,19 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

 ## Projekt

-**Gartenmanager** – eine Anwendung zur Verwaltung und Planung von Gartenaktivitäten (Pflanzen, Aussaatkalender, Aufgaben, Bewässerung etc.).
+**Gartenmanager** – Anwendung zur Verwaltung von Gartenaktivitäten (Pflanzen, Beete, Aussaatkalender, Aufgaben, Bewässerung).

-## Weiterführende Dokumente
+## Dokumente – wo was steht

 | Dokument | Inhalt |
 |---|---|
-| [docs/development-standards.md](docs/development-standards.md) | Entwicklungsstandards, Branching-Regeln, Versionierung, Workflow |
-| [docs/project-structure.md](docs/project-structure.md) | Projektstruktur, Module, Funktionsübersicht |
-| [docs/branching-strategy.md](docs/branching-strategy.md) | Branching-Diagramm |
+| [docs/development-standards.md](docs/development-standards.md) | **Alle Regeln:** Branching, Versionierung, Workflow, Coding, Testing |
+| [docs/project-structure.md](docs/project-structure.md) | **Alle Module & Funktionen** – hier zuerst lesen, bevor Quellcode geöffnet wird |
+| [docs/branching-strategy.md](docs/branching-strategy.md) | Branch-Diagramm |
 | [CHANGELOG.md](CHANGELOG.md) | Versionshistorie |
 | [VERSION](VERSION) | Aktuelle Versionsnummer |
+| [.claude/session-context.md](.claude/session-context.md) | **Sessionstart hier lesen:** aktiver Branch, Version, offene Arbeit |
+| [.claude/scripts/](.claude/scripts/) | Automatisierungsscripts (bump, new-feature) |

 ## Techstack

@@ -42,18 +44,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

 # Build für Produktion
 # <build-command>
+
+# Version bumpen + commit + push (patch/minor/major)
+bash .claude/scripts/bump.sh patch "Beschreibung der Änderung"
+
+# Neuen Feature-Branch erstellen
+bash .claude/scripts/new-feature.sh <name>
 ```
-
-## Pflichtregeln (immer befolgen)
-
-1. **Nie direkt nach `main` pushen/mergen** – ausschließlich per Pull-Request, und nur auf explizite Anweisung.
-2. **Branching:** Jede Arbeit in einem `feature/` oder `fix/` Branch unter `develop`. Erst nach dev mergen, wenn alles fertig und alle Tests grün sind.
-3. **Nach jeder Änderung:** Versionsnummer erhöhen (`VERSION` + `CHANGELOG.md`), committen und pushen.
-4. **Vor Merge nach dev / PR nach main:** README.md, CHANGELOG.md und docs/ prüfen und aktualisieren.
-5. **Projektstruktur-Doku** (`docs/project-structure.md`) bei jeder Funktions-/Moduländerung synchron halten.
-6. **Versionierung:** `MAJOR.MINOR.PATCH` – MAJOR nur auf Anweisung, MINOR bei Features, PATCH bei Fixes/Kleinänderungen.
-
-## Wichtige Konventionen
-
- Sprache: Deutsch für Domänenkonzepte (Pflanzen, Beet, Aussaat …), Englisch für Code-Bezeichner und Commit-Messages
- Alle Dateipfade in den `docs/`-Dokumenten aktuell halten, wenn sich die Struktur ändert
--- a/2
+++ b/2
@@ -1 +1 @@
-0.2.0
+0.2.1
--- a/docs/project-structure.md
+++ b/docs/project-structure.md
@@ -1,47 +1,59 @@
-# Projektstruktur
+# Projektstruktur & Modulreferenz

-> Dieses Dokument beschreibt die Verzeichnisstruktur und Architektur des Gartenmanagers.
-> Bei strukturellen Änderungen bitte hier aktualisieren.
+> **Token-Sparmaßnahme:** Dieses Dokument ist die erste Anlaufstelle.
+> Vor dem Öffnen von Quellcode hier nachschlagen.
+> Bei jeder Änderung an Funktionen, Modulen oder der Verzeichnisstruktur sofort aktualisieren.

 ---

-## Verzeichnisübersicht
+## Verzeichnisstruktur

 ```
 gartenmanager/
-├── CLAUDE.md                  # Guidance für Claude Code
+├── .claude/                   # Claude-Tooling (kein Projektcode)
+│   ├── scripts/
+│   │   ├── bump.sh            # Version bumpen + commit + push
+│   │   └── new-feature.sh     # Feature-Branch erstellen
+│   └── session-context.md     # Sessionstart-Kontext
+├── .gitea/
+│   └── PULL_REQUEST_TEMPLATE.md
 ├── docs/
-│   ├── development-standards.md  # Allgemeine Entwicklungsstandards
-│   └── project-structure.md      # Dieses Dokument
-│
-│   (weitere Verzeichnisse entstehen mit dem Projekt)
+│   ├── branching-strategy.md
+│   ├── development-standards.md
+│   └── project-structure.md   # dieses Dokument
+├── .gitattributes
+├── CHANGELOG.md
+├── CLAUDE.md
+├── README.md
+└── VERSION
 ```

-> Sobald der Techstack feststeht, wird diese Struktur hier dokumentiert.
+> Sobald Quellcode-Verzeichnisse entstehen, hier ergänzen.

 ---

-## Architektur
+## Modulübersicht

-> Noch festzulegen. Typische Optionen für dieses Projekt:
+> Noch kein Anwendungscode vorhanden. Sobald Module/Komponenten entstehen:
 >
-> - **Monolith** (z. B. Full-Stack-Framework wie Laravel, Django, Rails)
-> - **Frontend + Backend getrennt** (z. B. Vue/React + REST/GraphQL API)
-> - **Mobile App** (z. B. Flutter, React Native)
+> ```
+> Modulname | Datei(en) | Zweck | Exportierte Funktionen
+> ```
+>
+> **Format pro Funktion:**
+> `funktionsname(param: Typ): Rückgabetyp` – Ein-Satz-Beschreibung

 ---

-## Domänenmodell (geplant)
+## Domänenmodell

-Die Kernkonzepte des Gartenmanagers:
-
-| Konzept | Beschreibung |
-|---|---|
-| `Plant` / Pflanze | Eine Pflanzenart mit Eigenschaften (Aussaatzeit, Abstand, Wasserbedarf …) |
-| `Bed` / Beet | Ein physischer Gartenbereich, dem Pflanzen zugeordnet werden |
-| `SowingCalendar` / Aussaatkalender | Zeitplan für Aussaat und Pflanzung je Pflanze und Jahr |
-| `Task` / Aufgabe | Eine zu erledigende Gartenarbeit mit Fälligkeitsdatum |
-| `WateringSchedule` / Bewässerungsplan | Regelmäßige Bewässerungsintervalle je Beet oder Pflanze |
+| Entität | Felder (geplant) | Beziehungen |
+|---|---|---|
+| `Plant` | name, sowingStart, sowingEnd, waterInterval, spacing | gehört zu Bed |
+| `Bed` | name, width, length, location | enthält viele Plants |
+| `SowingCalendar` | year, plantId, sowDate, plantDate | referenziert Plant |
+| `Task` | title, dueDate, done, bedId? | optional zu Bed |
+| `WateringSchedule` | bedId/plantId, intervalDays, lastWatered | referenziert Bed oder Plant |

 ---

@@ -51,6 +63,18 @@ Die Kernkonzepte des Gartenmanagers:

 ---

-## Schnittstellen
+## Schnittstellen / API

-> Noch festzulegen.
+> Noch festzulegen. Hier Endpunkte mit Kurzbeschreibung eintragen:
+>
+> ```
+> GET  /api/plants          – alle Pflanzen
+> POST /api/plants          – neue Pflanze anlegen
+> ...
+> ```
+
+---
+
+## Konfiguration
+
+> Relevante Umgebungsvariablen und Konfigurationsdateien hier auflisten.
@@ -1 +1 @@
 .2.0
 .2.1