Claude Code ile Geliştirme

Claude Code, Anthropic’in AI kodlama ajanıdır. IronFlock, Claude Code için ironflock-templates becerisini içeren bir eklenti yayımlar; bu beceri, ajana bir uygulamanın IronFlock’a nasıl entegre olduğunu öğretir. Bu sayede Claude Code, uygulamanızın .ironflock/ klasöründeki dosyaları platformun beklediği biçimde yazar ve siz sürüm yayımlamadan önce bunları kontrol eder:

Dosya	Ajanın yapabilecekleri
`board-template.yml`	Uygulamanın panosunu oluşturma: widget’ları seçme, bunları tablolarınıza bağlama, sayfaları ve gezinmeyi düzenleme
`data-template.yml`	Kodunuzun yayımladığı verilerle eşleşen tabloları ve dönüşümleri tanımlama
`env-template.yml`	Uygulama parametreleri ekleme
`port-template.yml`	Uzaktan erişim için portları bildirme
`ai-template.yml`	Uygulamanın AI ajanlarını ve araçlarını tanımlama

Eklenti GitHub’da herkese açıktır: IronFlock/agent-skills.

Becerinin İçeriği

Beş şablonun tümüne ait JSON Şemaları — https://ironflock.com/schemas/ adresinde yayımlananlarla aynı şemalar.
Pano şablonu için bir kılavuz: veri bağlamaları, filtreler, toplulaştırma, sayfalar, gezinme ve düzen.
Her widget’ın hangi veriler için tasarlandığını açıklayan, tüm pano widget’larını kapsayan bir katalog.
Bir widget’ın yapılandırma şemasını, tam olarak bir panonun kullandığı widget sürümü için okuyan bir araç.
Her şablonu kendi şemasına ve platformun aksi halde ancak kurulum sırasında bildirdiği kurallara göre kontrol eden bir doğrulayıcı — örneğin var olmayan bir sütuna bağlanmış bir widget.

Gereksinimler

Claude Code — Anthropic’in kurulum kılavuzuna bakın.
Doğrulayıcı için Python 3.9 veya üzeri. uv önerilir: uv ile doğrulayıcı bağımlılıklarını kendisi kurar; uv olmadan ise python3 -m pip install pyyaml jsonschema komutunu bir kez çalıştırın.
Widget şemalarının yayımlandığı registry.npmjs.org ve cdn.jsdelivr.net adreslerine internet erişimi.

Beceriyi Kurma

IronFlock eklenti pazar yerini ekleyin, ardından eklentiyi bu pazar yerinden kurun — Claude Code içinde ya da bir terminalden:

Claude Code içinde


/plugin marketplace add IronFlock/agent-skills
/plugin install ironflock@ironflock

Eklenti kullanıcı hesabınız için kurulur; böylece Claude Code onu her projede kullanabilir. Eklenti yeni oturumlarda yüklenir; zaten çalışan bir oturumda /reload-plugins komutunu girin. Kurulumu kontrol etmek için claude plugin list komutunu çalıştırın — listede ironflock@ironflock görünür.

Eklentiyi Güncel Tutma

Claude Code, üçüncü taraf pazar yerlerinden gelen eklentileri yalnızca siz bu özelliği etkinleştirdiğinizde günceller. Özelliği bir kez etkinleştirin: Claude Code’da /plugin komutunu çalıştırın, Marketplaces bölümünü açın, ironflock’u seçin ve Enable auto-update seçeneğini seçin. Ya da elle güncelleyin:


claude plugin marketplace update ironflock
claude plugin update ironflock@ironflock

Ekibiniz için Kurulum

Eklentiyi bir uygulama üzerinde çalışan herkesin kullanımına sunmak için bu dosyayı uygulamanın deposuna .claude/settings.json olarak commit edin:


{
  "extraKnownMarketplaces": {
    "ironflock": {
      "source": { "source": "github", "repo": "IronFlock/agent-skills" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": { "ironflock@ironflock": true }
}

Claude Code, bir ekip üyesi klasöre güvendiğinde dosyayı uygular.

Beceriyi Kullanma

Beceriyi çağırmanız gerekmez. Claude Code, bir IronFlock uygulaması üzerinde çalıştığınızda onu kendiliğinden kullanır — örneğin şunları istediğinizde:

“Bu uygulamaya, her makinenin güncel sıcaklığını bir gösterge ve 24 saatlik bir eğilim grafiğiyle gösteren bir pano ekle.”
“Örnekleme aralığını cihaz başına, 1 ile 60 saniye arasında yapılandırılabilir yap.”
“8080 numaralı porttaki web arayüzünü uzaktan erişime aç.”

Beceriyi açıkça başlatmak için /ironflock:ironflock-templates komutunu girin.

Claude Code, tabloların kodun yayımladığı verilerle eşleşmesi için önce uygulamanızın kodunu okur. Ardından şablonları yazar ve hiç hata kalmayana kadar doğrulayıcıyı çalıştırır. Sonrasında panoyu görsel olarak ayarlamak için UI Builder içinde açabilirsiniz — UI Builder aynı board-template.yml dosyasını okur ve yazar.

Beceri yalnızca uygulamanızın deposundaki dosyaları değiştirir. Değişiklikleri uygulamanızı kullanan projelere ulaştırmak için uygulamanızın yeni bir sürümünü yayımlayın — bkz. Sürümler & Uygulama Mağazası.

Şablonları Ajan Olmadan Doğrulama

Doğrulayıcı tek başına da çalışır, örneğin bir CI pipeline’ında:


git clone https://github.com/IronFlock/agent-skills
uv run agent-skills/plugins/ironflock/skills/ironflock-templates/scripts/validate.py path/to/your-app

Her bulgu için dosya, satır ve yolu içeren bir satır yazdırır; bir hata bulduysa 1 koduyla çıkar.

Kaldırma


claude plugin uninstall ironflock@ironflock
claude plugin marketplace remove ironflock