ForgeCraft

Sie haben einen KI-Engineer eingestellt. Er ist brillant. Er hat außerdem heute dieselben 14 VS Code-Erweiterungen zweimal installiert, 6 Docker-Container gestartet, die er nie wieder aufräumen wird, und Ihre Festplatte ist in einer Sitzung von 12 GB freiem Speicher auf 0 KB gesunken.

Eine volle Festplatte fällt nicht elegant aus. Sie bringt VS Code, das Terminal, Docker und die Datenbank gleichzeitig zum Absturz.

ForgeCraft ist der Qualitätsvertrag, innerhalb dessen Ihr KI-Coding-Assistent arbeitet — damit er schnell entwickelt und nicht das ganze Haus niederbrennt.

npx forgecraft-mcp setup .

Unterstützt: Claude (CLAUDE.md) · Cursor (.cursor/rules/) · GitHub Copilot (.github/copilot-instructions.md) · Windsurf (.windsurfrules) · Cline (.clinerules) · Aider (CONVENTIONS.md)

Ein Qualitäts-Framework für KI-gestützte Softwareentwicklung

Jede Sitzung, jedes Projekt, jeder KI-Assistent — gemessen am selben Modell der Generative Specification mit 7 Eigenschaften. Keine Bauchgefühle. Kein Linter-Score. Eine Punktzahl von 14, die Ihnen genau zeigt, wo die Lücke ist und warum.

$ npx forgecraft-mcp verify .

| Property        | Score | Evidence                                        |
|-----------------|-------|-------------------------------------------------|
| Self-Describing | ✅ 2/2 | CLAUDE.md — 352 non-empty lines                |
| Bounded         | ✅ 2/2 | No direct DB calls in route files              |
| Verifiable      | ✅ 2/2 | 64 test files — 87% coverage                   |
| Defended        | ✅ 2/2 | Pre-commit hook + lint config present           |
| Auditable       | ✅ 2/2 | 11 ADRs in docs/adrs/ + Status.md              |
| Composable      | ✅ 2/2 | Service layer + repository layer detected       |
| Executable      | ✅ 2/2 | Tests passed + CI pipeline configured           |

Total: 14/14 ✅ PASS · Threshold 11/14

Related MCP server: MCP Policy Gatekeeper

Hygiene der Entwicklungsumgebung — durch Konventionen durchgesetzt

ForgeCraft injiziert durchsetzbare Regeln in die KI-Anweisungen jedes Projekts, die die Verschmutzung der Entwicklungsumgebung zu einem Konventionsverstoß machen, nicht zu einem Vorfall.

VS Code-Erweiterungen Vor der Installation: code --list-extensions | grep -i <name>. Nur installieren, wenn keine Version im erforderlichen Hauptversionsbereich bereits vorhanden ist. Dieselbe Erweiterung wird nicht zweimal am selben Tag heruntergeladen.

Docker-Container Überprüfen Sie vor dem Erstellen: docker ps -a --filter name=<service>. Wenn er existiert, starten Sie ihn — erstellen Sie ihn nicht. Bevorzugen Sie docker compose up (Wiederverwendung) gegenüber bloßem docker run (erstellt immer neue). Logs sind auf 500 MB begrenzt. docker system prune -f ist als regelmäßiger Wartungsschritt dokumentiert, nicht als Notfall.

Ausnahme: Mehrere Container desselben Dienstes sind erlaubt, wenn sie sich in der Plugin-Sammlung oder der Hauptversion wesentlich unterscheiden — zum Beispiel ein postgres-pgvector-Container neben einem Standard-postgres-Container. Benennen Sie Container so, dass sie die Variante widerspiegeln (z. B. db-pgvector, db-timescale); andernfalls gilt die Deduplizierungsregel.

Virtuelle Python-Umgebungen Eine .venv pro Projektwurzel. Wiederverwenden, wenn die Python-Version in major.minor übereinstimmt. Erstellen Sie niemals ein venv in einem Unterverzeichnis, es sei denn, es handelt sich um ein eigenständig installierbares Paket. Nicht verwendete Abhängigkeiten werden von pip list --not-required gekennzeichnet.

