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.

node-servicepython-servicenextjs-app

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