Content-Agent-Lernapp

A learning app for German vocational training that turns a keyword such as a trade name into a course built from official sources, checks every question with an LLM judge, and publishes only what passes.

Live: content-agent-ashen-nu.vercel.app · sample data without an account: /lernpfad?demo=1

Why

Apprentices preparing for their exams need material that follows the official framework curriculum, and generic AI text invents facts without saying where they come from. This app runs a pipeline of research, plan, generate (Claude) and evaluate (an OpenAI judge), and a content guard blocks publishing when a unit lacks a source with retrieval date or the AI label. The repo builds itself: an agent loop picks Linear issues, opens pull requests and merges them only after lint, tests, build, axe and Lighthouse pass, observed from the separate Leitstand.

Architecture

Runtime and API details: docs/ARCHITECTURE.md. Pilot course: Maschinen- und Anlagenführer (MAF); a second course for Industriekaufleute is generated by the same pipeline.

Quick start

git clone https://github.com/siinanXD/Content-Agent-Lernapp && cd Content-Agent-Lernapp
npm ci
npm run dev        # http://127.0.0.1:43123, works without keys (in-memory mock store)

What I learned

1. A quality gate only holds if it sits in the publish path: the content guard rejects a course with HTTP 422 instead of logging a warning.
2. Generated content needs an undo: every change to units and questions is versioned by a database trigger (content_versions), so a bad run can be rolled back.
3. Accessibility checks belong in the merge gate (axe on every route, keyboard, Lighthouse a11y ≥ 0.9), not in a later audit.

License

No open-source license: all rights reserved (owner decision, SIN-752).

---

Lern-App, die aus einem Schlagwort (Pilot: Maschinen- und Anlagenführer) einen Kurs aus amtlichen Quellen erzeugt und aktuell hält. Die folgenden Abschnitte beschreiben Entwicklung und Betrieb.

Stack (current)

Layer	Choice
App	Next.js 16 + React 19 + TypeScript + Tailwind 4
Hosting	Vercel
Persistence	Supabase EU (AP-17) with in-memory mock fallback
Quality / tracing	Langfuse Cloud EU — JS/TS SDK v5 / platform v4 OTEL (SIN-197)
Ops scaffold	Hermes weekly source check + Telegram (AP-10/AP-16)
Models	Claude for generate (Batch); OpenAI mini as judge (D-06/D-07)

Docs

• docs/ops/SIN-438-grants.md — Tabellenrechte prüfen, transaktionaler Migrationstest und Rückkehrverfahren.

• Verbrauch von Bau-/Reparaturläufen wird privat in Linear gespeichert; öffentliche PR-Steckbriefe und Tages-Updates zeigen diese Beträge nicht. Der Wochenleser liest private Kommentare mit Seitenabruf und dedupliziert Laufkennungen; historische PR-Marker bleiben vorübergehend lesbar.

• docs/PRODUCT.md — Konzept und Bauplan AP-00–AP-12

• docs/DECISIONS.md — Architekturentscheidungen mit Links

• docs/ARCHITECTURE.md — Runtime- und API-Überblick

• AGENTS.md — Entscheidungs- und Stopp-Regeln

• docs/LANDKARTE.md — Repo-Landkarte: wo liegt was, Befehle, Konventionen (SIN-320)

• docs/autonomy/groessen.md — Größen der Issues, Modell und Runden je Größe, Bündeln, Verbrauch (SIN-320)

• docs/content/README.md — Curriculum-Maps (AP-13): MAF in allen fünf Schwerpunkten und Industriekaufleute 2024

• docs/content/DIDAKTIK.md — Didaktik-Vorgabe (AP-18): Schablone je Einheit, Fragestufen, Wiederholung, Prüfungsmodus, Bilder

Local development

npm install
npm run dev

Dev server: http://127.0.0.1:43123 (npm run dev → port 43123).

Learner UI (AP-08 + AP-18 Didaktik)

Playable path (Figma approved by Sinan 2026-10-02; Didaktik D-31):

