Communitygithub.com

site-build-method

Design skill. The human wants the agency process around a client website - a static prototype approved before the CMS build, written decisions and sign-off, a prelaunch checklist, handover (TR - yeni müşteri sitesi, site yapım yöntemi, prototipten temaya, hangi fazdayız, siteyi taşı, yayına hazırlık, devir teslim) - or asks whether that two-stage route is worth it, or resumes a project that has a root STATE.md with phases 0-12. A plain request to build a site on Blocofy belongs to blocofy-orchestrato

What is site-build-method?

site-build-method is a Claude Code agent skill that design skill. The human wants the agency process around a client website - a static prototype approved before the CMS build, written decisions and sign-off, a prelaunch checklist, handover (TR - yeni müşteri sitesi, site yapım yöntemi, prototipten temaya, hangi fazdayız, siteyi taşı, yayına hazırlık, devir teslim) - or asks whether that two-stage route is worth it, or resumes a project that has a root STATE.md with phases 0-12. A plain request to build a site on Blocofy belongs to blocofy-orchestrato.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Blocofy/blocofy-agency-kit/tree/HEAD/plugins/agency-kit/skills/site-build-method

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Site Yapım Yöntemi: prototipten CMS temasına

Özgün tasarımlı, yapılandırılmış verisi olan bir kurumsal siteyi önce platformdan bağımsız statik bir prototipte bitir, sonra CMS temasına taşı ve iki sürümün aynı olduğunu ölçülmüş kanıtla göster. Yöntem dört şeye dayanır: tek doğru kaynak, kanıtlı faz kapıları, işi yapmayan bir gözden geçiren ve dosyada yaşayan durum.

Platforma özgü ayrıntılar adapters/<platform>/ altında. Kuralların hangi hatalardan çıktığı examples/lessons.md içinde. Bu skill hiçbir müşteri verisi içermez; müşteriye ait her değer site klasöründeki dosyalardan okunur.

