Spezifikationsgetriebene Entwicklung mit Claude Code und Cursor

Claude Code ist ein agentisches Coding-Werkzeug, das eine Codebasis liest, Dateien bearbeitet und Befehle ausführt. Cursor ist der Editor, dessen Projektregeln in .cursor/rules als .mdc-Dateien liegen. Spezifikationsgetriebene Entwicklung (SDD) ist die Praxis, die Spezifikation vor dem Code zu schreiben und die Spezifikation als Quelle der Wahrheit zu behandeln. Ein Produktanforderungsdokument (PRD) ist die Prosa, die das Problem und den Umfang nennt, bevor die Arbeit in Aufgaben zerlegt wird. In SpecScore ist eine Feature-Spezifikation die Datei für eine Produktfähigkeit, eine Anforderung (REQ) eine benannte Regel in diesem Feature, und ein Akzeptanzkriterium (AC) eine optionale abstrakte Bedingung, die auf eine oder mehrere dieser Regeln zeigt. Kontinuierliche Integration (CI) ist eine automatische Prüfung bei jeder vorgeschlagenen Änderung. Die Prüfung ist ein Befehl der Kommandozeile (CLI), specscore spec lint, aus der CLI in specscore/specscore-cli. Cursor-Spezifikationen sind auf dieser Seite diese Feature-Datei zusammen mit der Cursor-Projektregel, die dem Agenten sagt, sie zu linten.

Zuletzt aktualisiert: 6. November 2026

Was in das Feature gehört und was in die Agenten-Datei

Die Feature-Datei enthält die Verpflichtung. Ein Feature-README unter spec/features/ trägt die Regeln #### REQ: und die Kriterien ### AC:. Die ausgefüllte Form, der Plan und die Aufgabe sind die PRD-Vorlage in Markdown. specscore spec lint prüft diese Form: Überschriften, Pflichtabschnitte, Indexzeilen und Verweise. Es entscheidet nicht, ob die Produktidee eine gute ist. Spezifikationen in CI linten ist die längere Darstellung des Befehls.

Die Agenten-Datei enthält Anweisungen für ein Werkzeug. Die Übersicht von Anthropic sagt, dass CLAUDE.md eine Markdown-Datei im Projektwurzelverzeichnis ist, die Claude Code zu Beginn jeder Sitzung liest. Die Rules-Dokumentation von Cursor sagt, dass eine Projektregel eine .mdc-Datei in .cursor/rules ist und dass eine einfache .md-Datei in diesem Verzeichnis ignoriert wird, weil sie kein Frontmatter hat. Diese Dateien sagen dem Agenten, wie er im Repository arbeiten soll. Sie sind nicht die Spezifikation, die der Linter prüft. Eine Anforderung, die nur in CLAUDE.md oder nur in .cursor/rules/specscore.mdc steht, ist für specscore spec lint unsichtbar.

Was specscore agent setup schreibt

Das CLI-README sagt, dass specscore agent setup die Instruktionsdatei jedes Agenten schreibt und, wo dieser Agent ein Skills-Verzeichnis hat, SpecScore-Skill-Bündel dorthin kopiert. Der Befehl überspringt eine vorhandene Datei, außer du übergibst --force. Der Vertrag ist das Feature agent-setup in specscore/specscore-cli.

Dieser Vertrag ordnet die Caller-Id claude CLAUDE.md und .claude/skills/ zu, und die Caller-Id cursor .cursor/rules/specscore.mdc und .cursor/skills/. Führe den Befehl in einem Projekt aus, das bereits specscore.yaml hat. Fehlt diese Datei, endet der Befehl mit 6 und die Meldung schlägt specscore init vor. Ein Aufruf, der beide Agenten nennt, ist specscore agent setup claude,cursor. Das Feature sagt, eine kommagetrennte Liste sei dasselbe wie getrennte Argumente. Übergeordnete Verzeichnisse werden angelegt. Jeder Pfad wird als hinzugefügt, geändert oder übersprungen gemeldet.

Die erzeugte CLAUDE.md enthält den Projekttitel, CLI-Beispiele, die --caller claude übergeben, und die Installationszeile /plugin install specscore@specscore. Die Cursor-Datei ist Markdown mit YAML-Frontmatter. Das Frontmatter enthält description und alwaysApply: true. Die Rules-Tabelle von Cursor sagt, alwaysApply: true bedeute, dass die Regel in jedem Chat enthalten ist. --no-skills schreibt die Instruktionsdateien und kopiert keine Skill-Bündel. Dieselbe Vertragstabelle nennt außerdem codex, copilot, antigravity.google, pi.dev, opencode und deepseek. Diese Seite folgt den beiden Agenten im Titel.

Schreibt die Dateien von Claude Code und Cursor. Führe es aus einem Projekt aus, das specscore.yaml hat.

specscore agent setup claude,cursor