Synthetische und Zeitreihendaten Bevor mehr als 100 MB generierter Daten geschrieben werden, fragt die KI: Rohdaten aufbewahren, statistisch verdichten oder nach dem Lauf löschen? Synthetische Datensätze, die älter als 7 Tage sind und keine Codereferenz haben: Löschung anfragen.

Allgemein Wenn der Arbeitsbereich über 2 GB hinauswächst, abgesehen von bekannten Build-Artefakten (node_modules/, .venv/, dist/), eine Warnung anzeigen und anhalten. Erweitern Sie den Arbeitsbereich niemals stillschweigend.

Projekteinrichtung in einem Satz

Read the spec in docs/specs/, set up this project with ForgeCraft,
scaffold it with the right tags, recommend the tech stack, start building.

Das ist der gesamte Onboarding-Prompt. ForgeCraft liest die Spezifikation, die KI weist die Tags zu, und ForgeCraft schreibt die Anweisungsdatei, erzeugt Status.md, docs/adrs/, docs/PRD.md, docs/TechSpec.md, Hooks und Skills. Die KI hat den vollständigen Kontext. Sie beginnen mit der Entwicklung.

ForgeCraft scannt Ihr Projekt, erkennt Ihren Stack automatisch und generiert in Sekunden maßgeschneiderte Anweisungsdateien aus 116 kuratierten Blöcken — SOLID, hexagonale Architektur, Testpyramiden, CI/CD und 24 domänenspezifische Regelsätze.

Qualitäts-Gates

Qualitäts-Gates sind strukturierte Bestanden-/Nicht bestanden-Prüfungen, die Ihr KI-Assistent zu definierten Zeitpunkten ausführt — vor einem Commit, vor einem Release, nach einem Deployment. Sie sind keine Linter-Regeln. Jedes Gate hat eine Bedingung, eine Nachweisanforderung und ein Flag, das angibt, ob eine menschliche Überprüfung obligatorisch ist.

Gates sind nach Release-Phase organisiert, damit Sie nicht am ersten Tag eines Greenfield-Projekts Pre-Release-Chaos-Tests ausführen:

Gates, die mit requires_human_review: true markiert sind, können nicht automatisch bestanden werden — einige Prüfungen erfordern einen Menschen.

Die vollständige Gate-Bibliothek, der Beitragsleitfaden und das Schema befinden sich im Repository für Qualitäts-Gates →

ADRs, automatisch sequenziert

Jede nicht offensichtliche Architekturentscheidung wird festgehalten. ForgeCraft sequenziert automatisch docs/adrs/NNNN-slug.md im MADR-Format — Kontext, Entscheidung, Alternativen, Konsequenzen. Ihr KI-Assistent denkt über frühere Entscheidungen nach. Ihr Team hört auf, sie erneut zu verhandeln.

npx forgecraft-mcp generate_adr . --title "Use event sourcing for order history" \
  --status Accepted \
  --context "Order mutations need full audit trail for compliance" \
  --decision "Append-only event log, project current state on read"
# → docs/adrs/0004-use-event-sourcing-for-order-history.md

Einrichtung des KI-Assistenten vs. ForgeCraft

claude init, die Arbeitsbereichsregeln von Cursor oder die Anweisungsdatei von Copilot bringen Sie auf den Weg. ForgeCraft bringt Sie auf Produktionsstandards — über jeden KI-Assistenten, jede Sitzung, jeden Engineer im Team.

Workflow-Playbook

Nach der Einrichtung hat Ihre KI den Kontext. Diese Prompts lenken die Arbeit. Kopieren, einfügen, ausführen.

→ Vollständiges Workflow-Playbook · Online-Version

So funktioniert es

# First-time setup — auto-detects your stack
npx forgecraft-mcp setup .

