Folge 002: Issues statt Chaos: So behältst du die KI auf Kurs

GitHub ist nicht nur Datei-Ablage, es ist dein Projektbüro. Im Repo legst du ein neues Issue an (Bug, Idee, Feature), wählst optional „Milestone“ (Meilenstein) und „Labels“ (Labels, z. B. Documentation) und speicherst, dann ist es dein Ticket.

Forks und Pull Requests (kurz)

Du kannst fremde Projekte forken, eine Kopie unter deinem Account. Änderst du was Nützliches, schickst du einen Pull Request (PR) an den Originalautor. Der entscheidet, ob er’s übernimmt. hautuu selbst als Vorlage forken: Folge 020. Allein im eigenen Repo? Dann sind Issues trotzdem Gold wert.

„Bitte Issue #1 umsetzen“

Statt jedes Mal die halbe Projektgeschichte zu tippen, sagst du:

Bitte Issue #1 umsetzen.

Der Agent liest Titel und Kommentare. Bei einem öffentlichen Repo kann das jeder mitlesen, deshalb: nie Passwörter, Tokens oder API-Keys committen. Die History vergisst nichts.

In Commit-Messages kannst du Issues erwähnen (Fixes #1, Closes #1). GitHub verlinkt oder schließt das Ticket, du siehst später, welcher Commit was gelöst hat.

Stack-Übersicht

1. Cursor: du arbeitest lokal, commit, push.
2. GitHub: Quelle der Wahrheit.
3. Cloudflare: merkt Änderungen, baut mit Astro.
4. Sveltia: später: Tippfehler im Browser fixen, landet wieder in Git.
5. Astro: macht schnelle statische Seiten (Frontend), kein WordPress, keine Datenbank auf dem Server.

Cloudflare richtest du Schritt für Schritt in Folge 011 ein. Sveltia und PAT/Login: Folge 013.

Issues klein schneiden

„Astro Collections erstellen“ klingt riesig. Die KI kann Sub-Issues vorschlagen (Pages, Articles, Tags …). Dann siehst du Fortschritt statt einen endlosen Klumpen. Was Collections sind, steht in Folge 004.

Vor dem Bauen fragt der Agent oft nach:

• CMS-Login: später per Token oder GitHub (eigenes Thema).
• Direkt auf main: Speichern kann sofort auf den Hauptzweig gehen → Cloudflare baut neu. Simpel, aber jeder Klick kann live werden.
• Bilder „Variante B“: Dateien liegen neben dem Artikel — Astro kann sie optimieren (gut für Page Speed).

Erst lokal gucken

• npm install lädt die Pakete (Abhängigkeiten), die das Projekt braucht. Stehen in package.json, landen lokal in node_modules. Du machst das beim ersten Aufsetzen nach dem Clone, auf einem anderen Rechner oder wenn neue Abhängigkeiten dazukamen. Nicht bei jedem Öffnen des Projekts. Der KI-Agent in Cursor sagt dir das in der Regel oder führt es selbst aus. Schritt für Schritt: Folge 018. Online macht Cloudflare beim Build dasselbe automatisch.
• npm run dev: kurze Vorschau auf deinem Rechner, solange der Server läuft (Strg+C stoppt ihn, siehe Folge 003).

Ist Cloudflare schon dran? Push = Build. Darum pusht der Agent bei hautuu nur auf dein Wort. Pull, Merge und typische Stolpersteine: Folge 006.

In derselben Session ging’s schon um dunkles Theme, grüne Klick-Farbe, Ubuntu-Schrift, und dass Issues besser sind als „hab ich mal im Chat gesagt“.