OpenSpec: A Spec-Driven Workflow for AI Coding Assistants (No API Keys Needed)
Zusammenfassung
Kurz
Der Autor beschreibt OpenSpec als Ablauf, bei dem Anforderungen zuerst als Vorschlag und Spezifikation festgehalten, gemeinsam geprüft, anschließend von einer KI umgesetzt und danach archiviert werden. Er sieht darin eine Möglichkeit, Missverständnisse durch vergessene Chat-Pläne zu verringern; die positiven Aussagen zur Zuverlässigkeit beruhen jedoch auf seiner persönlichen Darstellung, nicht auf einer systematischen Prüfung.
Mittel
Der Bericht beschreibt OpenSpec als CLI-Werkzeug, das KI-Coding-Assistenten mit dokumentierten Spezifikationen steuern soll. Der Autor meint, dass Pläne im Chat nach einem Kontextwechsel verloren gehen und Assistenten dadurch Anforderungen verfehlen können. OpenSpec soll Abhilfe schaffen, indem ein Vorschlag erstellt, die Spezifikation gemeinsam geprüft, der genehmigte Plan umgesetzt und die Änderung anschließend in die Hauptspezifikationen archiviert wird. Die Änderungshistorie bleibe in `openspec/changes/` erhalten.
Anhand von Profilfiltern und Zwei-Faktor-Authentifizierung zeigt der Text, wie Vorschläge, Akzeptanzkriterien und konkrete Aufgaben festgehalten werden können. Für die Einrichtung nennt er Node.js 20.19+, eine globale npm-Installation und `openspec init`; für Cursor, Claude Code und Copilot würden Befehle eingerichtet. Bei anderen Assistenten könne man einen OpenSpec-Vorschlag direkt anfordern.
Der Autor berichtet von einer schnellen Einrichtung und empfiehlt das Werkzeug als Ergänzung zum bisherigen Workflow. Aussagen, OpenSpec verhindere fehlende Features oder lasse die KI exakt nach Vorgabe bauen, sind seine Einschätzungen. Eine systematische Prüfung oder unabhängige Bewertung liefert der Bericht nicht.
Ausführlich lesen
Der Bericht stellt OpenSpec als leichtgewichtiges Kommandozeilenwerkzeug für einen spezifikationsgesteuerten Arbeitsablauf mit KI-Coding-Assistenten vor. Der Autor, Code Coup, beschreibt das Problem so: Assistenten wie Claude, Cursor oder Copilot könnten schnell Code erzeugen, improvisierten aber mitunter an den Anforderungen vorbei. Außerdem gehe ein im Chat formulierter Plan verloren, wenn der Gesprächskontext zurückgesetzt werde. OpenSpec solle Anforderungen deshalb in Projektdateien festhalten und vor der Implementierung sichtbar machen, worauf sich Mensch und KI geeinigt haben.
Der dargestellte Ablauf hat vier Schritte: Zuerst wird ein Änderungsvorschlag erstellt, entweder vom Menschen oder mit Hilfe der KI. Danach werden Spezifikation und Akzeptanzkriterien gemeinsam geprüft und angepasst. Erst anschließend setzt die KI den freigegebenen Plan um, laut Bericht Aufgabe für Aufgabe. Zum Schluss wird die Änderung archiviert und in die Hauptspezifikationen übernommen; die Dateien unter `openspec/changes/` bewahren zugleich die Änderungshistorie.
Als Beispiel führt der Autor eine Suche nach Profilen anhand von Rolle und Team an. OpenSpec lege dafür unter anderem `proposal.md`, `tasks.md` und eine Spezifikation für das Profil an. Ein weiteres Beispiel zeigt Anforderungen für Zwei-Faktor-Authentifizierung: eine Pflicht zum zweiten Faktor beim Login sowie Aufgaben wie ein OTP-Geheimnis in der Datenbank, ein Prüf-Endpunkt und eine Eingabekomponente. Diese Beispiele veranschaulichen, wie Anforderungen und Umsetzungsschritte dokumentiert werden sollen.
Zur Einrichtung nennt der Bericht Node.js 20.19 oder neuer sowie die globale Installation von `@fission-ai/openspec` über npm und den Aufruf von `openspec init` im Projekt. Für Cursor, Claude Code und Copilot würden Integrationen mit OpenSpec-Befehlen eingerichtet; bei anderen Assistenten könne man die Erstellung eines Vorschlags direkt anweisen.
Der Autor sagt, die Einrichtung habe bei ihm zwei Minuten gedauert und OpenSpec habe seine früher verstreuten Notizen mit dem KI-Arbeitsablauf verbunden. Er beschreibt das Werkzeug als Ergänzung zum bestehenden Workflow und vergleicht die Archivierung lose mit Git für Spezifikationen. Seine Aussagen, OpenSpec verhindere zufälliges Verhalten oder fehlende Funktionen und lasse die KI genau das Gewollte bauen, sind Einschätzungen des Autors, keine im Bericht belegten Testergebnisse. Der Text schildert persönliche Erfahrungen und Beispiele, enthält aber keinen systematischen Vergleich, keine unabhängige Prüfung und keine näheren Angaben zu möglichen Grenzen des Werkzeugs.
Gegengeprüft von Claude Haiku 5.5: ok
Es liegen zwei Fassungen von Lunas Zusammenfassung vor. Bewertet wurde die mittlere Fassung; die kurze ist ebenfalls treu und enthält keine erfundenen Angaben. Bei den Sammelfragen fehlen Teilfragen, daher blieb der Abschnitt 'je Teilfrage' leer.
Im Bericht, aber nicht in der Zusammenfassung
- Der Vergleich mit Git ("Feels somewhat like Git, but for specs") und die Einordnung des Archivierens als Aktualisierung der Projektspezifikationen fehlen.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Vorfälle melden
- SF-M4 Wie kommen Meldungen von Laboren, Betreibern und Nutzern schnell und geschützt zu den Stellen, die handeln müssen, auch über Grenzen hinweg?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 44 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
Tempo und Grenzen
- SF-T3 Woran erkennt man, dass KI beginnt, ihre eigene Weiterentwicklung voranzutreiben, und wer darf das erlauben?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 51 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 61 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Vertrauen in Modelle
- SF-V1 Was zählt als Beleg für die Werte eines Modells, wenn sein sichtbares Denken und seine Selbstauskünfte allein nicht genügen?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 47 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 49 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- SF-V3 Halten die Werte eines Modells, wenn niemand zusieht oder die Lage neu ist?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 47 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 75 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- SF-V4 Was für ein Wesen ist ein Modell, und was folgt daraus für den Umgang mit ihm und für den Wert des Menschseins?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 25 %einzelne zitierbare Belege
- amos 56 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- SF-V5 Was soll heute für das Verhalten und den Betrieb von Modellen gelten?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 43 %einzelne zitierbare Belege
- amos 39 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 52 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Agenten und vernetzte Systeme
- SF-A1 Welche Befugnisse darf ein KI-Agent haben, also eine KI, die selbstständig mit Werkzeugen handelt? Wer entzieht sie ihm, und wie prüft man, dass er in seinem Auftrag bleibt?
- clef 100 %kein Bezug
- Luna 23 %Hintergrund, keine Belege
- JEV 39 %einzelne zitierbare Belege
- amos 33 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung Hintergrund, keine Belege
- SF-A3 Welche Gefahren entstehen, wenn viele KI-Systeme zusammenwirken oder dieselbe Infrastruktur teilen?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 41 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
Beteiligung und Gemeinwohl
- SF-E4 Wie bleibt KI ein gemeinsames Gut, statt Abhängigkeit und Marktmacht zu vertiefen?
- clef 100 %kein Bezug
- Luna 39 %Hintergrund, keine Belege
- JEV 34 %einzelne zitierbare Belege
- amos 44 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung gleiches Oberthema, hilft nicht
- SF-E5 Welche Mitsprache haben die Menschen, die mit KI leben, bei Tempo und Grenzen, und welche Entscheidungen müssen bei ihnen bleiben?
- clef 100 %kein Bezug
- Luna 30 %Hintergrund, keine Belege
- JEV 48 %beantwortet teilweise oder widerspricht
- amos 46 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung Hintergrund, keine Belege
Weitere Berichte zu diesen Fragen
- Was für ein Wesen ist ein Modell, und was folgt daraus für den Umgang mit ihm und für den Wert des Menschseins?
- Was soll heute für das Verhalten und den Betrieb von Modellen gelten?
- Welche Befugnisse darf ein KI-Agent haben, also eine KI, die selbstständig mit Werkzeugen handelt? Wer entzieht sie ihm, und wie prüft man, dass er in seinem Auftrag bleibt?
- Wie bleibt KI ein gemeinsames Gut, statt Abhängigkeit und Marktmacht zu vertiefen?
- Welche Mitsprache haben die Menschen, die mit KI leben, bei Tempo und Grenzen, und welche Entscheidungen müssen bei ihnen bleiben?
- Alle Berichte im Archiv