0. / Startseite für Bildungsträger (Scroll-Story), /willkommen App-Einstieg
1. /start — Schlagwort + Lernvariante → Kurs erzeugen
2. /lernpfad — Module/Blöcke, Wiederholung, Prüfungsmodus
3. /einheit/unit-03 — sections + alle 5 Fragetypen (+ Bildfragen)
4. /wiederholung — Leitner 1/3/7/14
5. /pruefung — schriftliche Teile aus exam.gradedParts (MAF PT/PP/WiSo)
6. /ergebnis — Punkte + Ampel je Gebiet
7. /profil — Fortschritt, Stapelgröße, Prüfungsreife

Beispielmodus ohne Konto (SIN-408): /lernpfad?demo=1 schaltet für die Browser-Sitzung erfundene Beispieldaten ein (Ergebnis, Wiederholung, Profil, Serie). Es wird nichts gespeichert oder gesendet; ?demo=0 beendet ihn. /quellen zeigt die Quelle je Einheit mit Abrufdatum. Gruppenansicht: /ausbilder?demo=1 (SIN-385). Ausbilder (SIN-415): /ausbilder/zugang?code=… löst den Einladungslink ein, /ausbilder/gruppen zeigt mehrere Gruppen und die Zugänge „x von y vergeben“, /ausbilder/archiv die archivierten Gruppen (Archivieren statt Löschen). Organisation, Kontingent und Einladungslinks legt der Admin unter /admin an (SIN-416): Reiter Organisationen (Zugänge „x von y“, Status, Link erzeugen, neue Organisation), Anfragen (demo_requests) und Alle Kurse. Die Rolle admin steht in app_metadata und wird nur mit dem Service-Role-Key gesetzt (supabase.auth.admin.updateUserById(id, { app_metadata: { role: "admin" } })); der Server prüft sie bei jeder Anfrage.

Design source: Figma · tokens in docs/design/. Phase-A SVGs: npm run content:mermaid.

npm run check:fast        # Lint, Typecheck, Unit-Tests ohne Keys (vor jedem Push)
npm test
npm run content:mermaid
npm run test:a11y
npm run test:lighthouse   # app must be running on :43123 (or add -- --serve)
npm run hermes:dry-run    # AP-10 scaffold (no live Telegram)
npm run pilot:maf         # AP-11 seed/fixture pipeline (app on :43123)
npm run supabase:verify   # when SUPABASE_* present
npm run build
npm run lint

A11y gates (axe über alle Routen, Tastatur, Lighthouse a11y ≥ 0.9) laufen in den CI-Jobs e2e und perf (.github/workflows/ci.yml, gemeldet über den Sammel-Check build) und dürfen nicht abgeschaltet werden.

Pipeline-Ablauf (SIN-376)

Quelle: docs/diagramme/pipeline.mmd, Nutzerwege: docs/diagramme/nutzerwege.mmd. Der Block unten ist eine Kopie von pipeline.mmd (ein Test prüft das). FigJam wird in einer Claude-Sitzung aus den .mmd nachgezogen, das Tages-Update meldet „Diagramme geändert“.

