Skip to content

Harmonia

AI ajan destekli açık proje template platformu.

Tema: uyum, düzen, denge.

Platform Nedir

Harmonia, yazılım projelerine hızlı, tutarlı ve güvenli bir başlangıç sağlamak için tasarlanmış bir template platformudur. Her template belirli bir problemi çözmek ya da belirli bir mimari kararı karşılamak üzere hazırlanır; scaffold anında hazır workspace iskeletine, CI/release altyapısına ve araç entegrasyonlarına dönüşür.

flowchart LR
    H["🏛️ Harmonia\nPlatform"]

    subgraph catalog["📚 Template Kataloğu"]
        T1["📦 demo-commercial-template\nv1.0.0"]
        T2["📦 workspace-with-demo\nv1.0.0"]
    end

    S["⚡ Scaffold"]
    W["🗂️ Workspace\n(CI · yapı · araçlar)"]

    H --> catalog
    T1 -->|"seçilir"| S
    T2 -->|"seçilir"| S
    S -->|"üretir"| W

Temel Özellikler

  • Büyüyen Template Kataloğu

    Her template farklı bir mimari karar veya problemi karşılar. Platform büyüdükçe katalog genişler; doğru template seçilir, workspace dakikalar içinde hazır olur.

  • Manifest-Driven Yapı

    Her template kendi .github/template-manifest.yml contract'ıyla gelir. İçerik, PR'larda otomatik doğrulanır; beklenti dışı değişiklik CI'dan geçemez.

  • Single-Source Disiplini

    Versiyon, changelog, README baseline ve manifest; birlikte taşınır, hiçbiri tek başına değişmez. Tutarsızlık pipeline tarafından engellenir.

  • Scaffold Otomasyonu

    Template seç, parametreleri ver — tek komutla hazır workspace, başlangıç dosyaları ve CI/CD altyapısı üretilir.

  • Tag-Gated Release Disiplini

    main branch yalnız tag'li durumları barındırır. Her template'de versiyon disiplini zorunludur; tagsiz merge kabul edilmez.

  • AI Ajan Uyumu

    Her template Claude Code, GitHub Copilot ve diğer ajanlar için hazır operasyon kurallarıyla gelir; AI desteği kurulum gerektirmez.

Hızlı Başlangıç

demo-commercial-template örneği

Aşağıdaki komutlar mevcut katalogdaki demo-commercial-template için gösterilmektedir. Diğer template'ler için aşağıdaki Template Kataloğu bölümüne bakın.

powershell pwsh -File ./templates/demo-commercial-template/development/scripts/scaffold-demo-commercial.ps1 ` -TargetPath "D:\work\my-product-workspace" ` -Stack node-service ` -InitGitRepos

powershell pwsh -File ./templates/demo-commercial-template/development/scripts/scaffold-demo-commercial.ps1 ` -TargetPath "D:\work\my-product-workspace" ` -Stack python-service ` -InitGitRepos

powershell pwsh -File ./templates/demo-commercial-template/development/scripts/scaffold-demo-commercial.ps1 ` -TargetPath "D:\work\my-product-workspace" ` -Stack nextjs-app ` -InitGitRepos

Gereksinim

PowerShell 7+ gereklidir. Linux/WSL'de ve Windows'ta pwsh kullanın.

Adım adım kurulum için Başlarken → Workspace Oluşturma sayfasına gidin.

Template Kataloğu

Template Versiyon Ne Çözer
demo-commercial-template v1.0.0 Bir ürünü public demo + private commercial olarak iki bağımsız repo halinde yönetme
workspace-with-demo v1.0.0 Private workspace + public demo submodule; güvenli, filtrelenmiş halka açık sürüm

Lisans

TBD