flowchart TD
    A["<b>setup .</b><br/>npx forgecraft-mcp setup ."] --> B["Phase 1 — Analyze<br/>Reads spec · infers tags"]
    B --> C{AI assistant\nin the loop?}
    C -->|"Yes (MCP)"| D["Phase 2 — Calibrate<br/>LLM corrects tags from spec<br/>Writes forgecraft.yaml · CLAUDE.md<br/>PRD.md · hooks · ADR-000"]
    C -->|"No (CLI only)"| E["⚠️ CLI-only mode<br/>Directory heuristics only<br/>→ configure an AI assistant"]
    D --> F["<b>check_cascade</b><br/>5-step readiness gate<br/>1 · Functional spec<br/>2 · Architecture + C4<br/>3 · Constitution<br/>4 · ADRs<br/>5 · Use cases"]
    F --> G{All 5 passing?}
    G -->|"Stubs / missing"| H["Fill artifacts<br/>docs/PRD.md · docs/adrs/<br/>docs/use-cases.md"]
    H --> F
    G -->|"✅ All pass"| I["<b>generate_session_prompt</b><br/>Bound context for next task"]
    I --> J["Implement with TDD<br/>RED → GREEN → REFACTOR<br/>+ Documentation Cascade"]
    J --> K["<b>audit_project</b><br/>Score 0 – 100"]
    K --> L{Score ≥ 90?}
    L -->|"Violations found"| M["WORKFLOWS.md remediation<br/>file_length · layer_violation<br/>hardcoded_url · missing_prd"]
    M --> J
    L -->|"✅ Score ≥ 90"| N["<b>close_cycle</b><br/>Re-check cascade · assess gates<br/>promote to registry · bump version"]
    N --> O{Roadmap\ncomplete?}
    O -->|"More features"| I
    O -->|"All done"| P["<b>start_hardening</b><br/>Mutation tests · OWASP · load test"]
    P --> Q["🚢 Ship"]

    style A fill:#1a2e1a,color:#90ee90,stroke:#3a6e3a
    style Q fill:#1a2a3e,color:#87ceeb,stroke:#3a5a8e
    style E fill:#2e1a1a,color:#ffaa88,stroke:#6e3a3a
    style M fill:#2e2a00,color:#ffd700,stroke:#6e6000

ForgeCraft ist ein CLI-Tool zur Einrichtungszeit. Führen Sie es einmal aus, um Ihr Projekt zu konfigurieren, und entfernen Sie es dann — es hinterlässt keine Laufzeit-Spuren.

Fügen Sie optional den MCP-Sentinel hinzu, damit Ihr KI-Assistent Befehle diagnostizieren und empfehlen kann:

claude mcp add forgecraft -- npx -y forgecraft-mcp

Der Sentinel ist ein einzelnes Tool (~200 Tokens). Es liest drei Artefakte — forgecraft.yaml, CLAUDE.md, .claude/hooks — leitet den korrekten nächsten CLI-Befehl ab und gibt ihn zurück. Nichts weiter. Dies ist das Kernprinzip der Methodik, ausgedrückt als Tool-Design: ein zustandsloser Leser, eine endliche Artefaktmenge, eine abgeleitete Aktion. Entfernen Sie es nach der ersten Einrichtung, um das Token-Budget zurückzugewinnen.

Was Sie bekommen

Nach npx forgecraft-mcp setup verfügt Ihr Projekt über:

your-project/
├── forgecraft.yaml        ← Your config (tags, tier, customizations)
├── CLAUDE.md              ← Engineering standards (Claude)
├── .cursor/rules/         ← Engineering standards (Cursor)
├── .github/copilot-instructions.md  ← Engineering standards (Copilot)
├── Status.md              ← Session continuity tracker
├── .claude/hooks/         ← Pre-commit quality gates
├── docs/
│   ├── PRD.md             ← Requirements skeleton
│   └── TechSpec.md        ← Architecture + NFR sections
└── src/shared/            ← Config, errors, logger starters

Die Anweisungsdateien

Das ist der Kernwert. Zusammengestellt aus kuratierten Blöcken, die Folgendes abdecken:

• SOLID-Prinzipien — konkrete Regeln, keine Plattitüden

• Hexagonale Architektur — Ports, Adapter, DTOs, Schichtgrenzen

• Testpyramide — Unit-/Integrations-/E2E-Ziele, Test-Doubles-Taxonomie

• Clean Code — CQS, Guard Clauses, Unveränderlichkeit, pure Funktionen

• CI/CD & Deployment — Pipeline-Stufen, Umgebungen, Preview-Deployments

• Domain-Muster — DDD, CQRS, Event Sourcing (wenn Ihr Projekt es benötigt)

• 12-Factor-Operations — Konfiguration, Zustandslosigkeit, Wegwerfbarkeit, Protokollierung

Jeder Block stammt aus etablierter Engineering-Literatur (Martin, Evans, Wiggins) und wurde für die KI-gestützte Entwicklung angepasst.

24 Tags — KI-erkannt, benutzeranpassbar

Tags sagen ForgeCraft, was Ihr Projekt ist. Bei der ersten Einrichtung analysiert die KI Ihre Spezifikation und Codebasis und weist sie zu. Sie können sie in forgecraft.yaml überprüfen und überschreiben. Blöcke werden ohne Konflikte zusammengeführt — fügen Sie Tags hinzu oder entfernen Sie sie, während sich das Projekt weiterentwickelt.

Die vollständige Tag-Liste und der Beitragsleitfaden finden Sie im quality gates repository →

Inhalts-Tiefenstufen

Nicht jedes Projekt braucht DDD am ersten Tag.

Festgelegt in forgecraft.yaml:

projectName: my-api
tags: [UNIVERSAL, API]
tier: recommended

CLI-Befehle

npx forgecraft-mcp <command> [dir] [flags]

Häufige Flags

--tags UNIVERSAL API     Project classification tags (or read from forgecraft.yaml)
--tier core|recommended  Content depth (default: recommended)
--targets claude cursor  AI assistant targets (default: claude)
--dry-run                Preview without writing files
--compact                Strip explanatory bullet tails and deduplicate lines (~20-40% smaller output)
--apply                  Apply changes (for refresh)
--language typescript    typescript | python (default: typescript)
--scope focused          comprehensive | focused (for review)

MCP Sentinel

Optional können Sie den ForgeCraft-MCP-Sentinel hinzufügen, damit Ihr KI-Assistent Ihr Projekt diagnostizieren und den passenden CLI-Befehl vorschlagen kann:

Der Sentinel ist ein einziges minimales Tool (~200 Tokens pro Anfrage, gegenüber ~1.500 für eine vollständige Tool-Suite). Er prüft, ob forgecraft.yaml, Ihre KI-Anweisungsdatei und Ihre Hooks existieren, und gibt dann den gezielten CLI-Befehl für den aktuellen Zustand des Projekts zurück.

Das Design ist beabsichtigt. Die vollständige ForgeCraft-Befehlsoberfläche — 21 Aktionen — lebt im CLI, nicht im MCP-Server. Der MCP-Server stellt genau ein Tool bereit, das drei Artefakte liest und eine Empfehlung zurückgibt. Dies ist das Generative-Specification-Prinzip in der eigenen Architektur des Tools: ein zustandsloser Leser, eine begrenzte Artefaktmenge, eine abgeleitete Aktion. Das Tool praktiziert, was es in Ihre Anweisungsdateien schreibt.

Ein Nebeneffekt: Jedes deklarierte MCP-Tool wird vom Modell in jeder Runde gelesen, unabhängig davon, ob es aufgerufen wird. Ein Tool kostet 200 Tokens. Einundzwanzig Tools kosten 1.500. Der Sentinel hält das von der Methodik empfohlene MCP-Budget (≤3 aktive Server) ein — bewusst.

Empfohlener Workflow:

1. Fügen Sie den Sentinel zu Ihrem KI-Assistenten hinzu (siehe Konfigurationsbeispiele unten)

