Projekte · agents-angular-spring-quarkus · Hilfe

Letzte Prüfung: 2026-08-08 · companion-0.1.0

Schnelle Hilfe bei typischen Praxis-Problemen

Symptom → 2–3 Sätze Lösung → Buchkapitel und Material. Kein Ersatz für Diff-Review und eure Stack-Doku – sondern der schnelle Einstieg.

Immer zuerst: Repo-Wahrheit (Runtime, Verify), Slice eng halten, Diff lesen. CLI-Flags und UI-Labels können je Version abweichen – Buch-Konzept bleibt gültig, Primärdoku und gepinnte Runtime folgen.

Agent produziert viel Schrott im Enterprise-Repo

Sofort: Repo-Readiness prüfen – Runtime-Pin, Instructions/AGENTS.md, Golden Paths, non-interactive Verify. Nicht „mehr Prompt“, sondern Wahrheit im Repo.

Buch-Konzept bleibt gültig. These 7 invers: Stack bleibt; Alignment und Gates steigen.

Buch: Kap. 3–4, Kap. 9 · Material: checklists/copilot-repo-readiness.md, Monorepo-Templates

Agent meldet „fertig“, aber nichts ist prüfbar

Sofort: DoD auf Commands legen (Tight-Loop nach Patch, Slice-DoD vor Hand-off, Heavy in CI). „Sieht gut aus“ ist keine DoD. Exit-Codes non-interactive.

Buch-Konzept bleibt gültig. Ohne agent-verifizierbare DoD kein sinnvoller Loop.

Buch: Kap. 9, Anhang B · Material: command-referenz.md, checklists/dod-*.md, skill-verify-stack

Diff ist riesig, Layer überall angefasst

Sofort: Vertikalen Slice verkleinern (UI ↔ API ↔ Persistenz dünn). Ausschlüsse und „nicht anfassen“ im Task. Diff lesen – Surgical Changes erzwingen.

Buch-Konzept bleibt gültig. Horizontaler Layer-only-Change skaliert schlecht mit Agents.

Buch: Kap. 8, Kap. 13 · Material: task-prompt-fullstack-slice.md, skill-fullstack-slice

Instructions / AGENTS.md greifen nicht oder widersprechen sich

Sofort: Root schlank (Mission, Runtime, Verify-Übersicht, Immer/Nie); Package detailliert. path-instructions statt Root-Essay. Widersprüche aufräumen.

Buch-Konzept bleibt gültig. Progressive Disclosure; weiches Memory ≠ harte Policy.

Buch: Kap. 4, Kap. 10 · Material: templates/agents-md-*.md, copilot-instructions-*.md

Wir nutzen nicht Copilot – Templates passen nicht 1:1

Sofort: Jobs mappen (Instructions, Permissions, Skills, Verify), nicht Dateinamen. Inhalt der Golden-Path-Templates übernehmen; Convention-Datei eures Harness befüllen.

Buch-Konzept bleibt gültig. Prinzipien tool-frei; Copilot = Worked Example.

Buch: Kap. 2, Anhang C · Material: agent-mapping.md

Agent mit zu vielen Rechten / Secrets im Context

Sofort: Permissions enger als menschliche Bequemlichkeit; kein YOLO-Default. Secrets nicht in Chat/Instructions; nur Schema/Store-Referenz. Diff und Security-Pass vor Merge.

Buch-Konzept bleibt gültig. Soft steuert Stil; Hard begrenzt Schaden.

Buch: Kap. 12 · Material: permissions-hints-enterprise.md, skill-security-pass-enterprise

Angular und Spring gleichzeitig – Agent vermischt Konventionen

Sofort: Package-AGENTS.md / path-instructions pro Layer; Session-Fokus auf einen Slice. Commands und Stilregeln stack-spezifisch, nicht root-pauschal.

Buch-Konzept bleibt gültig. Eine Wahrheit pro Package; Root nur Überblick.

Buch: Kap. 5–7, Kap. 10 · Checkliste: session-start-angular-java, dod-angular / dod-spring

ZIP entpackt – und jetzt?

Sofort: In einen bekannten Arbeitsordner entpacken, Root-Templates kopieren und anpassen, Session-Start-Checkliste einmal durchgehen, Verify-Command aus der Command-Referenz an eure Module hängen. PDF/Kapitelquellen sind nicht in den ZIPs.

Buch-Konzept bleibt gültig. Hybrid: Anhang A im Buch + lebende ZIPs hier.

Material: Vorlagen & Checklisten

Command oder UI aus dem Buch heißt anders

Sofort: Primärdoku und --help der gepinnten Version prüfen. Die Phase (Plan, Verify, Compact, Review) zählt – nicht der exakte String im Buch.

Buch-Konzept bleibt gültig. Drift ≠ Erratum; Konzept behalten.

Buch: Kap. 9, Anhang B · Stand: Drift-Liste

Mehr nicht gelöst?

Anti-Patterns und Checklisten im Buch (Kap. 13), dann Feedback mit Kapitel/Seite und kurzer Symptom-Beschreibung. Theorie/Context: Schwester Coding Agents in der Praxis.