Drei Quellen, eine Wahrheit — Validierung des byhaushalt-Parsers gegen PDF und STMFH-Diagramm

Agentic Coding mit Claude Code

Eine Reihe über Software-Entwicklung mit Claude Code — von rohen PDF-Quellen bis zur deploybaren Webanwendung.

Wir bauen mit Claude Code ein vollständiges Software-Projekt — von rohen PDF-Quellen bis zur Webanwendung. Demo-Projekt ist die Visualisierung des bayerischen Haushalts 2026/27. Pro Artikel zeigen wir, welches Werkzeug greift: CLAUDE.md, Plan Mode, Skills, Slash Commands, Subagents, Worktrees, MCP, Hooks und ein vollständiger Deploy. Code lebt offen auf Codeberg, pro Artikel ein Tag zum Mitziehen. Zehn Artikel plus Prolog.

  1. 0

    Was Agentic Coding eigentlich heißt

    Prolog · Serie: Agentic Coding mit Claude Code. Wer sich in diesem Jahr durch Tech-Newsletter, Konferenz-Keynotes und Tool-Landingpages liest, trifft auf zwei Begriffe, die beide mit denselben Versprechen verkauft werden: Vibe Coding und Agentic Coding. Die Zukunft des Programmierens, heißt es.
    8. May 2026
  2. 1

    CLAUDE.md als Briefing

    Artikel 1 der Reihe — wir installieren Claude Code, legen das byhaushalt-Repo an, schreiben die erste Memory-Datei und legen fest, woran sich der Agent in jeder Session zu halten hat. Plus: Permissions, Quelldaten, der erste Tag.
    10. May 2026
  3. 2

    Erkunden statt loslegen — Plan Mode mit Subagents

    Artikel 2 der Reihe — bevor byhaushalt seinen ersten Parser-Code sieht, kartiert Claude Code die PDF-Struktur der bayerischen Haushaltspläne. Plan Mode, Explore-Subagent und Architecture Decision Records als Werkzeuge für das Erkunden vor dem Implementieren.
    10. May 2026
  4. 3

    Eigene Skills schreiben — PDF-Parser-Skill mit pytest TDD

    Artikel 3 der Reihe — der erste Parser-Code für byhaushalt entsteht per TDD: Custom Skill mit Trigger-Description, uv-Setup, sechs Tests vor der Implementation, und wie der Summen-Konsistenz-Test Halluzinationen im PDF-Parsing verhindert.
    11. May 2026
  5. 4

    Slash Commands — Wiederholung wegautomatisieren

    Artikel 4 der Reihe — mit drei Slash Commands wird der Parser wiederholbar: /parse-epl für beliebige Einzelpläne, /check-totals mit eingebautem pytest-Aufruf, /diff-vs-gesamt für den Abgleich gegen den Gesamthaushalt. Plus: was xfail über Parser-Lücken verrät.
    12. May 2026
  6. 5

    Subagent-Driven Development — Datenmodell parallel bauen

    Artikel 5 der Reihe — v0.4 liefert drei JSON-Dateien, kein Datenmodell. Ein Plan-File mit drei Tasks und parallelen Subagents baut Schema, Normalisierung und Property-based Tests. Plus: was Format-Inkonsistenz über Parallelisierung lehrt.
    13. May 2026
  7. 6

    Worktrees — Drei Visualisierungen parallel bauen

    Artikel 6 der Reihe — drei Worktree-Branches, drei Visualisierungen über demselben Datenmodell. Treemap, Sunburst und Sankey nebeneinander vergleichen, statt sequenziell zu raten. Plus: warum die Entscheidung am Ende nicht gegen zwei Verlierer fiel, sondern für einen Switcher.
    16. May 2026
  8. 7

    MCP-Server — Doku-Lookup im Editor

    Artikel 7 der Reihe — zwei MCP-Server, eine Projektkonfiguration: Context7 holt aktuelle Library-Doku direkt in den Editor, bevor Claude raten muss. Plus shadcn/ui-Migration und ein chart-builder-Skill, der Context7 gezielt aufruft.
    16. May 2026
  9. 8

    End-to-End mit Playwright-MCP — Tests die Claude selbst schreibt

    Artikel 8 der Reihe — Markdown-Spec als E2E-Test-Vertrag: Claude liest den User-Flow, exploriert live im Browser über Playwright-MCP, findet robuste Selektoren und schreibt den Playwright-Test. Drei Specs, drei Tests, drei Baseline-Screenshots.
    17. May 2026
  10. 9

    Hooks — Tests als Gate im Hintergrund

    Artikel 9 der Reihe — drei Hooks für byhaushalt: PostToolUse formatiert nach jedem Edit, PreToolUse blockt Commits mit Debug-Resten, Stop läuft schnelle Tests aber nur für geänderte Layer. Warum ein zu aggressiver Stop-Hook mehr schadet als nützt, und warum Playwright in die CI gehört, nicht in den Hook.
    18. May 2026
  11. 10

    Vom Branch zur Live-URL — Worktree-PR-Workflow und Codeberg-Pages-Deploy

    Artikel 10 der Reihe — wie aus einer Vite-SPA im Repo eine Live-Site unter eigener Subdomain wird. Branch-Protection für Solo-Projekte, ein Bash-Skript das via git worktree den pages-Branch befüllt, Custom-Domain über DNS-CNAME plus .domains-Datei, HTTPS via Let's Encrypt. Und warum CI bewusst ein eigener Folge-Artikel wird.
    23. May 2026
  12. 11

    Drei Quellen, eine Wahrheit — Validierung des byhaushalt-Parsers gegen PDF und STMFH-Diagramm

    Bonus-Artikel der Reihe — wie sich der Parser des byhaushalt-Demos gegen zwei voneinander unabhängige Quellen messen lässt: die offiziellen EPL-PDFs des bayerischen Finanzministeriums und das interaktive Haushaltsdiagramm auf stmfh.bayern.de. Σ Einnahmen und Σ Ausgaben treffen die PDF-Σ bit-exakt; die Restdifferenz gegen STMFH ist datenstandsbedingt.
    23. May 2026