Gigantische KI-Pull-Requests in reviewbare Stacks zerlegen

AI-Coding-Agenten sind extrem produktiv - aber sie produzieren oft Monster-Pull-Requests mit 1.700+ geaenderten Zeilen, die niemand mehr reviewen will. GitHubs Loesung: Stacked Pull Requests combined mit dem gh stack CLI.

Das Problem

Ein typischer KI-Agent, der eine Produktsuche implementieren soll, schreibt Datenmodell, API-Route, Client-Wiring und UI in einen einzigen Branch. Das Ergebnis ist ein unreviewbarer Diff, der wochenlang ungemerged herumliegt.

Die Stack-Struktur

Stattdessen wird die Arbeit in logische Schichten zerlegt:

• Layer 1: Datenmodell und Seed-Daten (feat/catalog-data)
• Layer 2: Validierte API-Route (feat/search-api)
• Layer 3: Chat-Anbindung an API (feat/chat-grounding)
• Layer 4: UI mit Zitat-Karten (feat/grounded-ui)

Jeder Layer baut auf dem vorherigen auf und ist eigenstaendig reviewbar. Verschiedene Reviewer (Data Owner, Backend, Frontend) konzentrieren sich auf ihren Bereich.

Agenten-Integration

Die gh-stack Skills bringen Coding-Agenten bei, wie Stacks funktionieren. Spezialisierte Agenten (Data Modeler, Backend Agent, Frontend Agent) arbeiten jeweils an ihrem Layer. CI laeuft pro Layer gegen die Stack-Base, nicht gegen main.

Setup

gh extension install github/gh-stack
gh skill install github/gh-stack

Die CLI-Befehle gh stack push und gh stack submit laden alle Branches und erstellen verlinkte Pull-Requests. GitHub zeigt eine Stack-Map fuer einfache Navigation zwischen den PRs.

Quelle: GitHub Blog