Terimler

  • Site klasörü: bu sitenin .env.local, ajanın MCP yapılandırma dosyası, AGENTS.md (ya da CLAUDE.md), STATE.md ve .blocofy-build/ dosyalarını tutan tek klasör. Ajan orada başlatılır, komutlar oradan çalışır. Bu dosyalardaki "proje kökü" aynı yerdir.
  • <skill-dir>: bu SKILL.md'nin yüklendiği klasör. Ajan skill'i yüklerken gösterir; göstermezse şununla bul: find ~ . -maxdepth 6 -type d -name site-build-method -path '*skills*' 2>/dev/null | head -1. Kitteki öteki skill'ler kardeş klasördür; scriptleri yorumlayıcıyla çalıştırılır: bash <skill-dir>/../blocofy-platform/scripts/…, node <skill-dir>/../blocofy-qa/scripts/…. O klasör yoksa kit eksik kurulmuştur: dur ve kişiden altı skill'in hepsini kurmasını iste.
  • Skill adları: "blocofy-qa skill'ini yükle" diye yazılır. Bazı ajanlar önek gösterir (ör. Claude Code'da agency-kit:blocofy-qa).
  • MCP araçları: blocofy adıyla kayıtlı MCP sunucusunun araçlarıdır. Ajanlar araç adına farklı önek ekler; yalın ada bak.
  • Alt ajan: temiz bağlamla başlayan ve yalnız adı verilen dosyaları alan ayrı bir ajan. Bazı ajanlar alt ajanı yalnız açıkça istenince başlatır. Ajanın alt ajanı yoksa aynı işi ayrı bir geçişte yap: yalnız adı geçen dosyaları diskten yeniden oku, sonucu adı geçen dosyaya yaz, incelemenin bağımsız olmadığını STATE.md'ye yaz ve kişiye bu adımı yeni bir oturumda çalıştırmayı öner. "Alt ajan", "bağımsız gözden geçiren" ve "işe dahil olmayan ajan" geçen her yerde bu kural geçerlidir.

Demir kurallar

  1. Tek doğru kaynak. Hangi dosyanın doğru kaynak olduğu proje STATE.md'sinde yazılıdır: onaydan önce prototip, dondurmadan sonra tema/CMS. Aynı şey iki yerde elle yazılıyorsa her değişiklik eşdeğerlik kanıtıyla birleşir.
  2. Kanıtsız kapı yok. "done" = tarih + komut ya da dosya + sonuç. "Temiz", "hazır", "çalışıyor" tek başına kanıt değildir.
  3. İşi yapan onaylamaz. Faz sonu incelemesi işe dahil olmayan bir ajanla yapılır (Terimler: alt ajan).
  4. Geri alınamaz ya da dışa dönük her adım insan onayı ister: canlıya yazma, yayın, alan adı, noindex kaldırma, kredi/para harcama, müşteri adına gönderim, kalıcı silme.
  5. Uydurma veri yok. Bilinmeyen alan null kalır ve open-questions.md'ye yazılır. Gerçekliği temsil eden hiçbir görsel AI ile üretilmez: ürün/ambalaj, ekip, tesis, sertifika, müşteri logosu, proje fotoğrafı.
  6. Durum dosyada yaşar. Konuşma hafızasına güvenilmez. Her oturum STATE.md ile başlar, "sıradaki adım" yazılarak biter.
  7. Platform geçici çözümü kural değildir. adapters/<platform>/known-issues.md'deki her madde yeni projede önce yeniden test edilir, sonra uygulanır.

Ne zaman kullanılır: mod kararı

Mod Faz 2'de seçilir ve decisions.md'ye gerekçesiyle yazılır.

ModNe zamanFazlar
prototype-firstTasarım platform kitinin section sözlüğünü aşıyor; motion yoğun; veri yapılandırılmış ve büyük (≥ 20 kayıt ya da ≥ 2 koleksiyon); gerekli platform desenleri (çok dil, dinamik rota, form) ajansta henüz kanıtlanmamış; müşteri tasarımı platform kurulumundan önce onaylamak istiyor0–12
theme-direct≤ 8 şablon, motion düşük, içerik az, platform kiti olgun0–3, 6, 8–12 (prototip yok; platform orchestrator'ı doğrudan)
takeoverAjansın önceden kurduğu bir tema/site devralınıyor0, 1 (denetim), 2, 8–12
migrationMevcut bir prototip ya da site yeni platforma taşınıyor0, 1, 2, 7 (mevcut sürüm onayı), 8–12

İki aşamalı yolun bedeli: taşıma + eşdeğerlik + kayma riski. Kit olgunlaştıkça theme-direct eşiği yükselir.

Kitteki skill'lerle ilişki

FazSkill / araçKitte mi; kurulu değilse
2 Kararlarsuperpowers paketinin (obra/superpowers) brainstorming skill'i; Claude Code'da adları superpowers: önekiyle görünürKit dışı, isteğe bağlı. Yoksa kararları tek tek soru sorarak al
1–2 Tasarım yönü (kaynak yoksa)sanat yönetimi alt ajanı + yön panosu (blocofy-orchestrator concept-process.md); referans site varsa blocofy-orchestrator reference-recon.mdKitte
3 Spec ve plansuperpowers paketinin writing-plans skill'iKit dışı, isteğe bağlı. Yoksa planı references/phases.md Faz 3 maddelerine göre elle yaz
4 Prototipsuperpowers paketinin subagent-driven-development skill'iKit dışı, isteğe bağlı. Yoksa görev başına taze alt ajan ve görev sonu incelemeyi elle yürüt
4 MotionGSAP skill'leri (gsap-scrolltrigger, gsap-performance, gsap-plugins; greensock/gsap-skills)Kit dışı, isteğe bağlı; platform fazında blocofy-orchestrator kurulu olup olmadığına bakar. Yoksa API'yi kütüphanenin kendi belgesinden doğrula
5 İncelemebağımsız gözden geçiren + bir tasarım eleştirisi skill'i (ör. Claude Code'da design:design-critique)Gözden geçiren zorunlu. Tasarım eleştirisi skill'i kit dışı, isteğe bağlı. Yoksa gözden geçiren eleştiriyi persona görevleri üzerinden kendisi yazar
6 Medyablocofy-media (model matrisi tarihlidir, her projede doğrula)Kitte
8–11 PlatformBlocofy için blocofy-orchestrator → blocofy-platform, blocofy-theme-kit, blocofy-qaKitte
Rapor ve karar sayfalarıajanın sayfa tasarımı skill'i (ör. Claude Code'da artifact-design)Kit dışı, isteğe bağlı. Yoksa düz HTML ya da Markdown dosyası yaz

