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 — Monorepo Root (Angular + Java)
Schlanke Root-Datei. Details in Package-
AGENTS.md.
Surfaces (Copilot, Claude Code, Codex, Grok Build, …): Anhang C. Optional Copilot-Surface:templates/copilot-instructions-monorepo.md. Permissions bleiben hart (Copilot-Startmuster:templates/permissions-hints-enterprise.md; andere Agents analog mappen).
# Agent instructions — <monorepo-root>
## Mission
Fullstack-Monorepo: kleine vertikale Slices, klare Package-Grenzen, reviewbare Diffs.
Coding-Agents: Surfaces eures Teams (AGENTS.md + Convention-Dateien; s. Mapping).
## Karpathy-Skills (verbindlich)
Think Before Coding · Simplicity First · Surgical Changes · Goal-Driven Execution
## Struktur
- `apps/web` — Angular → siehe `apps/web/AGENTS.md`
- `services/api` — Spring Boot → siehe `services/api/AGENTS.md`
- `services/edge` — optional Quarkus → siehe dortiges AGENTS.md
- `packages/contracts` — OpenAPI / shared contracts
## Runtime / Einstieg
# Pin (eine Wahrheit; Tool-Name egal): <mise.toml | .tool-versions | CI-Image + README>
# Node: <Version> · JDK: <Version>
# Optional Tasks: <just test-web | just test-api | …>
# Env: keine Secrets im Chat; nur Repo-Schema / Secret-Store-Referenz
Im jeweiligen Package den kanonischen Einstieg nutzen — nicht raten.
## Verify (Übersicht)
# Frontend tight: (cd apps/web && npm test -- --watch=false)
# Backend tight: (cd services/api && ./mvnw -q -Dtest=… test)
# Contract: <befehl oder „manuell review OpenAPI“>
# Full CI: <pipeline-name / just ci>
Im jeweiligen Package die kanonischen Commands nutzen — nicht raten.
## Boundaries
- Keine Business-Logik im falschen Package
- API-Änderungen: Contract mitschreiben
- Kein Drive-by-Refactor über mehrere Services ohne Auftrag
## Context
- Ignore: node_modules, target, .angular, dist, coverage, große Logs
- Bei Themenwechsel: Handoff + neue Session
## Git & Risiko
- Keine Secrets · kein force-push / reset --hard ohne Freigabe
- Destruktiv (rm -rf, drop db, prod) nur mit Bestätigung