Doku: KONZEPT.md, ROADMAP.md, AGENTS.md, README.md, SAVEPOINT.md, .aiexclude

AGENTS.md

@@ -0,0 +1,34 @@
+# AGENTS.md — Arbeits-Konventionen für Rippy
+
+## Grundregeln
+
+**1. Plan vor Code.** Vor jeder Etappe: Klare Akzeptanzkriterien schreiben, dann bauen.
+**2. Kleine Schritte.** Max. eine Feature pro Commit. Commit-Nachrichten beschreiben WAS und WARUM.
+**3. Beweisen statt behaupten.** Testen, was gebaut wurde. Keine "es sollte funktionieren"-Commits.
+**4. Deutsch-Nicht-Entwickler.** Der Commander liest alles — Variablennamen auf Englisch, aber Kommentare und Docs auf Deutsch.
+
+## Workflow
+
+1. **Read:** KONZEPT.md + ROADMAP.md lesen. Verstehen, welche Etappe dran ist.
+2. **Plan:** Was genau soll diese Sitzung bauen? Eine Zeile.
+3. **Build:** Code schreiben, testen, committen.
+4. **Verify:** `docker compose up` — funktioniert das Ganze?
+5. **Savepoint:** SAVEPOINT.md aktualisieren. Nächster Chat beginnt nicht von Null.
+
+## Modelle je Aufgabe
+
+- **Planung:** Heavy-Modell (Reasoning) für Architektur-Entscheidungen.
+- **Bauen:** schnelles Coding-Modell.
+- **Review:** Heavy nochmal für Code-Review vor Merge.
+
+## Docker-Praxis
+
+- Alles läuft in Containern: `docker compose up -d`
+- Keine System-Pakete auf dem Host — alles im Container.
+- Dockerfile immer multi-stage, kleinste Images.
+
+## Was NICHT gebaut wird
+
+- Kein Code direkt im Host-OS.
+- Kein Proxmox-LXC-Nesting-Workaround — das Projekt lebt bewusst in normalem Docker.
+- Kein ARM-Fork — Rippy ist ein Eigenbau von Grund auf.