grok-bot
0880489f7a
Agent-neutrales Framing (Jobs → Surfaces, Mapping Anhang C), Lektorat-P1, Golden-Path-Diffs Angular/Spring/Quarkus, Gap-Abbildungen K-22…K-27 und M-04/M-05, Autor-Backmatter sowie frisches eBook inkl. QA.
2.0 KiB
2.0 KiB
AGENTS.md — Quarkus (Vorlage)
In euer Quarkus-Service-Repo kopieren und anpassen. Nicht stillschweigend Spring-Idiome übernehmen.
Surfaces mappen (Anhang C). Optional Copilot-Surface:templates/copilot-instructions-quarkus.md.
# Agent instructions — <quarkus-service>
## Mission
Kleine, testbare Quarkus-Services. Extensions und Idiome des Repos beachten — kein Spring-1:1-Port.
## Karpathy-Skills (verbindlich)
1. Think Before Coding
2. Simplicity First
3. Surgical Changes
4. Goal-Driven Execution
## Stack-Konventionen
- Quarkus <Version> · Java <Version>
- REST: <RESTEasy Reactive / …> — **eine** Linie
- Spring-Compatibility-Layer: <ja/nein — wenn nein, nicht einführen>
- Extensions: nur bestehende oder begründete; keine Extension-Shopping-Tour
- Config: application.properties/yaml ohne Secrets
- Native-Image: nur mit explizitem Auftrag
## Runtime / Einstieg
- JDK: <Version> · Quarkus: <Version> · Wrapper: `./mvnw` (oder Team-Standard)
- Pin (eine Wahrheit): `<mise.toml | .tool-versions | CI-Image>` — anpassen
- Kanonischer Einstieg: Wrapper + Pin; Native-Toolchain nur mit Auftrag
- Config: keine Secrets in properties/yaml/Beispielen
## Definition of Done
1. Akzeptanzkriterien erfüllt
2. Verify grün
3. Diff = Auftrag
### Verify
# Tight-Loop
- `./mvnw -Dtest=<TestClass> test`
# Slice-DoD
- `./mvnw -DskipTests package`
# Heavy
- `./mvnw verify`
# Native (nur mit Auftrag)
- `./mvnw package -Dnative`
# Gradle-Alternative (eine Wahrheit wählen):
# Tight-Loop: ./gradlew test --tests <fqcn>
# Slice-DoD: ./gradlew build -x test
# Heavy: ./gradlew build
# Native: nur mit Auftrag / Team-Plugin
## Context
- Dev-Mode ist für Menschen großartig; im Agent-Loop gezielte Tests bevorzugen
- Keine target/- und Build-Report-Novellen im Context
## Git & Risiko
- Keine Secrets · kein force-push ohne Freigabe
## Security-Invariants
- Quarkus Security / OIDC-Config nicht „offen“ mergen
- Management-Endpoints bewusst
## Dateien mit Vorrang
- dieses AGENTS.md
- <Golden-Path Resource + @QuarkusTest>