mertozcelenk/adStudio

Claude Code skill ve agent kütüphanesi. Tasarımcıların sıfırdan veya mevcut
bir proje üzerinde tasarım sistemi kurmasını, token üretmesini ve bileşen
çıktısı almasını standartlaştırır. Çıktılar AI'dan çıkmış gibi görünmez —
anti-AI-tells sistemi ve tasarımcı onay döngüleri bunu engeller.
> adStudio, LDF'nin bbd575d sürümünden türetildi.
Kurulum
Son komut Tüm durumlar geçti. ve Tüm fixture beklentileri karşılandı. satırlarını yazıp hatasız bitmelidir
(çalıştırıcının hata durumları + tarayıcıyla çalışan gerçek testler). Bitmiyorsa otomatik testler çalışmıyor demektir;
ads-design-reviewer bu durumda testleri çalıştırılamadı olarak raporlar ve çıktı "teslime hazır" sayılmaz.
> **Klasör yapısı hakkında:** .claude/skills/ skill dokümantasyonunu barındırır.
> .claude/commands/ ise Claude Code'un slash komutlarını (/ads-*) keşfettiği dizindir.
> Kurulum komutu skill'leri her ikisine de kopyalar — bu kasıtlıdır.
Geliştirme
Yeni adım, skill veya agent eklemek için: CONTRIBUTING.md. Repodaki talimatları kurulu projelere
dokunmadan denemek için geliştirme klasörü: scripts/dev/sandbox.sh ~/Desktop/adstudio-gelistirme (repoda değişiklikten sonra yeniden çalıştır). Komutlar ve agent'lar ads- önekli olduğundan
aynı bilgisayardaki başka kurulumlarla karışmaz.
Hızlı Başlangıç
**Sıfırdan başlıyorsan:**
**Hali hazırda bir projen varsa:**
**Figma çıktısı için:** Figma Desktop'ta Plugins → Claude Code eklentisini aç.
Kurulu değilse pipeline otomatik olarak HTML/CSS moduna geçer.
**Onaylanan bir sunumu gerçek projeye taşımak için:**
**Format değiştirmek için (HTML/CSS ↔ Figma):**
**Mevcut projeyi geliştirmek için:**
Pipeline
Sıfırdan proje
Mevcut sisteme ekleme
Component library oluşturma
Onaylanan sunumu gerçek projeye taşıma
Format değiştirme
Mevcut projeyi geliştirme
Deep Mod Pipeline — Adım Adım
| Adım | Agent | Ne yapar |
|------|-------|----------|
| 1 | ads-design-strategist | Estetik çakışma tespiti, alternatif yönler, Design Read, kritik heuristic'ler |
| 2 | ads-design-planner | Component listesi, flows.md (akışlar, önkoşul / sonra) + templates.md (ekran tipleri), UX validation, tasarımcı onayı, görev çıktısı |
| 3 | ads-ux-designer | Her component için UX pattern seçimi ve spec üretimi (ux-specs.md'de bu çalışmanın bölümü) |
| — | plan-gate | Builder öncesi geçiş kontrolü: bu çalışmanın planı ile UX spec'leri birebir tutuyor mu (scripts/test/plan-gate.mjs) |
| 4 | ads-design-builder | Figma veya HTML/CSS üretir |
| 5 | ads-design-reviewer ‖ ads-ux-reviewer | Paralel: spec/token/a11y/AI tells mekanik kontrolü · Nielsen heuristic'leri, component binding, WCAG 2.2 POUR |
| 6 | ads-design-builder → reviewer'lar | Düzeltme döngüsü: teslim engelleri düzeltilir, yeniden kontrol edilir (en fazla 2 tur) |
| 7 | orkestratör | Teslim kapısı: "Teslime hazır" / "İstisna onayıyla teslim edilebilir" / "Teslime hazır değil" |
> **Deep mod süre beklentisi:** 20–30 task içeren bir projede toplam süre 15–40 dakika arasında
> değişebilir — bu normaldir.
Öne Çıkan Özellikler
**Flow ve template**
Token'lar ürünün nasıl göründüğünü, iki proje dosyası nasıl kurulduğunu ve nasıl davrandığını tanımlar:
templates.md ekran tiplerini (liste, detay, form…: bölgeler, zorunlu durumlar, davranış), flows.md proje geneli
**Ortak Davranış**'ı ve kullanıcı akışlarını (adımlar, dallar, Önkoşul / Sonra) tutar. Builder her ekranı bir
template'ten ve bir akıştan üretir; boş durumlar kullanıcıyı sıradaki akışa götürür. Dosyalar kalıcıdır, yeni kapsam
eklenir; /ads-iterate bir template ya da akış değişince etkilenen ekranları buradan bulur. structure testi
ekranların bu dosyalarla tutarlılığını model çağırmadan denetler. Sözleşme: references/structure-standards.md.
**Teslim kapısı**
Her akış (quick, deep, iterate, promote) bir teslim durumuyla biter: **Teslime hazır**, **İstisna onayıyla
teslim edilebilir** veya **Teslime hazır değil**. "Teslime hazır" için dört koşul gerekir: açık teslim engeli yok,
zorunlu otomatik testler geçti, inceleme tamamlandı (deep: iki reviewer; quick / tek dosya: hafif review),