Glossar
Eine Kurzreferenz für die Begriffe, die Ihnen in SpecForge begegnen werden — verständlich erklärt, nicht nur für Entwickler.
Spec
Eine Spec (kurz für Spezifikation) ist ein kurzer Plan für eine Funktion oder Änderung, die Sie umsetzen möchten. Stellen Sie sie sich wie einen Vertrag zwischen Ihnen und Ihrer KI vor: Sie beschreibt was gebaut werden soll, wie es funktionieren soll, und wann die Arbeit als fertig gilt.
Beispiel: Eine Spec für "Google-Login" würde enthalten: OAuth-Zugangsdaten einrichten, Login-Button hinzufügen, Benutzersitzung speichern, nach dem Login weiterleiten. Ihre KI liest dies und arbeitet es Schritt für Schritt ab.
Fertig-Checkliste (Done Checklist)
Jede Spec hat eine Fertig-Checkliste — eine Liste von Bedingungen, die alle erfüllt sein müssen, bevor eine Funktion als abgeschlossen gilt. Sie beseitigt Unklarheiten: Statt "läuft irgendwie" wissen Sie genau, welche Punkte abgehakt sind und welche nicht.
Abweichung (Drift)
Eine Abweichung tritt auf, wenn der Code, den Sie entwickelt haben, nicht mehr mit der vereinbarten Spec übereinstimmt. Das ist ganz normal — Anforderungen ändern sich, Abkürzungen werden genommen, Ideen entwickeln sich weiter. SpecForge erkennt Abweichungen und zeigt Ihnen genau, was vom ursprünglichen Plan abgewichen ist.
Warum das wichtig ist: Ohne Abweichungserkennung glauben Sie vielleicht, eine Funktion sei fertig, obwohl wesentliche Teile fehlen oder verändert wurden.
MCP-Server
Ein MCP-Server ist ein Plugin, das Ihr KI-Tool (wie Claude, Cursor oder Windsurf) um neue Fähigkeiten erweitert. SpecForge läuft als MCP-Server direkt auf Ihrem Rechner — Ihre KI kann seine Werkzeuge aufrufen, um Specs zu erstellen, Code zu validieren, Abweichungen zu erkennen und vieles mehr.
Analogie: Stellen Sie es sich wie eine Browser-Erweiterung vor, aber für Ihren KI-Coding-Assistenten.
SDD (Spec-getriebene Entwicklung)
SDD ist ein Entwicklungsansatz, bei dem jede Funktion mit einer klaren Spec beginnt, bevor eine einzige Zeile Code geschrieben wird. Die Spec wird zur einzigen Quelle der Wahrheit — Ihre KI folgt ihr, und Sie validieren dagegen, wenn die Arbeit abgeschlossen ist.
Im Gegensatz zu: Ad-hoc-Entwicklung, bei der Sie im Chat beschreiben, was Sie wollen, und hoffen, dass die KI es richtig versteht.
Projekt
In SpecForge ist ein Projekt ein Ordner auf Ihrem Computer, den Sie mit SpecForge initialisiert haben. Jedes Projekt erhält eine eindeutige ID und speichert alle seine Specs, Entscheidungen und Metriken lokal — ganz ohne Cloud.
Stream
SpecForge ordnet seine 59 Werkzeuge in 8 Streams (A bis H) ein. Jeder Stream gruppiert Werkzeuge, die ähnliche Dinge tun: Planung, Analyse, Design, Auslieferung usw. Sie müssen nicht alle 59 kennen — nur den Stream, der für Ihre aktuelle Aufgabe relevant ist.
Validierung
Validierung bedeutet, dass SpecForge Ihren Code liest und ihn mit der Fertig-Checkliste einer Spec abgleicht. Es zeigt Ihnen, welche Punkte erledigt sind, welche fehlen und was sich gegenüber dem ursprünglichen Plan geändert hat.
Wann verwenden: Nachdem Sie (oder Ihre KI) glauben, dass eine Funktion fertig ist.
Akzeptanzkriterien
Akzeptanzkriterien sind die konkreten Bedingungen, die erfüllt sein müssen, damit eine Spec als abgeschlossen gilt. Es sind die Punkte auf der Fertig-Checkliste. Jedes Kriterium ist konkret und überprüfbar — nicht "Login soll funktionieren", sondern "Benutzer wird nach erfolgreichem Login zu /dashboard weitergeleitet."
Initialisierung
Ein Projekt initialisieren bedeutet, SpecForge auf Ihren Projektordner hinzuweisen, damit es Ihre Codebasis scannen, Ihre Sprache und Ihr Framework erkennen und den lokalen Speicher für Ihre Specs einrichten kann. Das dauert nur wenige Sekunden und muss pro Projekt nur einmal durchgeführt werden.
Muster (Pattern)
Ein Muster ist eine wiederkehrende Lösung, die SpecForge aus Ihrem Projekt gelernt hat. Mit der Zeit kann SpecForge gängige Ansätze in Ihrer Codebasis erkennen und diese beim Erstellen neuer Specs vorschlagen — damit Ihre KI konsistent baut.
Technische Schulden (Tech Debt)
Technische Schulden bezeichnen Arbeit, die aufgeschoben wurde, oder Abkürzungen, die während der Entwicklung genommen wurden. In SpecForge werden technische Schulden separat in der Fortschrittsdatei einer Spec erfasst — sie blockieren eine Spec nicht daran, als "fertig" zu gelten, werden aber festgehalten, damit nichts in Vergessenheit gerät.
Einen Begriff, den Sie gerne hinzugefügt hätten? Hinterlassen Sie unten einen Kommentar oder kontaktieren Sie uns auf npm.