SpecForge

Specs schmieden, nicht schreiben — Spec-Driven Requirements Engineering als KI-Skill

Claude Skill v2.3 15 Methoden 9 Modi

Was ist SpecForge?

Ein Claude-Skill, der Requirements Engineering von der Idee bis zum implementierungsreifen Backlog automatisiert — mit Governance-Enforcement statt optionalen Richtlinien. Governance ist ein Compiler, kein Komitee.

1

Specify

Aus einer Feature-Idee wird eine vollständige spec.md mit EARS-Requirements, Gherkin-ACs und STRIDE-Analyse.

2

Clarify

Sokratische Spezifikationsklärung: gezielte Fragen zu Stakeholder-Konflikten, Annahmen und Systemgrenzen.

3

Plan & Tasks

Technischer Plan mit ADRs, Morphological Box + Pugh Matrix für Technologieentscheidungen, plus Task-Breakdown.

4

Analyze

MECE-Konsistenzprüfung über 5 Dimensionen mit Re-Analyze-Loop bis keine Blocker offen sind.

5

Checklist

Wiederverwendbare Quality Gates — Spec-Readiness, DSGVO-Compliance oder Custom-Checklisten.

6

Stakeholder-Simulation

Devil's Advocate + Steelmanning: 8 Rollen simulieren Perspektiven und decken blinde Flecken auf.

7

Review

3-Ebenen-Review: Requirement-Qualität, Governance-Compliance, Security & Compliance.

8

Management

Traceability Matrix, Spec-First Chain Audit, Stale-Marker-Erkennung und Tech-Debt-Tracking.

9

Discover

Bestandsdokumentation: Vom Code zur Spec. Zwei QS-Schleifen (Vollständigkeit + Konsistenz/Stringenz) mit Rückwärts-Validierung.

Fremder Code, keine Doku?

Viele Projekte erben Codebases ohne Spezifikation — zugekauft, gewachsen oder schlicht nie dokumentiert. Modus 9 (Discover) macht daraus eine vollwertige Spec:

1

Bestand erfassen

Quellen identifizieren, Architektur und Abhängigkeiten kartieren — automatisch per Discovery-Protokoll.

2

5W-Analyse

Für jedes Modul: Wer, Was, Warum, Wie, Wann — mit Evidenz und Konfidenzlevel statt Vermutungen.

3

Spec generieren

Zwei QS-Schleifen (Vollständigkeit + Konsistenz) liefern eine Spezifikation, die vorwärts weiterverwendbar ist.

Ergebnis: spec.md + discovery-protocol.md + optional migration-delta.md — direkt anschlussfähig an die Modi 1–8.

Workflow

Phase 0 Phase 1 Phase 2 Phase 3 Phase 4 Cynefin+Impact ─── Specify ─── Clarify ─── Plan+Research ─── Tasks │ Phase 8 Phase 7 Phase 6 Phase 5 │ Management ─── Review ─── Implement ─── Analyze ◄──────────────┘ ▲ │ └────┘ Re-Analyze Loop Phase 9: Discover (eigenständiger Einstieg) Bestand ─── Discovery ─── Spec-Gen ─── QS1:Vollständigkeit ─── QS2:Konsistenz ─── Spec

15 Methodische Grundlagen

Jede Methode wird nach dem Aktivieren-Eingrenzen-Prüfen-Muster eingesetzt.

MethodeHerkunftEinsatz
Cynefin FrameworkDave Snowden (1999)Phase 0 — Komplexitätseinschätzung
Impact MappingGojko Adzic (2012)Phase 0 — Scope-Validierung
Socratic MethodPlaton/SokratesClarify-Modus
Five WhysTaiichi Ohno (Toyota)BLOCKER-Analyse
MECE PrincipleBarbara Minto (McKinsey)Analyze-Modus
Devil's Advocate + SteelmanningAdvocatus Diaboli (1587)Stakeholder-Simulation
Morphological Box + Pugh MatrixFritz Zwicky (1940er) / Stuart Pugh (1991)Technologieentscheidungen
DDD (taktisches Design)Eric Evans (2003)Datenmodell in spec.md
BLUF + Pyramid PrincipleUS-Militär / B. MintoSpec-Zusammenfassungen
MoSCoWDai Clegg (DSDM)Story-Priorisierung
ADR nach NygardMichael Nygard (2011)Architecture Decision Records
EARS RequirementsAlistair Mavin (Rolls-Royce)Requirement-Syntax
STRIDEMicrosoftThreat Modeling
BDD / GherkinDan NorthAcceptance Criteria
SSOT (Single Source of Truth)spec.md als autoritative Quelle (GP-02)

10 Golden Principles

GP-01 Schema-Hygiene
GP-02 Spec-before-Code
GP-03 ADR-Disziplin
GP-04 ExecPlan-Pflicht
GP-05 Invariant-Traceability
GP-06 Keine stale Marker
GP-07 Dokument-Platzierung
GP-08 Prinzip-Unverletzlichkeit
GP-09 Abhängigkeitsrichtung
GP-10 Schulden-Tracking

Installation

Claude.ai — Projekt-Knowledge

  1. Claude-Projekt öffnen
  2. Project Knowledge aufrufen
  3. SKILL.md hochladen
  4. Sofort aktiv

Claude Cowork — Plugin/Skill

  1. SKILL.md in Skill-Verzeichnis kopieren
  2. In plugin.json registrieren
  3. Als Skill verfügbar

Claude Code — Projekt-Kontext

  1. SKILL.md in .claude/knowledge/ legen
  2. Optional: In CLAUDE.md referenzieren
  3. Automatisch geladen

Erzeugte Artefakte

constitution.md

Projektprinzipien, Golden Principles, regulatorischer Rahmen, Definition of Done

spec.md

Funktionale Spezifikation mit EARS-Requirements und Gherkin-ACs

plan.md

Technischer Implementierungsplan mit ADRs

research.md

Technische Tiefenrecherche (Versionen, CVEs, Kompatibilität)

quickstart.md

Entwickler-Schnelleinstieg für sofortiges Onboarding

tasks.md

Task-Breakdown mit Spec-First Chain und Parallelisierungsmarkern

discovery-protocol.md

Bestandsaufnahme: Quellenverzeichnis, Vollständigkeitsampel, QS-Protokolle (Modus 9)

migration-delta.md

Ist/Soll-Abweichungen als Grundlage für Modernisierung (Modus 9, optional)