%% Pipeline-Ablauf des Loops, Stand main 09.10. (SIN-376). Quelle für das FigJam-Board „Pipeline-Ablauf“.
%% Ändern sich .github/workflows/ oder scripts/autonomy/, diese Datei im selben PR anpassen.
flowchart TD
  subgraph Planung
    Radar["Trend-Radar (sonntags)"] --> Planer
    Planer["Planer (planner.yml, sonntags; offene Fertig-Liste sperrt Ideen)"] --> Schlange["Linear-Schlange"]
  end
  Schlange --> Dispatcher["Dispatcher (dispatch.yml): dringend, dann v1, höchstens 1 Idee pro Woche; sofort nach Merge, höchstens 2 parallel"]
  Dispatcher --> Worker["Worker (worker.yml, Claude; bei offenen Haken nur daran, derselbe Haken-Stand höchstens 2-mal, sonst needs-human, SIN-795)"]
  Worker --> PR["Pull Request mit Steckbrief (Bereiche: Frontend, Backend, Datenbank, Infra, Deploy)"]
  PR --> Anstoss["pruefer-anstoss.yml: Anstoß an den Leitstand-Prüfer; merge-gate verlangt Beleg für den Head (SIN-1001)"]
  subgraph Prüfung
    PR --> CI["CI: Lint, Typecheck, Tests, Build, axe, Layout-Test, Lighthouse, Leistungsbudget"]
    PR -- "Frontend geändert" --> Sicht["KI-Sichtprüfung gegen Figma: Kommentar, kein Gate (sichtpruefung.yml, SIN-523)"]
    PR -- "Vorschau fertig" --> PRC["PR-Crawler: nur geänderte Seiten, auch eingeloggt, Bild oder Video im PR (pr-crawler.yml, SIN-906, SIN-914)"]
    PR -- "Prompt, Richter oder Modell geändert" --> Gold["Goldset-Prüfung: Basis gegen PR, über 3 Prozentpunkte schlechter = rot (goldset.yml, SIN-629)"]
    PR --> CodeQL["CodeQL"]
    PR --> Review["Review-Agent (zweites Modell)"]
    CI --> Gate{"pr-gate: Risiko"}
    CodeQL --> Gate
    Review --> Gate
  end
  CI -- rot --> Repair["repair.yml: bis 3 Runden, ohne Commit startet ci neu, Claude-Fehler = sofort needs-human"]
  Repair --> CI
  Repair -- "nach Runde 3" --> Mensch["needs-human, Stopp"]
  Gate -- "risk:high" --> Freigabe["Label freigegeben (Sinan)"]
  Freigabe --> Merge
  Gate -- "risk:medium (Aufbauphase: ohne Frist)" --> Merge
  Gate -- "risk:low" --> Merge["Auto-Merge (Squash)"]
  Merge --> Haken{"Alle Fertig-Kriterien belegt? (SIN-779)"}
  Haken -- ja --> Done["Linear: Done"]
  Haken -- nein --> Offen["Issue bleibt offen, Kommentar nennt offene Haken"]
  Merge --> Dispatcher
  Merge --> Migr["Migrationen anwenden: additiv automatisch, sonst Sinan-Aufgabe (SIN-374, SIN-451)"]
  Merge --> Bruch{"gate-bruch-Erkennung"}
  Bruch -- "CI auf main rot" --> Revert["revert-guard: Revert-PR nur wenn Schritt davor grün (SIN-502)"]
  Revert -- "Revert-PR gemergt" --> LinearTodo["Linear: Issue auf Todo, 2. Rücknahme needs-human (SIN-492)"]
  Migr --> Deploy["production-deploy (höchstens 1× pro Stunde)"]
  Deploy --> Smoke["Smoke-Test"]
  Smoke -- rot --> Revert
  Smoke -- grün --> Live["Live-Check (nach-deploy.yml)"]
  Live -. "nachts / montags" .-> Testnutzer["Testnutzer-Agent: Crawler (auch eingeloggt) und 3 Personas, Funde werden Issues (testnutzer.yml, SIN-640, SIN-914)"]
  Deploy -- "grün, höchstens 1× pro Tag" --> Video["Tutorial-Video (video.yml): Freigabe nötig (SIN-483)"]
  Deploy -- "nur von Hand, freigabe ja" --> Werbeclip["KI-Werbeclip (werbeclip.yml): bis 5 €, Freigabe nötig (SIN-520)"]
  Kurs["Kurs veröffentlicht"] -- "von Hand" --> Marketing["Werbetexte (marketing.yml): Prüfung, dann Freigabe nötig (SIN-484)"]
  Live --> Waechter["Wächter / Loop-Status (status.yml)"]
  Waechter -- "neuer App-Code" --> Deploy
  Backup["Sicherung (backup.yml) nachts, Restore-Test (restore-test.yml) monatlich in wegwerfbarer Supabase (SIN-337)"] --> Waechter
  Waechter --> Update["Tages-Update (digest.yml, 10:00 und 20:00)"]
  Waechter --> Leitstand["Leitstand: Start/Ende jedes Schritts und Schnappschuss in Supabase (SIN-303)"]
  Worker -.-> Leitstand
  subgraph Projektwaechter["Projekt-Wächter (Leitstand-Repo, waechter.yml, stündlich, alle Projekte In Progress mit GitHub-Link)"]
    PW["Projekt-Wächter"] --> PWS["Schlange leer: Backlog rückt nach, sonst Planungs-Issue"]
    PW --> PWH["Hänger: über 6 h In Progress ohne PR, nur Label claude: Todo, beim 2. Mal needs-human; Worker 2-mal ohne PR: needs-human; Claude-Sofortabbruch zählt als Limit-Pause; 3 Fehlläufe desselben Auftrags in 60 Min ohne PR: Pause 60 Min (SIN-548)"]
    PW --> PWU["Projekt-Update in Linear, einmal am Tag"]
    PW --> PWR["Roter PR, 30 Min ohne Commit: @claude, Runde zählt mit"]
  end
  PWS --> Schlange
  PWR --> Repair
  subgraph Inhalte
    Fabrik["Content-Fabrik (content-grow.yml, alle 2 h solange Content-Punkte der Fertig-Liste offen sind (sonst Mo/Mi/Fr), Cron und Anstoß durch den Dispatcher (Ereignis fabrik-anstoss), jeder Lauf im Statusprotokoll, bei API-Limit pausiert und sinan-Issue, am Ende Kostenbericht)"] --> Bewertung["Bewertungslauf"]
    Bewertung --> Update
    Bewertung --> Freigabe["Kurs veröffentlichen (content-publish.yml, von Hand, Prüfung vor published, danach Live-Check)"]
  end