Kit dışı bir skill kurulu değilse iş durmaz ve insandan kurması istenmez; sağ sütundaki yol izlenir.

Yöntem fazları ve orchestrator fazları

prototype-first modunda bu skill Faz 0–7'yi yürütür. Faz 8–11'de Blocofy adapter'ı çalışırken platform işini blocofy-orchestrator kendi faz makinesiyle (Phase 0–7) yürütür; bu skill capture-map.md'yi teslim eder ve kendi kapılarını denetler. Bu skill'in dosyalarında "Faz N" her zaman yöntemin fazıdır; orchestrator'ınki "orchestrator Phase N" diye yazılır. Aynı numara aynı iş değildir: Faz 4 prototiptir, orchestrator Phase 4 tema kurulumudur.

Yöntem fazıOrchestrator PhaseNot
8 Platform kurulumu0 Bootstrap, 1 Brief, 2 Design DNA, 3 Content modelPhase 1–3 yeniden keşif yapmaz; sözleşmelerini capture-map.md'den yazar. Müşterinin yön seçimi Faz 1–2 ve Faz 7 kayıtlarından gelir
9 Tema taşıma ve eşdeğerlik4 Theme build, 5 Content & media, 6 QAYöntem eşdeğerlik kapısını ekler
10 Yayın öncesi6 QA ve Phase 7 öncesi yayın kapısı (blocofy-qa)Yöntem references/prelaunch-checklist.md'yi ekler
11 Yayın7 Publish & retroCanlıya çıkışı bir kişi Blocofy panelinde onaylar
12 Devir-teslimkarşılığı yokYalnız bu yöntem

İki durum dosyası vardır; her birinin tek yazarı olur:

  • Proje durumu (Faz 0–12): proje kökündeki STATE.md. Yazarı yöntemi yürüten ana oturumdur.
  • Platform kurulum durumu (orchestrator Phase 0–7): .blocofy-build/STATE.md. Yazarı yalnız orchestrator'dır. Blocofy adapter'ı çalışırken proje STATE.md'sinin Faz 8–11 satırları platform ayrıntısı taşımaz: bu dosyayı ve ilgili Phase'i gösterir, yanına yöntemin kendi kapı kanıtını yazar.

Şablon: references/contracts.md.

Fazlar

Her fazın kartı (giriş, yapılacaklar, çıktı, kapı, onay) references/phases.md'de.

