grok-bot
8e00712fb8
Composite-Korridore und Primärquellen in Kap. 2 ehrlich kalibriert; DoD/Verify, Surfaces und Anhänge in 04–16 geschärft; eBook 119 S. neu gebaut.
2.8 KiB
Anhang B: Command-Referenz (Snapshot)
Muster-Commands für Tight-Loop / Slice-DoD / Heavy. Anpassen an Module, Wrapper und Scripts. Stand: August 2026.
B.0 Runtime / Einstieg
Commands gelten nur unter der gepinnten Runtime (Kap. 4.1). In Instructions/AGENTS.md und CI dieselbe Wahrheit:
| Was | Beispiel (anpassen) |
|---|---|
| Pin | mise.toml / .tool-versions / CI-Image-Tags |
| Node / JDK | Versionen explizit; Wrapper (mvnw/gradlew) im Repo |
| Tasks | npm-scripts, Maven/Gradle-Goals, optional just — dieselben Namen lokal und in CI |
| Env | keine Secrets im Chat; nur Schema / Store-Referenz |
Tool-Namen sind austauschbar (Mise, asdf-Stil, Devbox, …) — eine kanonische Einstiegslinie pro Repo.
Alle Commands non-interactive: Exit-Code, kein Watch, kein y/N-Prompt (Kap. 9.4).
B.1 Angular
| Ebene | Beispiel |
|---|---|
| Tight-Loop | npm test -- --watch=false · optional --browsers=ChromeHeadless bzw. Jest/Vitest/CI-Script · npm run lint |
| Slice-DoD | + npm run build (+ Diff vs. Auftrag) |
| Heavy | npm run test:e2e (CI/headless) |
Nx: nx test <proj> --watch=false, nx lint <proj>, nx build <proj>.
B.2 Spring Boot — Maven
Kanon (wie Kap. 9 / Templates): Tight = scoped Test + Format; Slice-DoD = baubar (package, Tests bereits grün) + Diff = Auftrag; Heavy = full verify.
| Ebene | Beispiel |
|---|---|
| Tight-Loop | ./mvnw -q -Dtest=FooTest test · ./mvnw -q spotless:check |
| Slice-DoD | ./mvnw -q -DskipTests package (+ Diff vs. Auftrag) |
| Heavy | ./mvnw -q verify |
Multi-module: -pl :module -am. Mehrere Testklassen im Tight: -Dtest=A,B.
B.3 Spring Boot — Gradle
| Ebene | Beispiel |
|---|---|
| Tight-Loop | ./gradlew test --tests com.example.FooTest · ./gradlew spotlessCheck |
| Slice-DoD | ./gradlew build -x test (oder assemble nach Team-Standard) + Diff |
| Heavy | ./gradlew build / check |
Mehrere Testklassen im Tight: ./gradlew test --tests A --tests B (kein Komma in einem --tests).
B.4 Quarkus
| Ebene | Beispiel |
|---|---|
| Tight-Loop | ./mvnw -q -Dtest=FooTest test (Gradle: ./gradlew test --tests …) |
| Slice-DoD | ./mvnw -q -DskipTests package (+ Diff vs. Auftrag) |
| Heavy | ./mvnw -q verify |
| Native | nur mit Auftrag: ./mvnw package -Dnative |
Im Agent-Loop scoped -Dtest=…; Continuous Testing / quarkusDev eher Mensch-Tempo (Kap. 9) — nicht als Agent-DoD.
B.5 Pflege
Commands und Runtime-Pin zuerst in Root-AGENTS.md und Package-AGENTS.md sowie CI-YAML aligned halten — das ist die universelle Repo-Wahrheit. Surface-Beispiel Copilot: zusätzlich .github/copilot-instructions.md (Inhalt spiegeln, nicht als alleinige Wahrheit). Drift (Script oder JDK/Node) ist ein Bug — tote Instructions sind schlimmer als keine.