🐴 Winderen Creative Studio v3.0

Zintegrowany pakiet masowej produkcji, adaptacji wielojęzycznej i post-processingu grafik reklamowych dla marki Winderen, oparty o model Ideogram 4.0, natywną percepcję Google Gemini Vision oraz architekturę Antigravity 2.0 (AGAOF).

---

🏛️ Główne Filary Systemu

1. Twarda Bramka "Template-First Interlock":
   • Całkowity zakaz generowania obrazów AI w ciemno. Agent w pierwszej turze zawsze prezentuje Kartę Materiałową Szablonu i czeka na akceptację użytkownika.
2. Determinizm Produktu Fizycznego:
   • Sprzęt jeździecki (pady, strzemiona, wędzidła) nie jest halucynowany od zera. Wklejany jest z oryginalnego assetu PNG (brand/assets/products/*.png) na wygenerowane tło studyjne z podwójnym cieniem kontaktowym (Ambient Occlusion + Soft Drop Shadow).
3. Natywna Percepcja Gemini Vision (Sentinel QA):
   • Zamknięta pętla jakościowa weryfikująca poprawność napisów (OCR Levenshtein \ge 0.98), barwy marki (#D4AF37, #0A192F) oraz poprawność ułożenia sprzętu jeździeckiego.
4. Wielojęzyczność 10x:
   • DTP z buforami językowymi (+30% DE, +35% FI), bezpieczne strefy UI dla Stories 9:16 (martwe strefy 220px góra / 280px dół).

---

📁 Struktura Folderu Projektu

winderen-creative-studio/
├── mcp-server/             ← Działający serwer MCP (26 narzędzi NodeNext/TypeScript)
│   ├── build/index.js      ← Plik wykonywalny serwera MCP
│   └── src/                ← Kod źródłowy narzędzi i klientów API
├── skills/                 ← 5 wyspecjalizowanych skilli produkcyjnych v3.0
│   ├── winderen-creative-orchestrator/
│   ├── winderen-dtp-typesetting/
│   ├── winderen-ideogram-engine/
│   ├── winderen-multimodal-sentinel/
│   └── winderen-social-canvas/
├── brand/                  ← Baza tożsamości marki
│   ├── brand_voice.json    ← Filary naukowe, zakazane słowa dyskontowe
│   ├── products_db.json    ← Katalog produktów, wektory, strefy BBox
│   └── assets/             ← Oryginalne zdjęcia i wycięte PNG produktów
├── moodboard/              ← Presety wizualne (style_presets.json)
├── projects/               ← Wygenerowane projekty, szablony i eksporty
├── scripts/                ← Skrypty pomocnicze (np. batch_dispatch_parallel.py)
├── tests/                  ← Kompletny zestaw 88 testów E2E (Tiers 1–4)
├── MASTER_AGENT_OPERATING_CANON.md ← Kanoniczny podręcznik operacyjny (Single Source of Truth)
├── RUNBOOK_ANTIGRAVITY_GEMINI.md  ← Runbook wdrożeniowy dla Antigravity 2.0
└── PIPELINE_ORCHESTRATION_MASTER_PLAN.md ← Główny plan orkiestracji

---

⚡ 26 Narzędzi Serwera MCP (winderen-studio)

Kategoria	Narzędzia MCP
Setup & Baza Marki	load_brand_preset, load_project_template, save_project_template, list_project_templates
DTP & Geometria	parse_localization_syntax, measure_and_fit_typography, validate_layout_collision, import_translations, import_translations_matrix
Generacja Wizualna	generate_v4, generate_transparent_v4, replace_background, remove_background, describe_image_v4, remix_image_v4
Post-Processing & Formaty	layerize_text, resize_advertisement, adapt_aspect_ratio_layout, batch_localize_campaign, magic_prompt_enhance
Kolejka & Asynchroniczność	create_bulk_job, get_bulk_job_status, list_bulk_jobs
QA & Dystrybucja	validate_brand_fidelity, generate_multimodal_qa_report, package_campaign_project

---

🚀 Konfiguracja w Antigravity 2.0 / Claude Desktop

W pliku konfiguracyjnym MCP (~/.gemini/antigravity/mcp_config.json lub claude_desktop_config.json):

{
  "mcpServers": {
    "winderen-studio": {
      "command": "node",
      "args": [
        "D:\\hermes-workspaces\\33. Winderen-grafika-social\\winderen-creative-studio\\mcp-server\\build\\index.js"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "${IDEOGRAM_API_KEY}"
      },
      "timeout": 180
    }
  }
}

---

🧪 Weryfikacja Testów (88/88 PASS)

Uruchomienie pełnego pakietu testów:

npx tsx tests/run_all.ts

---

🛠️ Nowe Skrypty i Automatyzacje w scripts/

1. Uniwersalny Ekstraktor DNA Dowolnej Marki:

   python scripts/universal_brand_extractor.py --url "https://domena.com" --name "MojaMarka" --output "brand/moja_marka"
   

   Pobiera stronę przez Playwright, ekstrahuje kolory, fonty, nagłówki, generuje brand_voice.json, products_db.json oraz guidelines.md.

2. Dedykowany Scraper Badań i DNA Winderen:

   python scripts/scrape_brand_dna.py
   

   Pobiera badania laboratoryjne, certyfikacje weterynaryjne i linki do assetów z oficjalnych stron technologii Winderen.

3. Wielowątkowy Dispatcher Kampanii (CLI):

   python scripts/batch_dispatch_parallel.py --template "projects/template.json" --concurrency 8 --output-dir "projects/exports"
   

---

📚 Kompletna Dokumentacja Operacyjna

• AGENT_OPERATING_MANUAL.md — Oficjalny podręcznik operacyjny agenta LLM w Antigravity 2.0 (pętla Plan-First, schematy Canonical JSON BBox, reguły Invariants).
• MASTER_AGENT_OPERATING_CANON.md — Kanoniczny model architektoniczny i wytyczne DTP.
• RUNBOOK_ANTIGRAVITY_GEMINI.md — Praktyczny przewodnik po narzędziach i kompozycjach.