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.8 KiB
2.8 KiB
Team-Baseline: your-org/your-monorepo
Mission
Fullstack-Monorepo: kleine vertikale Slices, klare Package-Grenzen, reviewbare Diffs. Surface: GitHub Copilot (Jobs agent-neutral; Mapping Anhang C).
Runtime / Einstieg
- Node:
<Version>· JDK:<Version>— Pin im Repo:<mise.toml | .tool-versions | CI-Image> - Optional Tasks:
<just …>— dieselben Namen lokal und in CI - Env: keine Secrets in Instructions/Chat; nur Variablennamen / Store-Referenz
- Details pro Package in Package-
AGENTS.md
Stack & Commands (Übersicht)
Tragt die echten Befehle ein (unter dem Pin/Einstieg oben). Details in Package-AGENTS.md und path-instructions.
| Bereich | Pfad | Tight-Loop (Beispiele) |
|---|---|---|
| Frontend | apps/web |
(cd apps/web && npm test -- --watch=false) · npm run lint |
| API | services/api |
(cd services/api && ./mvnw -q -Dtest=… test) |
| Edge (optional) | services/edge |
(cd services/edge && ./mvnw -Dtest=… test) |
| Contract | packages/contracts |
OpenAPI/Spec-Pfad; Breaking Changes im PR nennen |
Full CI: <pipeline-name / just ci> — Heavy, nicht nach jedem Edit. Runtime wie Pin, nicht „anderes Image still“.
Struktur
apps/web— Angular →apps/web/AGENTS.md+ ggf. path-instructionsservices/api— Spring Boot → Package-AGENTS.mdservices/edge— optional Quarkuspackages/contracts— OpenAPI / shared contracts
Agent-Arbeitsweise
- Explore: relevante Package-Dateien und
AGENTS.mdlesen - Plan: bei multi-file / multi-package Tasks zuerst Plan
- Code: Slice eng halten (UI↔API↔DB dünn, nicht horizontaler Big-Bang)
- Verify: Tight-Loop aus dem betroffenen Package
- Diff: vor Commit erklären; kein Drive-by-Refactor über Services
Immer
- Scope eng (nur betroffene Module)
- Secrets/Token nicht lesen/loggen/committen
- Non-interactive Flags (kein
y/Nin Agent-Loops) - Breaking API-Änderungen: Contract mitschreiben
Nie
- Production-Deploy aus der Session
git push --forceauf geschützte Branches- Dependencies ohne Begründung upgraden
- YOLO (
--allow-all//yolo) in gemeinsamen Repos ohne Team-Policy - Spring-Idiome stillschweigend nach Quarkus portieren
Weich vs. hart
- Weich: diese Datei, Package-
AGENTS.md, path-instructions, Skills - Hart: Permissions / Tool-Approval, Hooks, CI — siehe
templates/permissions-hints-enterprise.mdund Der Copilot-CLI-Harness