Qualität und Pflege (SIN-300)

Was	Befehl / Workflow	Wirkung
Leistungsbudget	npm run build && npm run perf:budget -- --serve · Grenzen in performance-budget.json	LCP (höchstens 2,5 s), CLS, TBT und JS-Größe je Route (Handy, Median aus 5 Läufen; --details zeigt das LCP-Element, --shard 1/2 misst nur einen Teil der Routen; CI nutzt zwei Teile parallel). Überschreitung macht build rot und blockiert den Merge.
API-Tests (SIN-538)	npm run build && npm run api:test -- --serve	Newman führt docs/api/postman-collection.json gegen die App aus (Health, Pipeline-Kette, 400/404); jede Prüfung zu Status und Antwortform muss grün sein.
Bildvergleich	npm run visual -- --update-snapshots, danach npm run visual · Workflow visual.yml	Handy- und Desktop-Bilder aller Seiten gegen main. Nur Hinweis (Lauf-Bericht, Artefakt bildvergleich), kein Gate; die Referenz kommt immer frisch aus main. Läuft nur, wenn der PR src/app, src/components oder Styles ändert, sonst grün (SIN-648).
Layout-Test (Gate, SIN-523)	npx playwright test e2e/layout.spec.ts · läuft im CI-Job e2e (Teil von build)	Alle Seiten aus e2e/routes.ts auf Handy (390×844) und Desktop (1280×800): keine überlappenden Knöpfe oder Textblöcke, kein waagerechtes Scrollen, kein abgeschnittener Text, Klickziele ≥ 44 px, nichts außerhalb des Bildes oder hinter fixen Leisten. Fehler nennen Seite, Ansicht und beide Elemente; das Artefakt playwright-results enthält das Bild mit roten Kästen. Gewollte Überlagerung: data-layout-ok="Begründung" am Element.
Goldset-Prüfung (SIN-629)	Workflow goldset.yml · lokal npm run quality:regression -- messen --out m.json · braucht OPENAI_API_KEY	Bei PRs, die Generator-Prompt, Richter oder Modellwahl ändern, misst der Job Richter (Erstquote auf 30 festen Einträgen, Urteil wie erwartet auf 70) und feste Prüfsätze (Quelle passt zum Beruf, keine Prüfhinweise, Elektro-Hinweis) mit dem Stand von main und dem PR. Über 3 Prozentpunkte schlechter oder Prüfsatz verletzt = rot, Ergebnis als PR-Kommentar. Wenige Cent je Lauf (Deckel 2 €), Ledger goldset-regression, Trace in Langfuse.
Testnutzer-Agent (SIN-640)	Workflow (Crawler nachts, Personas montags, auch von Hand mit , , ) ·

