@@ -0,0 +1,97 @@
+---
+name: build
+version: 1
+description: Bauen, testen, linten und typechecken — immer ueber den Devcontainer, nie nativ. Findet die projektspezifischen Befehle in der Repo-CLAUDE.md statt sie zu raten. Triggers auf bauen, build, compile, test, lint, typecheck, verify, "laeuft das durch", "vor dem Push", CI lokal, Devcontainer, ./dev.
+# GENERIERT aus personal/skills-ref/build/ — nicht hier editieren; Aenderungen gehoeren nach ~/.claude/skills-ref/build/.
+source: personal-provider-ref
+ref-hash: sha256:00d4aeafdd29dd31bf449c357551de121d9bc7fefe23ca18efd8804229a0f51e
+---
+
+# build
+
+Lokale CI-Simulation: dieselben Schritte wie in der Pipeline, bevor Code weggeht.
+
+Dieser Skill traegt das **Konzept**. Die konkreten Befehle dieses Repos stehen nicht hier — siehe [Woher die Befehle kommen](#woher-die-befehle-kommen).
+
+## Zwei Regeln, die nicht verhandelbar sind
+
+**1. Die KI baut NIE nativ.** Build, Test, Lint, Typecheck, Verify und Package-Install laufen ausschliesslich ueber den Devcontainer — in **beiden** Kontexten, Host und Sandbox. Direkte Aufrufe nativer Toolchains (`mvn`, `mvnw`, `npm`, `pnpm`, `yarn`, `go build`, `go test`, `gradle`, `gradlew`, `cargo`, `dotnet`) und erst recht SDK-Installs (`mise use --global`, `nvm`, `sdkman`, `asdf`, `go install …@latest`) sind **User-only**.
+
+Der Grund ist nicht Bequemlichkeit: Build-Toolchains sind der groesste Supply-Chain-Vektor, den es gibt. Ein `postinstall`-Script, ein Maven-Plugin, ein crates.io-Build-Script — alles laeuft mit vollen Nutzerrechten und sieht dann `~/.ssh`, `~/.gitconfig`, Browser-Profile, Keychain. Container existieren, **damit** das in einer Wegwerf-Umgebung passiert. Nativ auszuweichen „nur kurz zum Verifizieren" hebt genau den Schutz auf, fuer den der Container da ist.
+
+**2. Am Host startet die KI die Anwendung nicht.** Bauen ja, hochfahren nein. `./dev dev|run|start|serve|watch`, `docker compose up`, jeder Dev-Server, jeder Long-running-Prozess: am Host **User-Vorbehalt**. Er hat die Anwendung in seiner IDE laufen; ein zweiter Start kollidiert um Ports, Datenbank-Zustand und Log-Ausgabe. In der **Sandbox** ist App-Start erlaubt, mit `run_in_background` und Timeout.
+
+### Die Trennlinie
+
+| Kommando-Klasse | Host | Sandbox |
+|---|---|---|
+| `compile` · `build` · `test` · `lint` · `typecheck` · `verify` · `package` | **ja**, via Devcontainer | ja |
+| Codegen, das durchlaeuft und endet | **ja** | ja |
+| `dev` · `run` · `start` · `serve` · `watch` · `compose up` | **nein — User** | ja (`run_in_background`) |
+| Browser-Smoke-Test gegen selbst gestartete Instanz | **nein — User** | ja |
+
+Merkmal: **endet der Befehl von selbst?** Dann ist es Verifikation → erlaubt. Laeuft er, bis jemand abbricht? Dann ist es App-Start → am Host User-Vorbehalt.
+
+Braucht eine Verifikation zwingend eine laufende Instanz: **den User fragen**, ob seine laeuft und was sie sagt. Nicht selbst starten.
+
+## Woher die Befehle kommen
+
+In dieser Reihenfolge, die erste Quelle gewinnt:
+
+1. **`CLAUDE.md` dieses Repos → Abschnitt `## Bauen und Testen`.** Dort stehen die Befehle, das CI-Aequivalent und die Eigenheiten. Das ist die deklarierte Stelle — sie wird gelesen, nicht uebersprungen.
+2. **`./dev` ohne Argument.** Listet alle Subcommands. Das ist die Quelle, wenn CLAUDE.md schweigt oder unvollstaendig ist.
+3. **Kein `./dev`, aber `.devcontainer/`** → `devcontainer up --workspace-folder .` einmalig, danach `devcontainer exec --workspace-folder . sh -c '<cmd>'`.
+4. **Nichts davon vorhanden** → es gibt (noch) keinen definierten Build. Das wird **gesagt**, nicht durch einen geratenen Befehl ueberspielt.
+
+**Raten ist verboten.** Nicht annehmen, dass es `npm run build` ist — es kann `pnpm`, `yarn`, `vite`, `vinxi` oder ein eigenes Target sein. Nicht annehmen, dass `test` existiert. Ein falsch geratener Befehl, der zufaellig durchlaeuft, ist schlimmer als eine Rueckfrage.
+
+**Dieser Skill wird nicht um Projekt-Befehle erweitert.** Er ist eine generierte Kopie aus `skills-ref/` — eine Aenderung hier erreicht kein anderes Repo und blockiert den naechsten Sync. Projekt-Fakten gehoeren in `CLAUDE.md` → `## Bauen und Testen`.
+
+## Pre-flight
+
+```bash
+docker info >/dev/null 2>&1 && echo "Daemon OK"
+devcontainer --version                     # nur noetig fuer direkten devcontainer exec
+```
+
+Ohne laufenden Docker-Daemon kein Build — der Container **ist** das Build-Backend. Fehlt die Devcontainer-CLI, wird sie installiert (Standalone-Installer, nicht per npm), **nicht** auf nativen Build ausgewichen.
+
+Nicht mehr pruefen oder installieren: SDKs am Host. Die Toolchain lebt im Container.
+
+## Ausfuehren
+
+`./dev <command>` im Repo-Root ist der Standardweg; das Skript ist container-aware und entscheidet selbst, ob es nativ laeuft (im Container) oder `devcontainer exec` wrappt (am Host).
+
+Ohne `./dev`:
+
+```bash
+devcontainer exec --workspace-folder . sh -c '<cmd>'
+```
+
+Native Befehle in Repo-Doku sind **Referenz fuer den Inhalt**, kein Ausfuehrungsweg.
+
+## Verifikation
+
+- Alle Befehle mit Exit Code 0
+- Keine Lint- oder Test-Fehler
+- Lockfiles synchron und ohne Diff nach dem Lauf (`go.sum`, `package-lock.json`, `pnpm-lock.yaml`)
+- Keine unaufgeloesten Abhaengigkeiten
+
+Erzeugt ein Build-Schritt Diffs in getrackten Dateien (typisch bei `go mod tidy` oder Lockfile-Updates), gehoeren die committet — nicht verworfen.
+
+## Troubleshooting
+
+| Problem | Ursache | Loesung |
+|---|---|---|
+| `command not found: devcontainer` | CLI fehlt am Host | Standalone-Installer, **nicht** nativ ausweichen |
+| Build „will" nativ laufen | Versuchung, schnell zu verifizieren | STOP. Nativ ist User-only, ohne Ausnahme |
+| Kein `./dev`, kein `.devcontainer/` | Repo hat noch kein Build-Setup | melden, nicht improvisieren |
+| Testcontainers-Timeout | Ryuk ueber `172.17.0.1` nicht erreichbar | `TESTCONTAINERS_HOST_OVERRIDE=host.docker.internal` + `--add-host=host.docker.internal:host-gateway` |
+| Lockfile-Update schlaegt fehl | Lockfile veraltet | im Container regenerieren, dann committen |
+| Container-Volume nicht beschreibbar | Named Volume gehoert `root` | `chown` im `post-create.sh` des Repos |
+
+## Zum Schluss
+
+- **Build gruen vor der Uebergabe.** Am Host committet und pusht der User — der gruene Build ist trotzdem Bringschuld, bevor uebergeben wird.
+- **Push nie aus dem Container.** Der Devcontainer haelt keine Credentials und ist per Hook geblockt.
+- **Fehlschlag wird berichtet**, mit Ausgabe. Nicht umgehen, nicht `--no-verify`, nicht „lief lokal aber".
@@ -0,0 +1,122 @@
+---
+name: java
+description: Umfassende Java-Entwicklungsrichtlinien für Backend-Projekte. Enthält Konventionen, Integrationen (PostgreSQL, Javalin, Jackson, Log4j2), Patterns (Clean Architecture, Repository) und Build-Konfiguration (Maven). Triggers auf Java-Code, REST APIs, Datenbank, jOOQ, Flyway, DTOs, Records, Logging, Properties, Identifiers, Security.
+# GENERIERT aus personal/skills-ref/java/ — nicht hier editieren; Aenderungen gehoeren nach ~/.claude/skills-ref/java/.
+source: personal-provider-ref
+ref-hash: sha256:8a4c909743dc64a6c65624290ae533a0c33027f19ad593362f2e0606491304d9
+---
+
+# Java Development Guide
+
+Vollständige Entwicklungsrichtlinien für Java-Backend-Projekte.
+
+## Quick Reference
+
+| Thema | Konvention |
+|-------|------------|
+| **Klassen/Records** | PascalCase, Suffix: `*Dto`, `*Repository`, `*Service` |
+| **Methoden** | camelCase, Prefix: `find*`, `create*`, `update*`, `delete*` |
+| **Private Felder** | `_underscorePrefix` |
+| **Null-Handling** | `Optional<T>` statt null |
+| **Collections** | Eclipse Collections (immutable) |
+| **JSON** | Jackson mit Field-Visibility |
+| **Database** | jOOQ + Flyway + HikariCP |
+| **HTTP Server** | Javalin |
+| **Logging** | Log4j2 + SLF4J (JSON) |
+| **IDs** | UUIDv7 |
+| **Build** | Maven Multi-Module |
+
+## Rules by Priority
+
+### Conventions (Immer anwenden)
+
+| Rule | Impact | Beschreibung |
+|------|--------|--------------|
+| [convention-naming](rules/convention-naming.md) | HIGH | Klassen, Interfaces, Methoden, Variablen |
+| [convention-dtos](rules/convention-dtos.md) | HIGH | Records, Klassen-DTOs, Sealed Classes |
+| [convention-null-handling](rules/convention-null-handling.md) | HIGH | Optional, var, final |
+| [convention-formatting](rules/convention-formatting.md) | MEDIUM | Einrückung, Klammern, Leerzeilen |
+| [convention-imports](rules/convention-imports.md) | MEDIUM | Import-Reihenfolge |
+
+### Integrations (Bei Bedarf)
+
+| Rule | Impact | Beschreibung |
+|------|--------|--------------|
+| [integration-database-postgres](rules/integration-database-postgres.md) | CRITICAL | jOOQ, Flyway, HikariCP, Auditing |
+| [integration-http-server-javalin](rules/integration-http-server-javalin.md) | CRITICAL | REST Endpoints, Exception Handler |
+| [integration-json-jackson](rules/integration-json-jackson.md) | HIGH | ObjectMapper, Annotations, SubTypes |
+| [integration-logging-log4j2](rules/integration-logging-log4j2.md) | HIGH | Structured JSON Logging, MDC |
+| [integration-collections-eclipse](rules/integration-collections-eclipse.md) | HIGH | ImmutableList, ImmutableMap |
+| [integration-identifiers](rules/integration-identifiers.md) | HIGH | UUIDv7, ULID, Codecs |
+| [integration-configuration-properties](rules/integration-configuration-properties.md) | MEDIUM | Typisierte Properties |
+| [integration-http-client-retrofit](rules/integration-http-client-retrofit.md) | MEDIUM | REST Client mit OkHttp |
+| [integration-dependency-injection](rules/integration-dependency-injection.md) | MEDIUM | JUseCase Inject, AspectJ |
+| [integration-security-password4j](rules/integration-security-password4j.md) | MEDIUM | Argon2, BCrypt Hashing |
+| [integration-security-password-policy](rules/integration-security-password-policy.md) | MEDIUM | Passay Validierung |
+| [integration-sqids](rules/integration-sqids.md) | LOW | Kurze URL-sichere IDs |
+| [integration-primitives](rules/integration-primitives.md) | LOW | Bytes, Hashing, Codecs |
+| [integration-filesearch](rules/integration-filesearch.md) | LOW | Dateisystem-Suche |
+| [integration-useragent-parser](rules/integration-useragent-parser.md) | LOW | Browser/OS Erkennung |
+| [integration-ip-geolocation](rules/integration-ip-geolocation.md) | LOW | MaxMind GeoLite2 |
+| [integration-database-dynamodb](rules/integration-database-dynamodb.md) | LOW | AWS DynamoDB |
+
+### Patterns (Architektur)
+
+| Rule | Impact | Beschreibung |
+|------|--------|--------------|
+| [pattern-clean-architecture](rules/pattern-clean-architecture.md) | CRITICAL | UseCases, Domain Layer |
+| [pattern-repository](rules/pattern-repository.md) | HIGH | Interface + jOOQ Implementierung |
+
+### Build (Projekt-Setup)
+
+| Rule | Impact | Beschreibung |
+|------|--------|--------------|
+| [build-maven-multimodule](rules/build-maven-multimodule.md) | HIGH | Parent POM, Module |
+| [build-maven](rules/build-maven.md) | MEDIUM | Single-Module Setup |
+| [build-bootstrap-rest-api](rules/build-bootstrap-rest-api.md) | MEDIUM | REST API Grundgerüst |
+
+## Workflow-Checkliste
+
+### Neues Projekt
+
+- [ ] Maven-Struktur anlegen (Single oder Multi-Module)
+- [ ] `.editorconfig` aus Template kopieren
+- [ ] Dependencies in pom.xml eintragen
+- [ ] log4j2.xml konfigurieren
+- [ ] application.properties anlegen
+
+### Neue Klasse
+
+- [ ] Package-Struktur beachten (feature/{domain}/...)
+- [ ] Naming-Konventionen einhalten
+- [ ] `final` und `var` verwenden
+- [ ] `Optional<T>` statt null
+- [ ] Private Felder mit `_underscorePrefix`
+
+### Neues Feature
+
+- [ ] UseCase mit korrektem Interface anlegen
+- [ ] DTO im api-Package erstellen
+- [ ] Repository-Interface definieren
+- [ ] jOOQ-Implementierung schreiben
+- [ ] Javalin Route registrieren
+
+## Wichtige Hinweise
+
+- **Build zur Verifikation** - immer ueber den Devcontainer: `./dev compile`/`./dev verify` (Baunach), sonst `devcontainer exec --workspace-folder . sh -c 'mvn clean verify'`. **Nie nativ `mvn`/`./mvnw`** — das ist User-only (siehe `~/.claude/CLAUDE.md` → Verbote, [[build]])
+- **Sandbox deaktivieren** - der Build-Befehl (`./dev` bzw. `devcontainer exec`) immer mit `dangerouslyDisableSandbox: true` ausfuehren (Netzwerkzugriff auf Maven Central, JitPack etc. noetig)
+- **DTOs aus api-Package** - Niemals Repository-Records direkt zurueckgeben
+- **Eclipse Collections** - Immer immutable Collections verwenden
+- **UUIDv7** - Fuer alle neuen IDs verwenden
+
+## References (Templates)
+
+| Template | Beschreibung |
+|----------|--------------|
+| [usecase-template.java](references/usecase-template.java) | UseCase mit Request/Response |
+| [repository-template.java](references/repository-template.java) | Interface + jOOQ-Implementierung |
+| [dto-template.java](references/dto-template.java) | Record DTO mit jOOQ-Konstruktor |
+
+## Ressourcen
+
+- [editorconfig.template](editorconfig.template) - IDE-Konfiguration
@@ -0,0 +1,102 @@
+# EditorConfig - https://editorconfig.org
+# Kopiere diese Datei als .editorconfig ins Projekt-Root
+root = true
+
+# Defaults für alle Dateien
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+# Java
+[*.java]
+indent_size = 4
+continuation_indent_size = 8
+max_line_length = 120
+
+# IntelliJ-spezifisch: Import-Reihenfolge
+# $* = static imports, | = Leerzeile, * = alle anderen
+ij_java_imports_layout = $*, |, *, |, javax.**, |, java.**
+ij_java_class_count_to_use_import_on_demand = 999
+ij_java_names_count_to_use_import_on_demand = 999
+
+# IntelliJ-spezifisch: Klammern
+ij_java_brace_style = end_of_line
+ij_java_class_brace_style = end_of_line
+ij_java_method_brace_style = end_of_line
+
+# IntelliJ-spezifisch: Leerzeilen
+ij_java_blank_lines_after_package = 1
+ij_java_blank_lines_before_imports = 1
+ij_java_blank_lines_after_imports = 1
+ij_java_blank_lines_around_class = 1
+ij_java_blank_lines_around_method = 1
+ij_java_blank_lines_around_field = 0
+
+# IntelliJ-spezifisch: Wrapping
+ij_java_wrap_long_lines = true
+ij_java_method_parameters_wrap = on_every_item
+ij_java_method_call_arguments_wrap = on_every_item
+ij_java_record_components_wrap = on_every_item
+ij_java_align_multiline_parameters = false
+ij_java_align_multiline_records = false
+
+# IntelliJ-spezifisch: Spaces
+ij_java_space_before_method_parentheses = false
+ij_java_space_before_if_parentheses = true
+ij_java_space_before_for_parentheses = true
+ij_java_space_before_while_parentheses = true
+ij_java_space_before_switch_parentheses = true
+ij_java_space_before_catch_parentheses = true
+ij_java_space_around_assignment_operators = true
+ij_java_space_around_logical_operators = true
+ij_java_space_around_equality_operators = true
+ij_java_space_around_relational_operators = true
+ij_java_space_around_additive_operators = true
+ij_java_space_around_multiplicative_operators = true
+ij_java_space_after_comma = true
+ij_java_space_before_comma = false
+
+# XML / POM
+[*.xml]
+indent_size = 4
+
+[pom.xml]
+indent_size = 4
+
+# Properties
+[*.properties]
+indent_size = 2
+
+# YAML
+[*.{yml,yaml}]
+indent_size = 2
+
+# JSON
+[*.json]
+indent_size = 2
+
+# Markdown
+[*.md]
+trim_trailing_whitespace = false
+indent_size = 2
+
+# SQL
+[*.sql]
+indent_size = 4
+ij_sql_keyword_case = upper
+ij_sql_identifier_case = lower
+
+# Shell Scripts
+[*.sh]
+indent_size = 2
+
+# Generated Code - nicht formatieren
+[**/generated/**]
+ij_formatter_enabled = false
+
+[**/org/jooq/generated/**]
+ij_formatter_enabled = false
@@ -0,0 +1,32 @@
+package net.baunach.bis.backend.core.feature.website.{domain}.api;
+
+import java.util.Optional;
+import java.util.UUID;
+
+// ============================================================
+// Standard Record DTO
+// ============================================================
+public record {FeatureName}Dto(
+    UUID id,
+    String name,
+    Optional<String> description
+) {
+    // Konstruktor fuer jOOQ-Records
+    public {FeatureName}Dto(final JooqGeneratedBisRecord{Entity} record) {
+        this(
+            record.getId(),
+            record.getName(),
+            Optional.ofNullable(record.getDescription())
+        );
+    }
+}
+
+// ============================================================
+// Sealed Interface (fuer polymorphe Ergebnisse)
+// ============================================================
+// public sealed interface {FeatureName}Result
+//     permits {FeatureName}Success, {FeatureName}Failure {
+// }
+//
+// public record {FeatureName}Success(UUID id) implements {FeatureName}Result {}
+// public record {FeatureName}Failure(String errorCode) implements {FeatureName}Result {}