Specsmaxxing: Wie man Spezifikationen für KI-Agenten schreibt

Ein neues Paradigma für die KI-Entwicklung

Kennst du das? Ein Feature funktioniert perfekt, dann fällt dir ein wichtiger Edge Case ein, und Claude antwortet: “Du hast völlig recht, lass mich das fixen.” Diesen Zyklus kennt jeder, der mit KI-Tools arbeitet. Der Blog-Post “Specsmaxxing” nennt das “Peak Slop” – und behauptet, wir hätten ihn bereits hinter uns.

Die Lösung liegt nicht in mehr Prompting, sondern in besseren Spezifikationen. Wer hat schon ein README.md und AGENTS.md geschrieben? Dazu noch testing-guide.md, architecture.md, PRD.md? Die These: Dokumentation und unstrukturierte Specs bringen dich sehr weit – viel weiter als Prompts allein.

Von Specs zu Testmaxxing

Der Autor argumentiert für eine strukturierte Herangehensweise: Anstatt dem Agent während der Entwicklung ständig neue Anforderungen hinzuzufügen, sollten wir vorher akzeptieren, dass das Kontext-Fenster das Limit ist. Was passiert, wenn wir es füllen? Oder eine Session beenden? Anforderungen gehen verloren, Details werden zerquetscht.

Die Alternative: YAML-basierte Specs, die als “Acceptance Criteria for AI” (ACAI) fungieren. Ein Open-Source-Toolkit namens acai.sh ermöglicht es, diese Specs zu definieren, zu implementieren, zu reviewen und zu iterieren. Der Workflow unterteilt sich in vier Schritte: Specify, Ship, Review, Iterate.

Ob das funktioniert? Der Beweis liegt in der Praxis – und der Autor behauptet, seine Software sei robuster, besser getestet und besser integriert als je zuvor.

Link: Original bei Acai.sh