OpenSpecSpezifikationsgetriebene Entwicklung für KI-Assistenten

→ flüssig, nicht starr
→ iterativ, nicht wasserfallartig
→ einfach, nicht komplex
→ gebaut für Bestandsprojekte, nicht nur für Neuanfänge
→ skalierbar von persönlichen Projekten bis hin zu Unternehmen

Folge @0xTab auf X für Updates · Tritt dem OpenSpec Discord bei für Hilfe und Fragen.

Es in Aktion sehen ​

Du: /opsx:propose add-dark-mode
KI:  Erstellt openspec/changes/add-dark-mode/
     ✓ proposal.md — warum wir das tun, was sich ändert
     ✓ specs/       — Anforderungen und Szenarien
     ✓ design.md    — technischer Ansatz
     ✓ tasks.md     — Implementierungs-Checkliste
     Bereit zur Implementierung!

Du: /opsx:apply
KI:  Implementiere Aufgaben...
     ✓ 1.1 Theme-Kontext-Provider hinzufügen
     ✓ 1.2 Toggle-Komponente erstellen
     ✓ 2.1 CSS-Variablen hinzufügen
     ✓ 2.2 localStorage anbinden
     Alle Aufgaben abgeschlossen!

Du: /opsx:archive
KI:  Archiviert nach openspec/changes/archive/2025-01-23-add-dark-mode/
     Spezifikationen aktualisiert. Bereit für das nächste Feature.

Schnellstart ​

Erfordert Node.js 20.19.0 oder höher.

Installiere OpenSpec global:

npm install -g @fission-ai/openspec@latest

Navigiere dann zu deinem Projektverzeichnis und initialisiere:

cd dein-projekt
openspec init

Sag jetzt deiner KI: /opsx:propose <was-du-bauen-willst>

Wenn du den erweiterten Arbeitsablauf (/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:sync, /opsx:bulk-archive, /opsx:onboard) möchtest, wähle ihn mit openspec config profile aus und wende ihn mit openspec update an.

Dokumentation ​

→ Loslegen: Erste Schritte
→ Arbeitsabläufe: Kombinationen und Muster
→ Befehle: Slash-Befehle & Skills
→ CLI: Terminal-Referenz
→ Unterstützte Tools: Tool-Integrationen & Installationspfade
→ Konzepte: Wie alles zusammenpasst
→ Mehrsprachig: Mehrsprachige Unterstützung
→ Anpassung: Mache es dir zu eigen

Warum OpenSpec? ​

KI-Coding-Assistenten sind mächtig, aber unvorhersehbar, wenn Anforderungen nur in der Chat-Historie leben. OpenSpec fügt eine leichte Spezifikationsschicht hinzu, damit ihr euch einigt, was gebaut werden soll, bevor auch nur eine Zeile Code geschrieben wird.

• Einigen, bevor du baust — Mensch und KI stimmen sich über Spezifikationen ab, bevor Code geschrieben wird
• Organisiert bleiben — Jede Änderung bekommt ihren eigenen Ordner mit Vorschlag, Spezifikationen, Design und Aufgaben
• Flüssig arbeiten — Aktualisiere jederzeit jedes Artefakt, keine starren Phasentore
• Nutze deine Tools — Funktioniert mit über 20 KI-Assistenten über Slash-Befehle

Wie wir im Vergleich abschneiden ​

vs. Spec Kit (GitHub) — Gründlich, aber schwerfällig. Starre Phasentore, viel Markdown, Python-Setup. OpenSpec ist leichter und lässt dich frei iterieren.

vs. Kiro (AWS) — Mächtig, aber du bist an deren IDE gebunden und auf Claude-Modelle beschränkt. OpenSpec funktioniert mit den Tools, die du bereits nutzt.

vs. nichts — KI-Coding ohne Spezifikationen bedeutet vage Prompts und unvorhersehbare Ergebnisse. OpenSpec bringt Vorhersehbarkeit ohne den Aufwand.

OpenSpec aktualisieren ​

Paket aktualisieren

npm install -g @fission-ai/openspec@latest

Agenten-Anweisungen auffrischen

Führe dies in jedem Projekt aus, um die KI-Anleitung neu zu generieren und sicherzustellen, dass die neuesten Slash-Befehle aktiv sind:

openspec update

Hinweise zur Nutzung ​

Modellauswahl: OpenSpec funktioniert am besten mit Modellen mit hoher Reasoning-Fähigkeit. Wir empfehlen Opus 4.5 und GPT 5.2 sowohl für die Planung als auch für die Implementierung.

Kontext-Hygiene: OpenSpec profitiert von einem sauberen Kontextfenster. Leere deinen Kontext, bevor du mit der Implementierung beginnst, und pflege eine gute Kontext-Hygiene während deiner gesamten Sitzung.

Beiträge leisten ​

Kleine Korrekturen — Fehlerbehebungen, Tippfehlerkorrekturen und kleinere Verbesserungen können direkt als PRs eingereicht werden.

Größere Änderungen — Für neue Funktionen, signifikante Refactorings oder architektonische Änderungen reiche bitte zuerst einen OpenSpec-Änderungsvorschlag ein, damit wir uns über Absicht und Ziele einigen können, bevor mit der Implementierung begonnen wird.

Beim Schreiben von Vorschlägen behalte die OpenSpec-Philosophie im Hinterkopf: Wir dienen einer Vielzahl von Nutzern über verschiedene Coding-Agenten, Modelle und Anwendungsfälle hinweg. Änderungen sollten für alle gut funktionieren.

KI-generierter Code ist willkommen — solange er getestet und verifiziert wurde. PRs mit KI-generiertem Code sollten den verwendeten Coding-Agenten und das Modell erwähnen (z.B. "Generiert mit Claude Code unter Verwendung von claude-opus-4-5-20251101").

Entwicklung ​

• Abhängigkeiten installieren: pnpm install
• Bauen: pnpm run build
• Testen: pnpm test
• CLI lokal entwickeln: pnpm run dev oder pnpm run dev:cli
• Konventionelle Commits (einzeilig): type(scope): subject

Sonstiges ​

Lizenz ​

MIT