Stand 2026-10-05 · Quelle: Slugs der letzten 7 Tage, Backlog, Commits bis b1c7b75
Naechste MZP-Arbeitsthemen
Einstieg fuer einen frischen Agenten auf dem Repo mzone-publisher. Ziel: die fuenf Achsen des MZP (Design, Diagramm, Publish, Effizienz, Agent-Usability) weiter ausbessern. Die Reihenfolge unten ist eine Empfehlung, keine Vorgabe. Pruefe jeden Ticket-Stand vor dem Start mit backlogGet(key), dieses Dokument ist ein Schnappschuss.
0. So faengst du an
- Lies
ExploreTheWorld/CLAUDE.md(Deploy-Wege, Artefakt-Regeln) undmzone-publisher/AGENTS.md(Bauen, Ratschen, Fallstricke). Bei Unterpaketen gewinnt die naeher liegendeAGENTS.md(application/support/diagram/,diagram/delta/,backlog/,docs/agent-workflows/). - Orientierung:
docs/repo-map.md(wichtige Dateien nach Import-Graph),docs/baseline.md(Zahlen hinter den Ratschen). Genaue Aufrufer: IntelliJ-MCP (search_symbol,analyze_calls), nicht greppen. - Ticket lesen:
backlogGet("MZP-nnn")liefert vollen Rumpf und Kommentare. Vorher die zugehoerige ADR lesen, wenn eine Entscheidung revidiert wuerde (Wiki-Slugwiki-adr-nr-titelviagetPageContext). - Bauen:
mvnd test(Suite laeuft mit Postgres-Testcontainer), einzelne Klasse mit-Dtest=Klasse. Lokal:mvnd spring-boot:run -Dspring-boot.run.profiles=local. - Ratschen halten:
FileSizeRatchetTest(main ≤ 400 LOC),BoundaryRatchetTest,ContextBootRatchetTest,jacoco:check,LayoutQualityRatchetTest. Eintraege nur mit Begruendung in derselben Zeile, Register untersrc/test/resources/ratchet/. - Konventionen: Javadoc und Kommentare deutsch, keine Umlaute in Bezeichnern, Ticket-Key im Kommentar (
MZP-nnn: ...), Records fuer Domaenenobjekte, keine neuen Abhaengigkeiten ohne Not. - Nicht tun: nicht parallel deployen,
mzone-opsnie per MCP deployen, Compose nur aus/var/www/maierzone/{service}/docker/. Deploy und die Eval-Stufe nach dem Deploy (/mzp-eval) laufen manuell und nur auf Anweisung des Auftraggebers.
1. Stand je Achse
| Achse | Leistung / Beleg | Kernaussage (Zustandsbericht 02.10.) |
|---|---|---|
| Design | 4,0 / 2,5 | Groesster Abstand: viel Handwerk, kaum ein Gate dafuer. |
| Diagramm | 4,5 / 4,0 | Staerkster Teil. Offen: Layout-Politur, Phantomknoten, zu kleine Erstansicht. |
| Publish | 4,0 / 3,5 | Weg traegt. Export, Deploy und Transport grosser Buendel nicht. |
| Effizienz | 3,0 / 2,5 | Schwaechste Achse: Aufrufe werden gezaehlt, Tokens und Zeit nicht gemessen. |
| Agent-Usability | 4,0 / 3,5 | Klarster Vorsprung. Es fehlt die Messbreite der LLM-Evals. |
Skala 1 bis 5, Wertung ist Urteil des Berichts, keine Messung. Eval-Stand 04.10.: deterministische Stufe 17 von 17 gruen.
2. Was MZP schon kann
- kann 45 Diagrammtypen; Eingaben JSON-Spec, Mermaid (flowchart, state, ER, class), ASCII-Skizze (
ascii) und Handskizze nach analog. - kann Auto-Layout mit
constraints[], serverseitiges Routing mit Nudging,LAYOUT_QUALITYsamthotspots[], Render-Check im echten Browser. - kann Viewer mit Suche, Reach-Trace, Kapiteln; MCP-App-Viewer im Claude-Chat (MZP-126, im Host nachgewiesen).
- kann Sequence-ALT-Regionen (MZP-157), je Diagramm eindeutige SVG-IDs (MZP-156), 10 Skins,
meta.colors,meta.sketch. - kann Branding-Profile in der Datenbank (Tabelle
branding_profile, V30),saveBrandingProfile/deleteBrandingProfile, Kontrastpruefung,meta.profile(Commits MZP-160; das Ticket steht noch auf IDEA). - kann analog@1.1.0: Tuschestrich in Java (
TUSCHE_APPLIED),FIGURE_FIT/FIGURE_COLLISION, Schriften im Haus. - kann Publish:
validateArtifactmitstagingToken, bis zu 5 Versionen je Slug, Rollback, Patch-Publish, TTL-Previews bis 7 Tage, lebende Reports (_data.json). - anders Wiki ist abgebaut (MZP-151, REVIEW):
knowledgeQuery,lintWiki,mergePageContextund die/api/wiki-Pfade gibt es nicht mehr; diewiki-*-Seiten bleiben als normale Seiten.
3. Arbeitspakete in empfohlener Reihenfolge
AP1 · Raender schliessen (Tage)
| Ticket | Achse | Status | Was | Erster Schritt |
|---|---|---|---|---|
| MZP-135 | Diagramm | REVIEW | Mermaid-Import: Kante auf Subgraph-Id erzeugt stillen Phantomknoten (ok:true, 8 statt 7 Knoten). | Fix gegen Produktion pruefen (dia-mermaid-flow), Regressionstest, dann abnehmen lassen. |
| MZP-131 / MZP-142 | Publish | REVIEW / READY | PDF-Export liefert bei JS-gerenderten Bundles (Slidev) ein leeres PDF ohne Hinweis. Fix: page.pdf im Render-Dienst (mzone-render). | MZP-142 ziehen; Export bei Browser-gerenderten Bundles ueber den Render-Dienst statt pandoc. Zwei Export-Tests sind lokal uebersprungen (pandoc fehlt), das beim Test beachten. |
| MZP-149 | Publish | REVIEW | /foo und /llms.txt antworten 502 statt 404, llms.txt enthaelt Wegwerfseiten. | nginx-Aenderungen muessen auf dem Server eingespielt werden (nicht aus dem Repo wirksam): vorher mit dem Auftraggeber klaeren. |
| MZP-150, 152, 156, 157 | Agent / Diagramm | REVIEW | Fehlermeldungs-Form in den typeBlocks, Eval-Befunde vom 03.10., SVG-IDs, ALT-Fragmente. | Abnahme gegen Produktion; ggf. Ticket-Status nachziehen. |
| MZP-160, 144 | Backlog | IDEA | Beide sind per Commit umgesetzt, stehen aber noch auf IDEA. MZP-161 (Schriften) ist Phase 2 und offen. | Stand pruefen und mit backlogWrite buchen (nach Ruecksprache). |
AP2 · Messen: Effizienz und Agent-Usability
fehlt Der Eval-Lauf zaehlt Aufrufe, aber nicht Tokens und Zeit. Ohne diese Zahlen laesst sich keine Tool-Diaet und kein Upload-Weg begruenden.
- Kein Ticket vorhanden. Anlegen (
backlogWrite, nach Ruecksprache): Tokens und Zeit je Aufgabe indocs/agent-workflows/evals/mitschreiben und im Tages-Report ausweisen. - LLM-Stufe auf alle 17 Aufgaben ausdehnen (bisher fuenf Diagramm-Aufgaben). Fuer Artefakt-, ASCII-, analog- und constraints-Aufgaben gibt es keine LLM-Messung.
- MZP-141:
eval-sketch-*-Aufgaben mit deterministischer Bewertung. - MZP-68: warum braucht
KnowledgeMcpToolsTest81 s fuer 4 Tests (27 bis 38 % der Suite)? Ursache ungeprueft; Verdacht fehlende Indizes, das waere ein Produktivbefund. Pruefen, ob der Test mit dem Wiki-Abbau (MZP-151) ohnehin entfaellt.
AP3 · Agenten-Treffsicherheit
| Ticket | Befund (Eval 03.10.) | Hinweis |
|---|---|---|
| MZP-153 READY, P1 | dia-ascii-architecture: Sonnet 0/3, Haiku 2/3. Ein Lauf schickte achtmal an publishDiagram ohne vorher zu validieren. | Fehlermeldungen (ASCII_EDGE_DANGLING, ASCII_BOX_OVERLAP) und Weiche zum Validieren verbessern; Fehlermeldungen bewegen die Erfolgsquote, Beschreibungstexte nicht (MZP-127). |
| MZP-154 READY, P1 | art-analog-tusche: Haiku 0/3 nimmt den Diagramm-Weg statt des analog-Wegs. | Die Weiche zwischen Diagramm und analog sichtbar machen (getCapabilityFor('analog')). |
| MZP-155 READY, P1 | art-live-report: Haiku 0/3, Sonnet 2/3; Agenten finden den Live-Daten-Mechanismus (E11) nicht. | Ticket sagt: erst pruefen, ob schon geloest. liveDataSources steht in getCapabilities. |
AP4 · Design belegen
| Ticket | Status | Was |
|---|---|---|
| MZP-140 | IDEA | analog-Blaetter fuer Screenreader lesbar machen: 41 fokussierbare Elemente, aber ein aria-label; Name und Erklaerung stehen nur in data-name/data-desc. |
| MZP-115 | IDEA | Branding-Profile als DTCG-JSON und CSS-Variablen exportieren (Quelle der Tokens ist vorhanden). |
| kein Ticket | fehlt | Gestaltungs-Gate, z. B. Pixelvergleich (E1 aus Band 4). Keine Eval prueft heute, wie eine Seite aussieht. Zuerst klaeren, was verglichen wird. |
| MZP-161 | IDEA | Font-Katalog fuer Profile, Upload nur bei Bedarf. FontMetrics misst aus vorberechneten Tabellen (font-metrics.txt, scripts/font-metrics.py), nicht per AWT (Alpine-JRE). |
| MZP-117 | IDEA | Agent-Lesbarkeit als Befundklasse im Render-Check. |
Axe-Pruefung (a11y) ist heute Opt-in und steht auf false.
AP5 · Diagramm-Politur und Luecken
| Thema | Ticket | Stand |
|---|---|---|
| Router: Kehrtwenden an der Quelle (N5). Das Auto-Layout halbierte die Kreuzungen, verdoppelte aber Ueberlappungen und Knicke. | kein Ticket | teilweise Messung per LayoutQualityRatchetTest; Schwellen aus ratchet/layout-quality.txt. |
| Erstansicht flacher Ablaeufe zu klein (Knotentext 5 bis 6 px im Median) | kein Ticket | teilweise Stichprobe von vier Seiten, Ursache ungeprueft. |
Mermaid sequenceDiagram; mehrere Bloecke aus Markdown | MZP-158, MZP-159 | fehlt MERMAID_UNSUPPORTED heute. |
Fidelity-Ledger nach Import; Groessen-Presets (slide-16x9, social-og) | MZP-163, MZP-167 | fehlt |
Animation step mit ?step=N; Semantic Patterns und Referenzdiagramme | MZP-165, MZP-164, MZP-166 | teilweise nur meta.animation=trace und Bausteine. |
| Consultant-2x2 mit benannten Zellen | MZP-169 | fehlt |
| draw.io-Import | kein Ticket | fehlt Groesste Funktionsluecke im Vergleich mit diagram-design. Aufwand und Nutzen mit dem Auftraggeber klaeren, bevor ein Ticket entsteht. |
AP6 · Publish und Betrieb
- fehlt CI. Im Repo liegt keine CI-Konfiguration; Evals nach dem Deploy laufen von Hand, nginx-Aenderungen werden einzeln eingespielt (Folge: MZP-45, alle Seiten 401). Entscheidung des Auftraggebers noetig.
- fehlt Upload-Weg fuer grosse Buendel.
publishArtifactnimmt Inhalt inline oder perfromSlug; ein 70-KB-Buendel laeuft durch den Agenten, dabei ging einmal ein Koordinatenpunkt verloren. Entscheidung noetig, ob ein Weg ohne OAuth fuer MCP-Agenten gewuenscht ist. - teilweise MZP-56: SVG-Download, Share-Card 1200x630, WebM.
diagram.svgliegt schon im Bundle, ist aber nirgends verlinkt. - fehlt MZP-79 Praesentations-Export
.mdnach.pptx/.pdf; MZP-64 SRI-Hashes und Import-Map fuer/lib/.
AP7 · Extravaganz mit dem besten Hebel
MZP-85 Simulationsmodus (READY, P3, seit 07.09.): skriptgesteuerter Playback mit Lauf-Protokoll. Der Spike (MZP-87) hat Schema und DOM-Vertrag bestaetigt. Daran haengen WebM-Export (MZP-56), Klangspur (D5, Tone.js) und Schritt-Beschriftung. Referenz: /published/atlas-plate-ii-demo/. Danach MZP-165 (step) und MZP-166 (animiertes Policy-Trace-Beispiel).
Bewusst liegen gelassen (Zustandsbericht): isometrische Skin (A6), Plotter-Export (M3), neue Wiki-Funktionen.
4. Entscheidungen, die beim Auftraggeber liegen
- CI und automatischer Eval-Lauf nach dem Deploy?
- Upload-Weg fuer grosse Buendel ohne OAuth?
- draw.io-Import bauen oder bewusst nicht?
- Gestaltungs-Gate: was genau wird gemessen (Pixelvergleich, Token-Konformitaet, beides)?
- MZP-159 (mehrere Mermaid-Bloecke) ist laut Ticket nicht ausdruecklich bestaetigt und darf gestrichen werden.
5. Quellen
Alle unter https://publisher.maierzone.de/published/{slug}/:
mzp-zustandsbericht-2026-10-02— die fuenf Achsen mit 40 Befundenmzp-vs-diagram-design— Faehigkeitsmatrix gegen das Original, Epic dd-parity (MZP-153 bis 169)research-mzp-extravaganzen— Band 4, Funde A1 bis E2, Moonshotsopus-5-5-optimum-suggestions— Band 5, Handwerk messbar machen (H1 bis H8, B1, B2, M1 bis M3)mzp-eval-2026-10-04undmzp-eval-2026-10-03— Eval-Stand und LLM-Befunde
Grenzen dieses Dokuments: Zustandsbericht und die Recherche-Baende wurden nur teilweise gelesen; Ticket-Status stammt vom 05.10. und kann veraltet sein. Vor dem Start immer gegen backlogGet und git log abgleichen.