Ops / pilot docs: docs/ops/HERMES.md · docs/pilot/MAF-PILOT.md · docs/learning/LOOP.md · docs/ops/SUPABASE.md.

Phase A (AP-15)

First live course slice after the curriculum map: modules M0, LF1, LF2, PA (~280 units), generate with Claude Batch, judge with OpenAI mini, publish only through the quality gate. Tracked in SIN-193. Costs and scores should land in Langfuse Cloud EU — prefer completing the v4 cutover (SIN-197) before relying on dashboards for that run.

npm run ap15:phase-a:dry
npm run ap15:phase-a

Artifacts land in docs/ops/AP15-PHASE-A.md and docs/ops/ap15-runs/.

Deploy

Vercel project pointed at this repo. Empty/scaffold build must succeed (AP-01).

Git deploys are off (git.deploymentEnabled: false in vercel.json, SIN-309): neither main nor PR branches create Vercel deployments, so nothing counts against the Hobby limit of 100/day. Production is deployed by the production-deploy workflow (vercel deploy --prod via CLI, SIN-332; needs secret VERCEL_TOKEN and variable VERCEL_PROJECT_ID, plus VERCEL_TEAM_ID for team accounts). The status workflow starts it: at most once per hour, only when app code changed, and only one attempt per commit (a CANCELED/ERROR attempt is reported as "Production hängt" instead of being retried). If Production cannot be read from Vercel, or is more than 3 h behind main, the Loop-Status shows a red item under "Braucht dich" and sends Telegram (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, optional). The deploy hook from SIN-266 is retired (secret VERCEL_DEPLOY_HOOK_PROD is no longer used).

Functions run in Frankfurt (regions: ["fra1"] in vercel.json). Right after each Production deploy the same production-deploy run checks /api/health and /api/learner/phase-a for 200 and opens a revert PR otherwise (SIN-308). URL env vars (e.g. LANGFUSE_BASE_URL) are cleaned of quotes and validated in src/lib/env.ts; an invalid value disables the feature and logs a warning instead of crashing.

Live-Check (SIN-319). After each Production deploy (and nightly at 21:05 Berlin time) the workflow nach-deploy checks the live app against docs/ops/live-checkliste.md: API routes (scripts/autonomy/live-check.mjs), all pages on phone and desktop, the unit flow with all 5 question types, exam mode, offline mode, service worker, axe and a Lighthouse short run (live/live.spec.ts). It only reads or uses test data (write endpoints are stubbed, test id livecheck-<time>). Result: artifact live-check (checklist + screenshots) and the line "Live-Check hh:mm: n/n grün" on the status page and in the daily update. If it is red after a deploy, revert-guard opens a revert PR. Every new page or feature goes into the checklist (a unit test keeps list and checks in sync). Locally: npm run build && npm start -- --port 43123, then npm run live:local. Against another URL: PLAYWRIGHT_BASE_URL=<url> npm run live:browser and npm run live:api -- --base <url>, or run the workflow by hand with a URL.

Tutorial-Video (SIN-483). Der Workflow video nimmt den Klickweg Start → Beruf wählen → Lernpfad → erste Einheit → Ergebnis gegen die Production-URL auf (video/aufnahme.spec.ts, playwright.video.config.ts), schneidet ihn mit Revideo (video/schnitt/, 1920×1080: Titel, Handy-Aufnahme 390×844 im Rahmen links, Schritt-Titel und Text in der rechten Spalte, nie über der App, Logo, Hinweis „Lerninhalte mit KI erstellt“, Farben aus docs/design/tokens.json) und legt das MP4 in Supabase Storage (Bucket werbemittel) und als Zeile in werbemittel ab, Status wartet_auf_freigabe. Kein KI-Videomodell, 0 € API, Länge unter 90 Sekunden (sonst Fehler), ohne Ton. Auslöser: von Hand oder nach erfolgreichem production-deploy, höchstens 1 Lauf pro Tag. Schreibende Endpunkte sind abgefangen, es gibt keine Personendaten. Je Schritt entsteht ein Standbild aus dem fertigen MP4 (Artefakt video-standbilder, SIN-522). Hilfen: scripts/autonomy/video.mjs. Ohne SUPABASE_URL/SUPABASE_SERVICE_ROLE_KEY bleibt das Video ein Artefakt (tutorial-video).

