FLAMANGO

Bir yazılım/teknoloji hizmet şirketinin tamamını yapay zeka ajan kadrosuyla modelleyen açık kaynak iskelet. FLAMANGO, proje bazlı iş üreten bir hizmet şirketinin bütün işleyişini — satış → teklif → sözleşme → geliştirme → test → teslim → fatura → tahsilat zincirini — 16 tanımlı rolden oluşan bir ajan kadrosuyla uçtan uca yürütmeyi hedefler. Hedeflenen model: tek bir insanın (Kurucu) yalnızca kritik onay kapılarında devreye girdiği, geri kalan tüm işleyişin ajanlarla yürüdüğü bir şirket. Ajanlar ortak bir defter (SQLite) üzerinde çalışır; her eylem iz bırakır, her kritik karar Kurucu onayına bağlanır.

Ne var?

• ajanlar/ — 16 ajan paketi. Her paket: AJAN.md (görev tanımı, sorumluluk sınırı, eskalasyon kuralları), system-prompt.md (modele verilen kimlik), arac-yetkileri.yaml (hangi araca/tabloya dokunabilir), skills/.
• omurga/ — ortak defter: 16 tablolu SQLite şeması (fırsat → teklif → sözleşme → proje → iş kaydı → test → teslim → fatura → tahsilat zinciri + onay kapıları) ve uçtan uca test senaryoları.
• calistirici/ — model-bağımsız koşturucu: bir ajanı seç, modelini seç, konuş.
• iletisim/ — kurucu-ajan haberleşmesi: onay kuyruğu, onay uygulama, günlük özet.
• panel/ — defteri okuyan basit izleme paneli (yerel web).
• 00-analiz/, testler/ — tasarım notları, bilinen eksikler, senaryo testleri.

Organizasyon

16 rol, üç direktörlük altında toplanır; tepede tek insan (Kurucu) vardır:

Kurucu (insan — kritik onay kapıları K1-K8)
└── GK   Genel Koordinatör
    ├── TİC  Ticaret Direktörü
    │   ├── SG   Satış Geliştirme
    │   ├── MT   Müşteri Temsilcisi
    │   └── PZ   Pazarlama ve İçerik
    ├── TES  Teslim Direktörü
    │   ├── ÇM   Çözüm Mimarı
    │   ├── TSY  Teslim Yöneticisi
    │   │   ├── TST  Test
    │   │   └── GEL  Geliştirici (4 dal)
    │   └── DVO  Altyapı ve Güvenlik *
    └── KUR  Kurumsal İşler Direktörü
        ├── MAL  Mali İşler
        ├── HUK  Sözleşme ve Uyum
        ├── KDR  Kadro ve Yetki
        └── KLT  Kalite Kapısı

* DVO çift bağlıdır (bilinçli tasarım): günlük/teknik işte TES'e, güvenlik konularında doğrudan KUR'a rapor eder — güvenlik vetosu teslim baskısına ezdirilmez.

Her rolün ayrıntılı görev tanımı kendi ajanlar/<KOD>/AJAN.md dosyasındadır; 16 rolün özet tablosu (rapor hatları, onay noktaları) ajanlar/KADRO.md'dedir.

Hızlı başlangıç

git clone <repo>
cd flamango
pip install -r calistirici/requirements.txt
cp .env.example .env        # anahtarını yaz (yerel model için gerek yok)

# Yerel model ile (ücretsiz, anahtarsız — önce https://ollama.com kur):
ollama pull llama3.1
python calistirici/calistir.py --ajan GK

# Claude ile:
python calistirici/calistir.py --ajan GK --model anthropic/claude-sonnet-4-5
# OpenAI ile:
python calistirici/calistir.py --ajan TIC --model openai/gpt-4o
# Gemini ile:
python calistirici/calistir.py --ajan HUK --model gemini/gemini-2.0-flash

Koşturucu ilk açılışta ortak defteri (omurga/defter.db) şemadan oluşturur; her oturumun kaydı calisma/oturumlar/ altına düşer.

Model desteği

Koşturucu LiteLLM üzerinden çalışır: Anthropic (Claude), OpenAI, Google Gemini, Ollama (tamamen yerel) ve tüm OpenAI-uyumlu uçlar (LM Studio, Groq, vLLM...). Model tek parametre: --model sağlayıcı/model-adı.

Tasarım ilkeleri

1. İnsan onay kapıları: Fiyat, sözleşme, fatura gibi kararlar ajanlarda değil, kurucudadır. 8 onay kapısı (K1-K8) tanımlıdır; ajanlar bu kapıları kendi başına geçemez.
2. Sorumluluk sınırları: Her ajanın "yapar / yapmaz / sınır ihlali örneği" üçlüsü yazılıdır; eskalasyon 2 tur kuralıyla yukarı taşınır, sessizce bekletmek yasaktır.
3. Tek gerçek kaynak: Bütün iş, ortak defterdeki kayıtlar üzerinden yürür; ajan eylemleri iz bırakır.

Durum ve yol haritası

Ajanlar arası iş devri zinciri sistemde tanımlı ve testlerle doğrulanmıştır: satış → teklif → sözleşme → proje → geliştirme → test → teslim → fatura → tahsilat akışı ile 9 ayrı senaryo (eskalasyon, kalite kapısı, güvenlik vetosu, rol devri...) ortak defter üzerinde uçtan uca koşar ve tamamı geçer (testler/omurga-testleri.sh).

Koşturucu bu sürümde ajanları tek tek çalıştırır: bir ajanı seçer, konuşur, ajan ortak deftere yazar. Bir ajanın çıktısını sıradaki ajana kendiliğinden aktaran canlı orkestratör döngüsü yol haritasındadır; 00-analiz/04-bilinen-tasarim-eksikleri.md dürüst eksik listesidir. Katkı memnuniyetle karşılanır.

Lisans

Apache-2.0 — bkz. LICENSE.