Pfade, die der Vertrag claude und cursor zuordnet. Skill-Verzeichnisse werden nicht angelegt, wenn du --no-skills übergibst. Eine vorhandene Datei bleibt, wie sie ist, außer du übergibst --force.

CLAUDE.md
.claude/skills/
.cursor/rules/specscore.mdc
.cursor/skills/

Die Instruktionsdatei zeigt auf den Feature-Baum. Sie ersetzt ihn nicht. Nach dem Setup muss Claude Code weiterhin spec/features/ lesen, und die Regel von Cursor muss weiterhin auf denselben Baum zeigen. Die Feature-Spezifikation bleibt das Dokument, das specscore spec lint annimmt oder ablehnt.

Führe specscore spec lint in der Schleife aus

Installiere zuerst die CLI. Die Installationsmethoden stehen auf der Installationsseite. Halte danach das Feature und den Linter in derselben Schleife wie den Agenten.

Schreib das Feature vor dem Prompt

Füge das Feature-README, die Zeile im Feature-Index und specscore.yaml mit der PRD-Vorlage hinzu. Setze jede Verpflichtung unter ## Behavior als #### REQ: {slug}. Zeige mit **Requirements:** von den Akzeptanzkriterien auf diese Ids. Lass CLAUDE.md und .cursor/rules/ für den nächsten Schritt.

Linte, bevor der Agent Code bearbeitet

Führe specscore spec lint im Repository aus. Ein sauberer Baum gibt 0 violations found aus und endet mit 0. Der Fehlerbericht — Datei, Zeile, Schweregrad, Regel, Meldung — steht in Spezifikationen in CI linten. Korrigiere das Feature, bis dieser Befehl sauber ist. Ein Agent, der von einem Feature ausgeht, das der Linter schon ablehnt, kopiert die kaputte Form.

Richte Claude Code und Cursor auf den Baum

Führe specscore agent setup claude,cursor aus. Lies die hinzugefügte CLAUDE.md und .cursor/rules/specscore.mdc und prüfe, dass sie den Spec-Baum und die CLI nennen, einschließlich --caller. Wenn eine der beiden Dateien schon vorhanden war, überspringt der Befehl sie. Übergib --force nur, wenn du diese Datei ersetzen willst.

Bitte um eine Aufgabe, die ein Kriterium nennt

Nenne in der Agenten-Sitzung das Feature und das Akzeptanzkriterium, das die Arbeit erfüllen muss. Eine Plan-Aufgabe tut das mit **Verifies:** und einer Akzeptanzkriterium-Id. Bitte den Agenten, specscore spec lint vor dem Abschluss erneut auszuführen und die Feature-Datei zu ändern, wenn sich das Verhalten ändert. Die Instruktionsdatei sagt dem Agenten, den Befehl auszuführen. Die Feature-Datei ist das, was der Befehl prüft.

Skills, die lint, feature und task bereitstellen

Die Installationszeilen im CLI-README für das Wrapper-Plugin sind /plugin marketplace add specscore/ai-marketplace und /plugin install specscore@specscore. Das Plugin-Repository ist specscore/ai-plugin-specscore, unter der MIT-Lizenz. Sein Skills-README sagt, Nutzer rufen /specscore:<skill-name> auf. Die mitgelieferten Wrapper umfassen /specscore:spec, das specscore spec lint umhüllt; /specscore:feature, das specscore feature umhüllt (list, info, tree, deps, refs, new und change-status); und /specscore:task, das specscore task umhüllt. /specscore:change-status deckt Statusänderungen von Feature und Idee ab. Die Seite CLI Skills auf dieser Website ist dieser Wrapper. specscore agent setup kopiert diese Skill-Bündel nach .claude/skills/ und .cursor/skills/, außer du übergibst --no-skills.

