LLM Design Engine
Kompilator designu w TypeScript, który porządkuje decyzje produktowe i wizualne, zanim agent zacznie pisać frontend. Zamienia brief w interpretację domeny, kierunki kreatywne, zatwierdzoną specyfikację, deterministyczne podglądy, brand assets, kontrolę jakości i przenośny handoff wdrożeniowy.
Informacje o projekcie
- Rola
- Zdefiniowałem produkt, kontrakt artefaktów, pipeline kreatywny, interfejsy i architekturę monorepo, a następnie zbudowałem MCP, CLI, renderer, adaptery providerów, Studio oraz workflow walidacji.
- Okres
- Lipiec 2026 · Open-source’owe narzędzie developerskie
- Zespół
- Projekt samodzielny · 1 developer
Wyzwanie
Agenci kodujący szybko implementują interfejsy, ale ogólne prompty projektowe regularnie prowadzą do generycznych layoutów, dekoracyjnych gradientów, szklanych kart i wizualiów niezwiązanych z produktem. Wyzwaniem było zachowanie kreatywnego rozumowania przy jednoczesnym tworzeniu deterministycznych, czytelnych maszynowo artefaktów możliwych do wykonania przez kolejnego agenta.
Kluczowa decyzja
Oddzielić kreatywne rozumowanie providera od stabilnego kontraktu artefaktów, aby lokalny tryb deterministyczny i tryb wspierany AI tworzyły ten sam wykonywalny handoff.
Podejście
Zbudowałem etapowy workflow kompilatora: brief, cztery kierunki kreatywne, wybór, specyfikacja designu, podgląd, dopracowanie, zatwierdzenie, brandkit, lint anti-slop i eksport. Lokalny serwer MCP przez STDIO udostępnia proces bezpośrednio w Claude Code, Codex, OpenCode i Oh My Pi, a CLI zapisuje przenośne artefakty Markdown i JSON w katalogu .design dowolnego repozytorium. Kontrakty oparte na Zod utrzymują poprawność design AST, a deterministyczne renderery zapewniają powtarzalne podglądy bez klucza API.
Kluczowe elementy
- Kompletny workflow MCP i CLI dla agentów kodujących
- Cztery odrębne kierunki kreatywne przed rozpoczęciem implementacji
- Przenośne artefakty .design z gotowym do wdrożenia EXPORT.md
- Deterministyczny tryb lokalny działający bez klucza AI
- Lint anti-slop wykrywający generyczne wzorce i nieuzasadnione decyzje
- Adaptery rozumowania i generowania obrazów zgodne z OpenAI
Architektura
- Monorepo TypeScript i pnpm z wydzielonymi pakietami kompilatora
- Serwer MCP STDIO z narzędziami, zasobami i promptami
- CLI i lokalne API Hono dla workflow powiązanego z repozytorium
- Design AST walidowany przez Zod z serializacją Markdown i JSON
- Deterministyczny renderer podglądów HTML, CSS i SVG
- Warstwa providerów dla lokalnego mocka i rozumowania zgodnego z OpenAI
Rezultat
Kompletny lokalny workflow projektowy działający bez credentials, który można rozszerzyć o providerów rozumowania i obrazów bez zmiany kontraktu artefaktów ani handoffu implementacyjnego.