Back to projects
Published

The Engineering Forge

Orchestriert eine gehostete GitHub-Spec-Kit-Pipeline: Markdown-Brief rein, implementierungsfertiges Spec-Bundle raus — inklusive Analyze-Gates und Self-Heal.

The Engineering Forge

Overview

Was ist das?

The Engineering Forge nimmt einen Markdown-Brief entgegen und schickt ihn durch eine gehostete GitHub Spec Kit-Pipeline. Ergebnis ist ein Spec-Bundle im Format specs/###-feature/… plus ein zusammengefasstes {featureSlug}-implementation-spec.md, das sich direkt in ein Ziel-Repository legen und mit /speckit.implement weiterverarbeiten lässt.

Die Forge orchestriert Spezifikationen — Anwendungscode erzeugt sie bewusst nicht.

Ablauf

  1. Ingest: POST /api/partner/ingest nimmt Brief und Dateinamen per Bearer-Auth an und antwortet mit 202 und einer jobId
  2. Pipeline: BullMQ-Worker fährt enrich → specify → plan → tasks (FR-Retagging, MVP-Post-Processing) → checklist → quickstart → analyze → pack
  3. Self-Heal: die Analyze-Stufe prüft die Gates und korrigiert bis zu drei Zyklen, bevor gepackt wird
  4. Track & Download: GET /api/jobs/{jobId} liefert den Status, …/download das ZIP sobald READY

Die Job-UUID ist zugleich das Zugriffstoken — Poll und Download brauchen keinen weiteren Login.

Betrieb

Ein Service betreibt Web und Worker gemeinsam, damit Downloads dasselbe Bundle-Dateisystem sehen. Redis läuft als Addon, Bundles liegen auf einem Volume unter /app/storage/spec-bundles.

Stack

Next.js 16, TypeScript, BullMQ, Redis, OpenAPI, Railway.