KI-Werbeclips (SIN-485). node scripts/autonomy/werbeclip.mjs plan zeigt als Trockenlauf geplante Clips (3 Entwürfe, 1 Final) und Kostenschätzung ohne API-Aufruf. lauf (Workflow werbeclip, nur von Hand mit Eingabe freigabe: ja, Secrets HIGGSFIELD_KEY_ID und HIGGSFIELD_KEY_SECRET) erzeugt die Clips über die Higgsfield-API, fragt den Status ab (Backoff; failed/nsfw werden gemeldet), lädt das Ergebnis herunter, blendet „Mit KI erstellt“ ein (Revideo, video/schnitt/) und legt es in Storage ab. Vor jedem Aufruf wird der Deckel von 5 € pro Produkt geprüft; Modelle, Preise und Endpunkte stehen in docs/autonomy/higgsfield.json. Ergebnis: Zeile in werbemittel mit Kosten, KI-Kennzeichnung und Status wartet_auf_freigabe.

Werbetexte (SIN-484). Der Workflow marketing (von Hand, Eingabe Kurs-Stichwort, z. B. MAF) liest die Zahlen eines veröffentlichten Kurses aus der Datenbank (Einheiten, Minuten, Quellen, Fragen) und schreibt 3 Varianten: LinkedIn-Beitrag, Kurztext für die Website, E-Mail an Bildungsträger. Zielgruppe sind Bildungsträger und Ausbilder (FernUSG). Modell: claude-haiku-5-5, bei verworfenem Text einmal claude-sonnet-5-5, Deckel 1 € pro Lauf. scripts/autonomy/marketing.mjs prüft jeden Text: Hinweis „mit KI erstellt“ nötig, keine Garantien, keine IHK-Aufgaben oder -Logos, keine Zahl außerhalb der Datenbank. Durchgefallene Texte werden verworfen; bestehen nicht alle 3, wird nichts gespeichert. Ablage in werbemittel (Status wartet_auf_freigabe), veröffentlicht wird nie automatisch. Braucht ANTHROPIC_API_KEY, SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY.

Secrets

Set in Vercel / local .env.local (never commit): Anthropic, OpenAI, Langfuse (EU), Supabase (EU). Work without keys uses mocks.

Abo im Testmodus (SIN-771): /abo startet Stripe Checkout (Abo-Modus), /abo/bestaetigung zeigt den Stand. Braucht STRIPE_SECRET_KEY (sk_test_…) und STRIPE_PRICE_ID (Test-Preis); Live-Schlüssel lehnt src/lib/abo/abo.ts ab. Ohne beide zeigt /abo „noch nicht eingerichtet“.

Langfuse quality-gate tracing uses JS/TS SDK v5 / platform v4 OTEL ingestion (docs/quality/README.md). Course runs appear as one Langfuse session with one trace per unit (M3 · 02 Spannmittel), containing the generation and every judged question with answer, reason and scores (SIN-299, SIN-383); npm run langfuse:setup creates score configs, the safety-sample annotation queue, prompts and the dashboard (docs/ops/langfuse-dashboard.md).

Supabase persistence (AP-17)

• Migrations: supabase/migrations/ (additive SQL + RLS). Runbook: docs/ops/SUPABASE.md.
• Tabellenrechte prüfen (SIN-438): scripts/verify-table-grants.sql im SQL-Editor oder per psql; meldet „ok“ oder nennt offene Rechte für anon und authenticated.
• With SUPABASE_URL + SUPABASE_SERVICE_ROLE_KEY: API routes persist via Supabase (service role, server-only).
• Without those secrets (or COURSE_STORAGE=mock): in-memory mock-store — tests stay green.
• Verify tables (when keys present): npm run supabase:verify.