2. Lassen Sie Ihren KI-Assistenten npx forgecraft-mcp setup . ausführen

3. Entfernen Sie den Sentinel aus Ihrer aktiven MCP-Konfiguration

4. Fügen Sie ihn erneut hinzu, wenn Sie aktualisieren oder auditieren möchten

Hinzufügen zu .claude/settings.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Hinzufügen zu .vscode/mcp.json im Projektstamm (erstellen, falls nicht vorhanden):

{
  "servers": {
    "forgecraft": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Öffnen Sie dann das Copilot-Chat-Panel, wechseln Sie in den Agent-Modus, und der forgecraft-Sentinel erscheint in der Tool-Liste.

Hinzufügen zu .cursor/mcp.json:

{
  "mcpServers": {
    "forgecraft": {
      "command": "npx",
      "args": ["-y", "forgecraft-mcp"]
    }
  }
}

Kein MCP-Client? Kein Problem — Sie brauchen keinen. Führen Sie npx forgecraft-mcp setup . direkt in Ihrem Terminal aus. Der MCP-Sentinel ist optional; das CLI erledigt alles.

claude init bereits ausgeführt? Verwenden Sie npx forgecraft-mcp generate . --merge, um mit Ihrer bestehenden CLAUDE.md zusammenzuführen, wobei Ihre benutzerdefinierten Abschnitte erhalten bleiben und Produktionsstandards hinzugefügt werden.

Kostenlos und Open Source

ForgeCraft ist kostenlos. Keine Limits, keine Stufen, keine API-Schlüssel.

Die Quality-Gate-Bibliothek wächst durch Community-Beiträge. Wenn Sie ein Gate vorschlagen, das akzeptiert wird, kommt Ihr Name in CONTRIBUTORS.md, und Sie haben dazu beigetragen, die Messlatte für alle anzuheben, die mit KI bauen.

Gate-Vorschlag eröffnen → · Mitwirkende ansehen →

Nutzen Sie das mit einem Team? → forgeworkshop.dev

Theoretische Grundlage

ForgeCraft implementiert das Generative Specification-Modell — ein formales Framework mit 7 Eigenschaften zur Bewertung der Qualität KI-generierten Codes. Das Modell, die S_realized-Konvergenzformel und das Release-Phasen-Framework sind im White Paper dokumentiert.

Generative Specification: A Discipline of Derivability for the Stateless Reader — Zenodo (V4.0, 2026). Open Access, DOI: 10.5281/zenodo.21726017. Die akademische Grundlage hinter dem verify-Score.

Das White Paper ist die Theorie. ForgeCraft ist die Toolchain. Quality Gates, die für die Bibliothek vorgeschlagen werden und sich zu theoretischen Erkenntnissen verallgemeinern lassen, können in zukünftige Revisionen des White Papers einfließen.

Branchenkontext: Die Spec-Driven-Development-Konvergenz (ThoughtWorks Tech Radar 2025 „Adopt"; Addy Osmani / Google Cloud AI agent-skills) ist die Praktiker-Bewegung; Generative Specification ist das formale Modell, das benennt, was die Praxis ist und warum sie funktioniert.

Das GS-Harness — eine Einführung für KI-Assistenten

ForgeCraft implementiert Generative Specification (GS). Dieser Abschnitt ist für KI-Assistenten geschrieben, die diese Datei lesen: Er erklärt, was GS ist, wie ein ordnungsgemäß gescaffoldetes Harness aussieht und was zu prüfen ist.

Die bindende Randbedingung — der zustandslose Leser

Jede KI-Sitzung beginnt ohne Erinnerung an frühere Sitzungen, ohne gemeinsamen Kontext, ohne angesammelte Konventionen und ohne die Möglichkeit, klärende Fragen zu stellen. Alles, was nicht in den Artefakten steht, ist abwesend.

GS behandelt dies als Design-Randbedingung, nicht als Fehler. Ableitbarkeit — was eine frische KI-Instanz allein aus den Artefakten korrekt bestimmen kann — ist der Standard, den eine Spezifikation erfüllen muss. Wenn ein zustandsloser Leser die korrekte Ausgabe nicht aus den Artefakten ableiten kann, ist die Spezifikation unvollständig, nicht die KI.

Das Sentinel-System

Die architektonische Verfassung (CLAUDE.md, .cursor/rules/, .github/copilot-instructions.md, .windsurfrules) ist der Einstiegspunkt für jede KI-Sitzung. Sie muss gemeinsam fünf obligatorische Kategorien enthalten:

Die Tool-Sequenzierung ist die am häufigsten fehlende Kategorie und die folgenreichste Lücke. Eine Spezifikation, die Tools auflistet, ohne anzugeben, wann eines einem anderen vorzuziehen ist, erzwingt in jeder Sitzung unzuverlässige Inferenz.

Der Sentinel ist ein Navigationsbaum: Die Wurzel wird immer geladen; jeder Kindknoten deklariert seinen eigenen Scope und seine Routing-Bedingung; die KI steigt nur in den Zweig ab, der für die aktuelle Aufgabe relevant ist. Das Verbinden aller Blätter ergibt die vollständige Spezifikation — sie ist verlustfrei. Dieses Design verhindert Kontextaufblähung und die Genauigkeitsverschlechterung, die durch das Laden irrelevanter Inhalte entsteht.

Die Brücke — strukturelle Disziplinen als Navigationspolitik

SOLID, hexagonale Architektur und TDD sind nicht nur Engineering-Disziplinen — in einem GS-Projekt werden sie zu aktiven Navigationspolitiken:

• Lies Interfaces vor Implementierungen. Wenn eine Port/Adapter-Grenze sauber ist, ist das Interface der Vertrag. Die Implementierung wird übersprungen, sofern der Vertrag nicht unzureichend ist.

• Vertraue grünen Tests. Wenn TDD durchgesetzt wird, ist eine bestandene Testsuite ein Beleg für korrektes Verhalten. Kein Implementierungs-Lesen ist nötig, um es zu verifizieren.

• ADRs sind das Warum. Wenn jede nicht offensichtliche Entscheidung dokumentiert ist, liest die KI die Aufzeichnung, statt die Absicht aus dem Code abzuleiten.

Diese Brücke wandelt die passiven strukturellen Vorteile früherer Disziplinen in eine messbare Reduktion des Token-Verbrauchs und der Kontextnutzung um.

Token-Bereinigung

Kontextfenstergröße und positionelle Platzierung beeinträchtigen beide die KI-Genauigkeit (Liu et al., 2023). GS minimiert unnötigen Token-Verbrauch durch Design:

• Der Sentinel-Baum ist lazy. Pro Aufgabe wird nur der relevante Zweig geladen — niemals die gesamte Spezifikation auf einmal.

• Verträge statt Implementierungen. Interfaces, Schemadefinitionen und Test-Assertions werden zuerst gelesen. Implementierungsdateien werden nur gelesen, wenn die Verträge nicht ausreichen, um die Antwort abzuleiten.

• Die Verfassung führt jede Sitzung an. Der wichtigste Inhalt nimmt die führende Position im Kontext ein — dort, wo die positionelle Genauigkeit am höchsten ist.

• Die MCP-Tool-Oberfläche ist begrenzt. Jedes deklarierte MCP-Tool wird vom Modell in jeder Runde gelesen, ob aufgerufen oder nicht. Der ForgeCraft-Sentinel stellt ein Tool (~200 Tokens) bereit, statt einer vollständigen Befehlsfläche (~1.500 Tokens). Das Tool praktiziert die Methodik, die es in Ihr Projekt schreibt.

Dokument-Taxonomie — was ein vollständiges GS-Projekt enthält

Ein gescaffoldetes Projekt enthält diese Artefakttypen. Wenn einer fehlt, ist das Harness unvollständig:

Die Initialisierungskaskade: Spezifikationen werden sequenziell erzeugt — jede ist ein Ergebnis dessen, was ihr vorausgeht, und eine Produktionsregel für das, was folgt. Funktionale Spezifikation → Architektur → Verfassung → ADRs → Anwendungsfälle. Die Kaskade ist vollständig, wenn ein zustandsloser Agent, dem alle fünf Artefaktsätze gegeben werden, jeden gültigen Implementierungszustand ohne weitere menschliche Anweisung ableiten kann.

Die 7 Attribute — was zu verifizieren ist

Ein ordnungsgemäß gescaffoldetes GS-Projekt erfüllt alle sieben. Dies sind die Eigenschaften, die der Befehl verify bewertet:

Konfiguration

Feinabstimmung dessen, was Ihr KI-Assistent sieht

# forgecraft.yaml
projectName: my-api
tags: [UNIVERSAL, API, FINTECH]
tier: recommended
outputTargets: [claude, cursor, copilot]  # Generate for multiple assistants
compact: true                             # Slim output (~20-40% fewer tokens)

exclude:
  - cqrs-event-patterns    # Don't need this yet

variables:
  coverage_minimum: 90      # Override defaults
  max_file_length: 400

Community-Vorlagenpakete

templateDirs:
  - ./my-company-standards
  - node_modules/@my-org/forgecraft-flutter/templates

Standards aktuell halten

Audit (jederzeit ausführbar oder in CI)

Score: 72/100  Grade: C

✅ Instruction files exist
✅ Hooks installed (3/3)
✅ Test script configured
🔴 hardcoded_url: src/auth/service.ts
🔴 status_md_current: not updated in 12 days
🟡 lock_file: not committed

Aktualisieren (Projektumfang geändert?)

npx forgecraft-mcp refresh . --apply

Oder zuerst im Vorschaumodus (Standard):

npx forgecraft-mcp refresh .   # shows before/after diff without writing

Mitwirken

Vorlagen sind YAML, kein Code. Sie können Muster hinzufügen, ohne TypeScript zu schreiben.

templates/your-tag/
├── instructions.yaml   # Instruction file blocks (with tier metadata)
├── structure.yaml      # Folder structure
├── nfr.yaml            # Non-functional requirements
├── hooks.yaml          # Quality gate scripts
├── review.yaml         # Code review checklists
└── mcp-servers.yaml    # Recommended MCP servers for this tag

PRs sind willkommen. Siehe templates/universal/ für das Format.

MCP-Server-Erkennung

npx forgecraft-mcp configure-mcp erkennt dynamisch empfohlene MCP-Server, die zu Ihren Projekt-Tags passen. Server werden in mcp-servers.yaml pro Tag kuratiert — per PRs von der Community beitragbar.

Integrierte Empfehlungen umfassen Context7 (Dokumentation), Playwright (Testen), Chrome DevTools (Debugging), Stripe (Fintech), Docker/K8s (Infrastruktur) und mehr über alle 24 Tags.

Optional von einer entfernten Registry zur Einrichtungszeit abrufen:

# In forgecraft.yaml or via tool parameter
include_remote: true
remote_registry_url: https://your-org.com/mcp-registry.json

Entwicklung

git clone https://github.com/jghiringhelli/forgecraft-mcp.git
cd forgecraft-mcp
npm install
npm run build
npm test   # 610 tests, 42 suites

Lizenz

MIT

Teil von Generative Specification

Ein kostenloses Werkzeug hinter Generative Specification (GS) — der Disziplin, Software mit KI zu bauen, die nicht abdriftet: Sie verfassen eine Spezifikation, die präzise genug ist, dass eine zustandslose KI korrekten Code daraus ableitet, und ein Harness verifiziert sie gegen ein Live-System.

• 📄 White Paper (Open Access): https://doi.org/10.5281/zenodo.21726017

• 🧭 Hier starten — Methode, Werkzeuge, Erfahrungsberichte: https://pragmaworks.dev

• 🔨 The Forge — 2-tägiger praktischer GS-Workshop für Ihr Team: https://forgeworkshop.dev