# Spezifikationsgetriebene Entwicklung mit Claude Code und Cursor

Canonical: https://specscore.md/de/articles/claude-code-specs/

Zuletzt aktualisiert: 6. November 2026

[Claude Code](https://code.claude.com/docs/en/overview) ist ein agentisches Coding-Werkzeug, das eine Codebasis liest, Dateien bearbeitet und Befehle ausführt. [Cursor](https://cursor.com/docs/rules) ist der Editor, dessen Projektregeln in `.cursor/rules` als `.mdc`-Dateien liegen. [Spezifikationsgetriebene Entwicklung](https://specscore.md/de/spec-driven-development/) (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](https://specscore.md/) ist eine [Feature-Spezifikation](https://specscore.md/feature-specification) die Datei für eine Produktfähigkeit, eine [Anforderung](https://specscore.md/requirement-specification) (REQ) eine benannte Regel in diesem Feature, und ein [Akzeptanzkriterium](https://specscore.md/acceptance-criteria-specification) (AC) eine optionale abstrakte Bedingung, die auf eine oder mehrere dieser Regeln zeigt. [Kontinuierliche Integration](https://specscore.md/de/validators/) (CI) ist eine automatische Prüfung bei jeder vorgeschlagenen Änderung. Die Prüfung ist ein Befehl der [Kommandozeile](https://specscore.md/de/cli/) (CLI), `specscore spec lint`, aus der CLI in [specscore/specscore-cli](https://github.com/specscore/specscore-cli). Cursor-Spezifikationen sind auf dieser Seite diese Feature-Datei zusammen mit der Cursor-Projektregel, die dem Agenten sagt, sie zu linten.

## 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](https://specscore.md/de/articles/feature-spec-template/). `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](https://specscore.md/de/articles/lint-specs-in-ci/) 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](https://github.com/specscore/specscore-cli/blob/main/README.md) 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](https://github.com/specscore/specscore-cli/blob/main/spec/features/cli/agent/setup/README.md) in [specscore/specscore-cli](https://github.com/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.

```text
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.

```text
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](https://specscore.md/feature-specification) 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](https://specscore.md/de/cli/install/). 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](https://specscore.md/de/articles/feature-spec-template/) 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](https://specscore.md/de/articles/lint-specs-in-ci/). 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](https://github.com/specscore/ai-plugin-specscore), unter der [MIT-Lizenz](https://github.com/specscore/ai-plugin-specscore/blob/main/LICENSE). Sein [Skills-README](https://github.com/specscore/ai-plugin-specscore/blob/main/skills/README.md) 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](https://specscore.md/de/ai/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](https://github.com/specscore/ai-plugin-specscore/blob/main/README.md) 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](https://specscore.md/de/ai/specstudio-skills/) ist der geführte Ablauf. Das Repository ist [specscore/specstudio-skills](https://github.com/specscore/specstudio-skills), unter der [MIT-Lizenz](https://github.com/specscore/specstudio-skills/blob/main/LICENSE). 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](https://github.com/specscore/specscore/blob/main/.github/workflows/dogfood.yml) in [specscore/specscore](https://github.com/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](https://specscore.md/de/articles/lint-specs-in-ci/). 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](https://github.com/specscore/specscore/blob/main/LICENSE) in [specscore/specscore](https://github.com/specscore/specscore). Die Lizenz der CLI ist [Apache-2.0](https://github.com/specscore/specscore-cli/blob/main/LICENSE) in [specscore/specscore-cli](https://github.com/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](https://specscore.md/de/spec-driven-development/tools/) verzeichnet dieselben Seiten als gelesen am 30. Oktober 2026, außer der Dokumentationsstartseite von Spec Kit, die den 28. September 2026 druckt.

[OpenSpec](https://github.com/Fission-AI/OpenSpec) dokumentiert `openspec validate` in seiner [CLI-Referenz](https://openspec.dev/docs/cli). 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](https://github.com/eyaltoledano/claude-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](https://github.github.io/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](https://github.com/specscore/specscore-cli/blob/main/spec/features/cli/agent/setup/README.md) 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](https://specscore.md/de/articles/lint-specs-in-ci/) 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.

- [Claude Code — Übersicht (CLAUDE.md)](https://code.claude.com/docs/en/overview)
- [Cursor — Rules (Projektregeln sind .mdc-Dateien)](https://cursor.com/docs/rules)
- [specscore-cli — Feature agent-setup](https://github.com/specscore/specscore-cli/blob/main/spec/features/cli/agent/setup/README.md)
- [specscore-cli — README (agent setup und Plugin-Installation)](https://github.com/specscore/specscore-cli/blob/main/README.md)
- [specscore/specscore-cli](https://github.com/specscore/specscore-cli)
- [specscore-cli — Apache-2.0-Lizenz](https://github.com/specscore/specscore-cli/blob/main/LICENSE)
- [specscore/specscore](https://github.com/specscore/specscore)
- [specscore/specscore — Lizenz CC BY 4.0](https://github.com/specscore/specscore/blob/main/LICENSE)
- [specscore/specscore — dogfood.yml (CLI v0.39.1)](https://github.com/specscore/specscore/blob/main/.github/workflows/dogfood.yml)
- [specscore/ai-plugin-specscore](https://github.com/specscore/ai-plugin-specscore)
- [ai-plugin-specscore — MIT-Lizenz](https://github.com/specscore/ai-plugin-specscore/blob/main/LICENSE)
- [ai-plugin-specscore — Skills-README](https://github.com/specscore/ai-plugin-specscore/blob/main/skills/README.md)
- [ai-plugin-specscore — README (Kopie für Cursor)](https://github.com/specscore/ai-plugin-specscore/blob/main/README.md)
- [specscore/specstudio-skills](https://github.com/specscore/specstudio-skills)
- [specstudio-skills — MIT-Lizenz](https://github.com/specscore/specstudio-skills/blob/main/LICENSE)
- [specstudio-skills — README (Version 0.0.7)](https://github.com/specscore/specstudio-skills/blob/main/README.md)
- [CLI Skills](https://specscore.md/de/ai/cli-skills/)
- [SpecStudio Skills](https://specscore.md/de/ai/specstudio-skills/)
- [PRD-Vorlage in Markdown für KI-Coding](https://specscore.md/de/articles/feature-spec-template/)
- [Spezifikationen in CI linten mit einem Spezifikationslinter](https://specscore.md/de/articles/lint-specs-in-ci/)
- [Feature-Spezifikation](https://specscore.md/feature-specification)
- [Spezifikation der Akzeptanzkriterien](https://specscore.md/acceptance-criteria-specification)
- [OpenSpec-CLI-Referenz — openspec validate](https://openspec.dev/docs/cli)
- [Fission-AI/OpenSpec](https://github.com/Fission-AI/OpenSpec)
- [eyaltoledano/claude-task-master](https://github.com/eyaltoledano/claude-task-master)
- [Dokumentation von GitHub Spec Kit (Seitendatum 28. September 2026)](https://github.github.io/spec-kit/)
- [Werkzeuge für spezifikationsgetriebene Entwicklung](https://specscore.md/de/spec-driven-development/tools/)

## Verwandt

- [PRD-Vorlage in Markdown für KI-Coding](https://specscore.md/de/articles/feature-spec-template/)
- [Spezifikationen in CI linten mit einem Spezifikationslinter](https://specscore.md/de/articles/lint-specs-in-ci/)
- [Akzeptanzkriterien schreiben, die ein KI-Agent prüfen kann](https://specscore.md/de/articles/acceptance-criteria/)
- [EARS-Anforderungssyntax erklärt, mit Beispielen](https://specscore.md/de/articles/ears-requirements/)
- [Spezifikationsgetriebene Entwicklung](https://specscore.md/de/spec-driven-development/)
- [Werkzeuge für spezifikationsgetriebene Entwicklung](https://specscore.md/de/spec-driven-development/tools/)
- [CLI Skills](https://specscore.md/de/ai/cli-skills/)
- [SpecStudio Skills](https://specscore.md/de/ai/specstudio-skills/)
- [CLI](https://specscore.md/de/cli/)
- [Feature-Spezifikation](https://specscore.md/feature-specification)