Das Plugin-README sagt, Cursor habe keinen Befehl zur Ferninstallation und lade Skills aus .cursor/skills/ im Projekt oder aus ~/.cursor/skills/. Die manuelle Kopie, die es zeigt, ist git clone von ai-plugin-specscore und cp -R von skills/* nach .cursor/skills/. specscore agent setup cursor ist der Befehl, der diese Kopie für dich ausführt, aus dem Marketplace, den die Feature-Spezifikation nennt.

SpecStudio Skills ist der geführte Ablauf. Das Repository ist specscore/specstudio-skills, unter der MIT-Lizenz. Die Claude-Code-Installationszeile seines README ist /plugin install specstudio@specscore, und sie sagt, Claude Code installiere das Plugin specscore als Abhängigkeit. Der Statusabschnitt nennt Version 0.0.7 und sagt, die Skills ideate, specify, plan, implement, verify und recap seien aktiv genug, um sie im eigenen Projekt zu verwenden (Dogfood). Die Inventartabelle desselben README dokumentiert specstudio:ideate und specstudio:specify im Detail. Diese Skills schreiben SpecScore-Artefakte. Sie ersetzen specscore spec lint nicht.

Derselbe Befehl in CI

dogfood.yml in specscore/specscore setzt SPECSCORE_VERSION auf v0.39.1 und führt specscore spec lint bei Pull Requests und bei Pushes auf main aus. Der Workflow-Auszug und der Textbericht stehen in Spezifikationen in CI linten. Ein Feature, das eine Überschrift bricht, lässt diesen Job fehlschlagen, ob Claude Code oder Cursor die Datei geschrieben hat. Die Agentenschleife und CI rufen denselben Befehl auf.

Die Lizenz des Formats ist CC BY 4.0 in specscore/specscore. Die Lizenz der CLI ist Apache-2.0 in specscore/specscore-cli.

Andere spezifikationsgetriebene Werkzeuge veröffentlichen andere Prüfungen. Die Sätze unten verwenden nur, was die eigenen Seiten dieser Projekte sagen. Die Werkzeugrunde verzeichnet dieselben Seiten als gelesen am 30. Oktober 2026, außer der Dokumentationsstartseite von Spec Kit, die den 28. September 2026 druckt.

OpenSpec dokumentiert openspec validate in seiner CLI-Referenz. Dieser Befehl prüft die Struktur der Änderungen und Spezifikationen von OpenSpec. Er prüft keine Überschrift ### AC: von SpecScore.

Das README von Task Master beschreibt, ein PRD mit task-master parse-prd in Aufgaben zu zerlegen. Es beschreibt keinen Linter für dieses PRD.

GitHub Spec Kit beschreibt einen Agenten-Workflow, dessen Phasen Markdown-Artefakte schreiben. Diese Dokumentationsstartseite beschreibt keinen Befehl, der ein SpecScore-Feature-README in CI lintet.

FAQ

Was ist Claude Code spec-driven development?

Es ist, das SpecScore-Feature zu schreiben, bevor Claude Code den Code schreibt, und danach CLAUDE.md als die Instruktionsdatei zu behalten, die auf dieses Feature zeigt. Das Feature enthält die Anforderungen (REQ) und die Akzeptanzkriterien (AC). specscore spec lint prüft das Feature. specscore agent setup claude schreibt CLAUDE.md in einem Projekt, das bereits specscore.yaml hat.

Wohin gehören die Cursor-Spezifikationen?

Die Produktverpflichtung steht im Feature-README unter spec/features/. Die Cursor-Projektregel steht in .cursor/rules/specscore.mdc. Skill-Dateien stehen in .cursor/skills/. specscore agent setup cursor schreibt die Regel und kopiert, außer du übergibst --no-skills, die Skill-Bündel. Cursors eigene Dokumentation ist die Quelle dafür, wie .mdc-Regeln angewendet werden.

Ersetzt CLAUDE.md die Feature-Spezifikation?

Nein. CLAUDE.md ist das, was Claude Code als Anweisungen liest. Das Feature-README ist das, was specscore spec lint prüft. Das Feature agent-setup sagt, die erzeugte Datei lehre den Agenten den Spec-Baum und die CLI-Befehle. Es sagt nicht, die Instruktionsdatei sei die Spezifikation.

Was ist, wenn CLAUDE.md oder die Cursor-Regel schon existiert?

Der Befehl überspringt die vorhandene Datei und gibt eine Zeile aus, die das Überspringen meldet und --force erwähnt. Die vorhandenen Bytes bleiben. Übergib --force nur, wenn Ersetzen das ist, was du willst. Dieselbe Überspring-Regel gilt für eine Skill-Datei, die schon vorhanden ist.

Welcher Skill führt den Linter aus?

Im Skills-README des Plugins umhüllt /specscore:spec specscore spec lint. Du kannst diesen CLI-Befehl auch selbst ausführen, in der Agenten-Sitzung oder in CI. /specscore:feature und /specscore:task umhüllen die Feature- und Task-Befehle. Sie linten nicht von selbst.

Benotet der Linter die Prosa?

Nein. specscore spec lint prüft die Struktur. Spezifikationen in CI linten zeigt den Bericht. Eine saubere Strukturprüfung ist keine Produktprüfung.

Quellen

Das Verhalten von agent-setup ist der Vertrag in specscore-cli spec/features/cli/agent/setup/README.md auf main, gelesen am 6. November 2026. Die Skill-Namen stammen aus ai-plugin-specscore skills/README.md auf main, gelesen am selben Tag. Die Installationszeile von SpecStudio und die Statusliste der Version 0.0.7 stammen aus specstudio-skills README.md auf main, gelesen am selben Tag. Die Beschreibung von Claude Code und der Satz zu CLAUDE.md stammen von code.claude.com/docs/en/overview. Die Pfade der Cursor-Projektregeln stammen von cursor.com/docs/rules. dogfood.yml in diesem Repository setzt SPECSCORE_VERSION auf v0.39.1. Die Seiten der Wettbewerber sind die unten verlinkten; die Werkzeugrunde verzeichnet sie als gelesen am 30. Oktober 2026, außer der Dokumentationsstartseite von Spec Kit, die den 28. September 2026 druckt.