Files
ki-eit/templates/copilot-instructions-monorepo.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.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-instructions
  • services/api — Spring Boot → Package-AGENTS.md
  • services/edge — optional Quarkus
  • packages/contracts — OpenAPI / shared contracts

Agent-Arbeitsweise

  1. Explore: relevante Package-Dateien und AGENTS.md lesen
  2. Plan: bei multi-file / multi-package Tasks zuerst Plan
  3. Code: Slice eng halten (UI↔API↔DB dünn, nicht horizontaler Big-Bang)
  4. Verify: Tight-Loop aus dem betroffenen Package
  5. 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/N in Agent-Loops)
  • Breaking API-Änderungen: Contract mitschreiben

Nie

  • Production-Deploy aus der Session
  • git push --force auf 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.md und Der Copilot-CLI-Harness