Files
ki-eit/templates/agents-md-monorepo-root.md
grok-bot 0880489f7a Multi-Surface, Gap-Figs und Framework-Mini-Diffs; eBook 119 Seiten.
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.
2026-08-10 19:55:25 +02:00

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