#FazGirişSözleşme çıktısıÇıkış kapısı (kanıtlı)Onay
0Intake ve kurulumKapsam/teklif kabulSTATE.md, decisions.md, open-questions.md, .env.localErişimler doğrulandı; gizli bilgi kuralları uygulandı; platform doctor yeşil; çok dilli sitede platformun ikinci dili etkinleştirebildiği doğrulandıAjans
1KeşifFaz 0brief.md, design-dna.md, site-audit.md, content-inventory.csv, url-map.csv (eski URL'ler)Sayfa envanteri tam; eski site tam tarandı; her açık sorunun sahibi varMüşteri: site haritası
2KararlarFaz 1decisions.md: mod, platform, diller, URL şeması, iş modeli, yargı alanı, analitik, bütçelerHer kararın alternatifi ve onaylayanı yazılıMüşteri
3Spec ve planFaz 2spec.md, plan.md, data-schema.md, dom-contract.md, performans + medya bütçesiPlan öz-incelemesi temiz; yer tutucu yokMüşteri: spec
4PrototipPlan onaylıdist/, check çıktısı, görev incelemelericheck 0 hata; 3 genişlikte konsol 0; reduced-motion ve no-JS'de gizli içerik 0; plandaki her görev tamYok
5Bağımsız inceleme ve v2Faz 4docs/qa/*-review.md, v2 planı (düzeltme / yapısal / kreatif)Kritik bulgu 0; prototip bütçeleri tutuyorMüşteri: paketler
6İçerik ve medyaFaz 3 (paralel başlar)content-inventory.csv onay sütunu, .blocofy-build/media-registry.json, .blocofy-build/credits.mdYer tutucu 0 ya da işaretli ve kayıtlı; hak/lisans tam; medya bütçesi aşılmadıMüşteri: metin
7Onay ve dondurma5 + 6client-signoff.md, git etiketi proto-signoffYazılı onay; değişiklik kontrolü başladıMüşteri
8Platform kurulumuFaz 7capture-map.md, platform sözleşmeleri, known-issues yeniden test sonuçlarıFaz 2'de kararlaştırılan diller aktif ve doğrulandı; taslak izolasyonu doğrulandı; her section'ın veri kaynağı çözüldüAjans
9Tema taşıma ve eşdeğerlikFaz 8Tema dizini (taslakta), parity-report.mdMetin birebir (bilinçli farklar kayıtlı); geometri toleransta; tarama 0; content-model ↔ tema section tipleri eşleşiyorYok
10Yayın öncesiFaz 9prelaunch-checklist.md işaretli301 doğrulandı; hukuk metinleri; izin + analitik; gerçek form testi; platform bütçesi ya da kabul edilmiş risk; geri dönüş planıMüşteri + ajans
11YayınAçık onay; canlıya çıkışı kişi onaylarYayın notuSmoke yeşil; noindex kalktı; 7. gün 404/konsol raporuMüşteri
12Devir-teslim ve bakımFaz 11handover.md, eğitim kaydı, retro, prototip arşiv kararıAnahtarlar döndürüldü; editör eğitimi yapıldı; 30. gün SEO kontrolü; dersler kite geri yazıldıMüşteri

Bir faz yeniden açılırsa sonraki tüm fazlar pending'e düşer.

Devam protokolü

  1. Proje STATE.md'sini oku. Kapısı kanıtla kapanmamış ilk faza git. Faz 8–11'deysen .blocofy-build/STATE.md'yi de oku ve blocofy-orchestrator ile devam et.
  2. O fazın girdilerini diskten yeniden oku; konuşma özetine güvenme.
  3. Uzun fazları (sayfa/section taşıma) alt ajanlara böl; ana bağlam koordinasyon, kapı ve kullanıcı iletişimi için kalır.
  4. Oturum sonunda proje STATE.md'sine sıradaki adımı, engelleri ve bekleyen onayları yaz. Kalıcı hafızaya yalnızca işaretçi yaz (ör. "Faz 8 başında known-issues yeniden test edilecek").

Kırmızı bayraklar: dur

  • "Prototip zaten onaylı sayılır" ama client-signoff.md yok.
  • Aynı değişiklik prototip şablonuna ve tema section'ına elle yazıldı, eşdeğerlik çalışmadı.
  • Bir script ya da ajan canlı temaya yazıyor (Blocofy'da --live, theme publish, allow_live) ya da önizlemesi olmayan bir yazım dört satırlık durak olmadan yapılıyor (blocofy-platform references/live-writes.md).
  • Kapı notunda kanıt yok ya da kanıt işi yapanın kendi raporu.
  • AI medya üretimi blocofy-media harcama kapısından geçmeden başladı ya da gerçekliği temsil eden bir görsel üretiliyor.
  • Form bildirim alıcısı müşteriye ait olmayan bir adres ve bu decisions.md'de kayıtlı değil.
  • Rol tanımındaki girdi yolları diskte yok (tanım eskimiş).
  • Platform "başarılı" yanıt verdi, render edilmiş sayfa kontrol edilmedi.
  • Performans kapısı geçmedi ve "kabul edilmiş risk" kaydı yok.
  • Bir geçici çözüm önceki projeden yeniden test edilmeden kopyalandı.

Bahane tablosu

BahaneGerçek
"İşi yapan ajan hazır dedi"İşi yapanın "taşımaya hazır" raporundan sonra bağımsız inceleme kritik eksikler bulabilir; rapor kanıt değildir
"Küçük tasarım değişikliği, eşdeğerlik gerekmez"Tek bir bileşen değişikliği prototip şablonu, tema section'ı, içerik modeli ve veri dosyasına aynı anda dokundu
"Görev incelemesini sona toplu bırakırız"Görev başına inceleme atlanınca eksikler sonda toplu çıkar ve görevlerin çoğu yeniden açılır
"Rol tanımı yazıldı, yeterli"Tanımlar spec değiştikçe güncellenmezse ajan olmayan dosyalara ve eski sayılara göre çalışır
"Test adresinde canlıya yazmak sorun değil"Aynı script yayından sonra değiştirilmeden çalıştırılırsa üretimi onaysız değiştirir. Ajan yalnız taslağa ve tema çalışmasına yazar
"Bu hata düzelmiştir"Düzeldiği yeniden test edilmeden geçici çözüm kaldırılmaz, düzeltilmediği test edilmeden eklenmez
"Lighthouse a11y 100, erişilebilirlik tamam"Otomatik test klavye yolu, ekran okuyucu akışı ve kontrast matrisini kapsamaz

Referanslar

Dosyaİçerik
references/phases.mdFaz 0–12 kartları: giriş, yapılacaklar, çıktı, kapı, onay, STATE satırı örneği
references/contracts.mdProje STATE.md (ve .blocofy-build/STATE.md ile ilişkisi), decisions, open-questions, content-inventory, url-map, data-schema, dom-contract, capture-map, parity-report şablonları; medya kaydının yeri
references/roles.mdYedi rol şablonu (marka sistemi, içerik/IA, frontend, medya, motion, QA/SEO, bağımsız gözden geçiren) ve güncellik kontrolü
references/prototype-architecture.mdStatik prototipin genel mimarisi: veri, i18n, build filtreleri, CSS katmanları, DOM sözleşmesi, check
references/quality-gates.mdÖlçüt, eşik, kanıt dosyası; kitte scripti olmayan kapılar ve yedek kanıt; iki ayrı performans bütçesi
references/prelaunch-checklist.mdSEO taşıma, hukuk, izin/analitik, formlar, performans, erişilebilirlik, güvenlik, geri dönüş
references/change-control.mdDondurma, revizyon talebi, kayma politikası, prototipin emekliye ayrılması, güvenlik ve maliyet kuralları
references/estimates.mdKendi efor verini tutacağın boş tablo ve planlama kuralları
adapters/ADAPTER-TEMPLATE.mdYeni bir CMS için doldurulacak sorular; platform seçimine girdi
adapters/blocofy/README.mdPrototip → Blocofy eşlemesi, taslak hattı, kalıcı platform kuralları
adapters/blocofy/known-issues.mdTarihli hata geçmişi; her sitede yeniden test edilir: test tarifi, geçici çözüm, kaldırma koşulu
templates/Oturum başlatma, revizyon talebi, müşteri onayı, devir-teslim şablonları
examples/lessons.mdHangi hata hangi kurala dönüştü; işe yarayanlar

Related Skills