Sentry und Content-Fabrik-Status (SIN-289)

• Sentry EU (NEXT_PUBLIC_SENTRY_DSN, DSN-Host ingest.de.sentry.io) erfasst Fehler der App-Routen und der Pipeline (scripts/content-grow.ts). Ohne Personendaten (src/lib/sentry-privacy.ts); ohne DSN passiert nichts.
• Der Planer liest offene kritische Fehler der letzten 7 Tage (SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT); ohne Token steht „nicht verfügbar“.
• Die Content-Fabrik nimmt je Lauf so viele Module in einen Batch, wie der Deckel (Stopp bei 19 €) zulässt, und bewertet bis zu 4 Richter-Chunks gleichzeitig (SIN-406, docs/decisions/SIN-406-fabrik-durchsatz.md). Deckel und Qualitäts-Schwelle sind unverändert.
• Structured Outputs sind seit SIN-1036 immer an (der Schalter STRUCTURED_OUTPUTS entfällt; Generierung, Richter, Plan- und Research-Agent nutzen ein Schema, docs/decisions/SIN-1036-structured-json.md). Eine Richter-Antwort, die das Schema verletzt, macht die Einheit „nicht bestanden“ mit Grund. Abgelehnte Batch-Anfragen stehen mit API-Fehlertext im Log und Bericht; 0 Einheiten oder über 50 % gescheiterte Teilaufträge machen content-grow und ap22-ab rot (Exit 1).
• Der Lauf-Bericht der Content-Fabrik nennt je Lauf erzeugt, bestanden, verworfen und nichtVersucht mit Grund (Kostendeckel, Zeitlimit, begonnene Module, andere Map). Die Kosten je Einheit rechnen ohne Reparatur, damit der Deckel nicht doppelt zählt (SIN-434, docs/decisions/SIN-434-fabrik-engpass.md).
• Die Content-Fabrik erzeugt zwei Berufe: MAF Metall und Industriekaufleute (SIN-431, docs/decisions/SIN-431-indkfl-fabrik.md). Jeder Lauf bedient eine Map und wechselt zum nächsten Lauf; Kurs und amtliche Quellen für Industriekaufleute legt die Migration 20261012010000 an.
• Die 6 weiteren MAF-Schwerpunkte (Kunststoff, Textil, Textilveredelung, Lebensmittel, Druckverarbeitung, Packmittel) stehen in MAP_COURSES, erzeugt werden sie erst mit CONTENT_GROW_SCHWERPUNKTE=1 und nach Metall und Industriekaufleuten. Gemeinsame Module erzeugt nur MAF Metall. Der Trockenlauf (npm run content:grow -- --dry-run) nennt je Map Ziel, vorhanden, geteilt, neu (SIN-479, docs/decisions/SIN-479-schwerpunkte.md).
• Kurs veröffentlichen (SIN-796): Workflow „Kurs veröffentlichen“ (content-publish.yml, nur von Hand, Eingabe Kurs-Stichwort). Standard ist der Trockenlauf; er zeigt die Prüfungen (Quelle und Abrufdatum, Richter bestanden, Verbotsliste), schreibt nichts. Mit dry_run aus setzt er bei null Mängeln courses.status = published, schreibt das Ereignis publish und startet den Live-Check. Lokal: ().

Repo

https://github.com/siinanXD/Content-Agent-Lernapp

Pull Requests

Jeder PR wird automatisch geprüft (build, pr-title, merge-gate). In der Aufbauphase (SIN-855) mergen risk:low und risk:medium ohne Frist nach grünen Checks. Danach gilt: risk:low mergt ohne Frist, risk:medium (Workflow-Rechte, Gate-Änderungen) nach 30 Min Einspruchsfrist (Label einspruch:30m, Stopp mit no-automerge), risk:high wartet auf das Label freigegeben. Nach jedem Merge startet post-merge den Dispatcher sofort. Details: AGENTS.md, Abschnitt „Pull Requests und Merge“. Hat Cursor kein Guthaben, übernimmt Claude: @claude in einem Issue-Kommentar.