Skip to content

osrt91/ulak.os

BranchesTags
 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

219 Commits
.claude-plugin
.claude-plugin
 
 
.claude
.claude
 
 
.gemini/commands
.gemini/commands
 
 
.github
.github
 
 
bin
bin
 
 
docs
docs
 
 
evals
evals
 
 
prompts
prompts
 
 
reports
reports
 
 
schemas
schemas
 
 
scripts
scripts
 
 
src
src
 
 
templates
templates
 
 
tests
tests
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.gitleaks.baseline
.gitleaks.baseline
 
 
.gitleaks.toml
.gitleaks.toml
 
 
.mcp.json
.mcp.json
 
 
AGENTS.en.md
AGENTS.en.md
 
 
AGENTS.md
AGENTS.md
 
 
CHANGELOG.md
CHANGELOG.md
 
 
CHATGPT.md
CHATGPT.md
 
 
CLAUDE.en.md
CLAUDE.en.md
 
 
CLAUDE.md
CLAUDE.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
CROSS_PLATFORM.md
CROSS_PLATFORM.md
 
 
DISTRIBUTION.md
DISTRIBUTION.md
 
 
GEMINI.en.md
GEMINI.en.md
 
 
GEMINI.md
GEMINI.md
 
 
LICENSE
LICENSE
 
 
NOTICE.md
NOTICE.md
 
 
OPENCODE.md
OPENCODE.md
 
 
README.en.md
README.en.md
 
 
README.md
README.md
 
 
README_RUN_ME_FIRST.md
README_RUN_ME_FIRST.md
 
 
RELEASE_NOTES_1.0.0.md
RELEASE_NOTES_1.0.0.md
 
 
RELEASE_NOTES_2.0.0.md
RELEASE_NOTES_2.0.0.md
 
 
RELEASE_NOTES_3.0.0.md
RELEASE_NOTES_3.0.0.md
 
 
RELEASE_NOTES_3.1.0.md
RELEASE_NOTES_3.1.0.md
 
 
RELEASE_NOTES_3.2.0.md
RELEASE_NOTES_3.2.0.md
 
 
ROADMAP.md
ROADMAP.md
 
 
SECURITY.md
SECURITY.md
 
 
VERSIONING.md
VERSIONING.md
 
 
VERSION_DISTRIBUTION_MATRIX.md
VERSION_DISTRIBUTION_MATRIX.md
 
 
eslint.config.js
eslint.config.js
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
tsconfig.json
tsconfig.json
 
 
ulak.config.json
ulak.config.json
 
 

Repository files navigation

Ulak OS Cosmic Banner

Ulak OS

AI Kodlama CLI'ları için Sağlayıcıdan Bağımsız Prompt İşletim Sistemi

Projeni Okur · Eksikleri Söyler · Tam Yığın SaaS Üretir


Sürüm Lisans Yıldız

Claude Code Gemini CLI Codex CLI Copilot Chat ChatGPT OpenCode

Türkçe (bu dosya) · English · Dokümanlar · Katalog · Değişiklikler

Çalışma Zamanı Dili: English-first · Açıklamalar: Türkçe dahil lokalize edilebilir · Başlangıç i18n Temeli: tr, en, de, fr, es, ar, ru, pt, zh, ja, ko, it

Ulak OS vendor support

⚡ 30 Saniyede Başla

👋
Yeni Kullanıcı


/ulak-hello

30 Saniyelik Tur
4 Seçenek, Doğrudan Yönlendirme

🔍
Var Olan Proje


/ulak-director

Faz 0→5 Denetim
27 Uzman Paralel

🛠️
Yeni SaaS


/ulak-new

27 Soruluk Sihirbaz
İlk Commit'te Üretime Hazır

📦 Kurulum

# macOS / Linux (Tek Satır)
curl -fsSL https://raw.githubusercontent.com/osrt91/ulak.os/main/scripts/install.sh | sh

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/osrt91/ulak.os/main/scripts/install.ps1 | iex

# Manuel Klon
git clone https://github.com/osrt91/ulak.os.git && cd ulak.os

Sonra: Claude Code / Gemini CLI / Codex / Copilot aç, /ulak-hello yaz. Gerisi menüden.

Sağlama + Alternatif Yollar → docs/runbooks/install-methods.md · Doğrulama → ulak-doctor

💻 CLI Alt Komutları

Ulak OS, yerel analizleri çalıştırmak, kod tabanınızdaki sorunları teşhis etmek, hafıza veri tabanını sorgulamak ve yerel kalite kontrollerini doğrudan çalıştırmak için yerel bir yardımcı CLI aracı içerir. Komutlar /ulak-* slash komutlarıyla aynı stilde tirelidir; boşluklu form da eşdeğer çalışır (ulak-update ≡ ulak update, git tarzı).

# Projeyi Başlatır — Sağlayıcı CLI'ını Tespit Eder, .claude/ + Yapılandırma Kurar
ulak-init

# Proje Yapılandırmasını ve React Hooks/Stil Kalitesini Teşhis Eder
ulak-doctor

# Yerel CI Kontrollerini Çalıştırır (Şema, @-import, Marka)
ulak-validate

# Daha Yeni Bir Ulak OS Sürümünü Kontrol Eder (Salt-Okunur; Yerel Veriye Dokunmaz)
ulak-update

# Artefakt Zinciri Durumunu Gösterir
ulak-status

# Çok Dilli SEO Ayarlarını (robots.txt, sitemap, hreflang) Denetler
ulak-seo

# UI/UX Breakpoint'lerini ve Yükleme İskelet Tasarımlarını Analiz Eder
ulak-ux

# SQLite Bellek Tabanında Geçmiş Oturum Tecrübelerini Arar / Listeler
ulak-memory search "supabase kilitleme"
ulak-memory list

🧭 Mimari

flowchart TD
    U(["Kullanıcı - Slash veya Doğal Dil"]) --> V{Sağlayıcı Adaptörü}
    V --> CC[Claude Code]
    V --> GM[Gemini CLI]
    V --> CX[Codex]
    V --> CT[ChatGPT]
    V --> OC[OpenCode]
    V --> AG[Antigravity]
    V --> CP[Copilot Chat]
    CC --> R[Yönlendirici]
    GM --> R
    CX --> R
    CT --> R
    OC --> R
    AG --> R
    CP --> R
    R --> P0[Faz 0 - Ortam Kilidi]
    P0 --> P1[Faz 1 - Derin Envanter]
    P1 --> P2[Faz 2 - Paralel Kanıt]
    P2 --> P3[Faz 3 - Sürpriz Bulgular]
    P3 --> P4[Faz 4 - Sentez]
    P4 --> P5[Faz 5 - Karar]
    P5 --> A["15 Artefakt - reports/current/"]

    classDef primary fill:#8b5cf6,stroke:#1e1b4b,color:#fff,stroke-width:2px
    classDef vendor fill:#1e1b4b,stroke:#8b5cf6,color:#fff,stroke-width:1px
    classDef phase fill:#312e81,stroke:#8b5cf6,color:#fff,stroke-width:1px
    classDef accent fill:#06b6d4,stroke:#083344,color:#fff,stroke-width:2px
    class U,V,R primary
    class CC,GM,CX,CT,OC,AG,CP vendor
    class P0,P1,P2,P3,P4,P5 phase
    class A accent
Loading

İçe aktarım zinciri: CLAUDE.md → @prompts/core/ulak-os-core-contract-2.0.0.md → 26 çalışma zamanı kuralı + 19 yönetişim dokümanı (toplam 45 @-import). Tek dosyadan tüm katmanlar yüklenir.

🎯 6 Senaryo - Ne Yapabilirim?

1. Yeni SaaS Başlat · 5-10 dk

/ulak-new

27 soru, otomatik dağıtım → kardeş dizinde Next.js + Supabase + ödeme + i18n + CI + dağıtım. İlk commit'te RLS, kimlik doğrulama, webhook, gitleaks temeli hazır.

2. Mevcut Projeyi Denetle · 45-90 dk

/ulak-director

Faz 0→5: derin envanter (dosya+satır) · 4-13 uzman paralel · sürpriz bulgular · yol haritası · doğrulama planı · paket eksiği.

3. Doğal Dille Sor

/ulak-ask "türkçe dil desteği ekle"
/ulak-ask "rls asimetrisi var mı"
/ulak-ask "paket eksiği tara"

Eklenti aramadan, bayrak ezberlemeden. Belirsizse "bunu mu dedin?" diye doğrular.

4. Paket + Kapasite Ara

/ulak-packs
/ulak-gaps
/ulak-mcp

Tüm 24 komut + 12 beceri + 27 ajan tek ekranda. Eksik tespiti + MCP kayıt defteri keşfi.

5. Tanışma Turu

selam ulak       # TR doğal selamlama
hi ulak          # EN doğal selamlama
/ulak-hello      # slash

30 saniyede ilk ekran, 4 seçenek, doğrudan yönlendirme.

6. Teşhis, SEO & UI/UX Analizi

ulak-doctor    # React bileşen kalitesi teşhisi
ulak-seo       # robots.txt, sitemap ve hreflang denetimi
ulak-ux        # Responsive breakpoint ve iskelet kontrolü

Platform bağımsız yerel doğrulama ve kod kokusu denetimi.

Uçtan Uca Rehber: docs/walkthrough/01-first-saas-end-to-end.md - 75 dakikalık pazaryeri senaryosu (Supabase + GitHub + Vercel + Resend + Iyzico)

📊 Kapasite Özeti

24 12 27 24 17 24 36 110
Komut Beceri Ajan Sektör Paketi Kural Paketi Yönetişim Çalışma Zamanı Kuralı Anti-Desen
📂 Detaylı Kırılım Tablosu
Yüzey Sayı Referans
Komutlar 24 .claude/commands/ - /ulak-director, /ulak-new, /ulak-hello, /ulak-scaffold, /ulak-ask, /ulak-verdict, /ulak-scan, /ulak-frontend, /ulak-gaps, /ulak-triage, /ulak-design, /ulak-score, /ulak-extract, /ulak-mcp, /ulak-brainstorm, /ulak-dispatch, /ulak-tdd, /ulak-packs, /ulak-search, /ulak-locale, /ulak-demo, /ulak-explain, /ulak-next, /ulak-skill-proposal
Beceriler 12 .claude/skills/ - saas-scaffolder, fourteen-dimension-audit, god-module-decomposition, multi-agent-orchestration, final-validation, pack-gap-completion, project-intake, research-currency, awesome-packs-index, mcp-governance-auto, skill-plugin-ecosystem-watchlist, react-doctor
Ajanlar 27 .claude/agents/ - 19 uzman + 1 otonom program yönetici + 7 persona (admin, müşteri, bayi, geliştirici, destek, uyum, güvenlik-redteam)
Sektör Overlay Kitleri 15 templates/sectors/ - admin-cms-hardening, ai-copilot, ai-relay-cost-control, container-k8s, ecommerce, education, enterprise-b2b, fintech, health-sensitive, marketplace, media-content, member-gated-community, pwa-desktop, regulated-saas, self-hosted-supabase. Sektör pack tanımları (24): docs/runtime/sector-packs.md
Kural Paketleri 17 docs/runtime/rule-packs/ - typescript-nextjs, python-fastapi, docker-compose, api-security, turkish-locale, localization-ssot, llm-streaming-context-aware, react-native-expo, flutter-ios-2026, multi-locale-eleven-rtl, kvkk-gdpr-compliance, async-python-fastapi, ai-generated-content-hygiene, i18n-routing-discipline, security-primitive-fail-closed, token-budget, web-perf-budget
Yönetişim 24 docs/governance/ - product-surface-split, rule-pack-governance, secrets-rotation-policy, observability-baseline, pattern-import-ledger, settings-permissions-governance, lock-file-hygiene, ai-provider-allowlist, mcp-governance, memory-hygiene, prompt-supply-chain, artefact-write-authorization vb.
Çalışma Zamanı 36 docs/runtime/ - router, intent-router, program-phases (Faz 0-5), artefact-contract, context-budget, output-profiles, active-variable-contract, waves-pattern, live-probe-contract, dual-path-validation, persona-dispatch-pattern, runtime-constants, screen-redesign-template vb.
Anti-Desen 110 61 AP-NN (AP-01..AP-61 - v1.7.0'da AP-21..31 lokalleştirme + async-safety; v1.8.0'da AP-32..40 devDeps-prod-crash/type-escape/i18n-routing/cosmetic-privacy/OG-SEO-drift/half-shipped/sensitive-subject/admin-recovery; v1.9.0'da AP-41..49 fail-open-verify/multi-tenant-secret-coupling/rotate-without-revoke/test-against-prod/CSP-self-defeat/audit-log-oracle/open-redirect/SVG-upload-XSS/timezone-hydration; v3.0.0'da AP-50..55 token-budget + AP-56..61 web-perf-budget) + klasik (IDOR, BOLA, N+1, RLS asimetrisi, ölü kod vb.)
İskelet 125 templates/saas-starter/ - Next.js 16 + TS strict + Tailwind v4 + Supabase SSR + RLS + CI + testler + VPS sıkılaştırma + 59 markalı tasarım referansı

🎛️ Üç Şey Yapar

  Komut Ne Üretir
🔍 Denetler /ulak-director Faz 0→5 protokolü: 27 uzman paralel, 14 boyutlu değerlendirme, ~110 anti-desen taraması, 15 artefakt
⚙️ Yönetir @prompts/core/ulak-os-core-contract-2.0.0.md Çekirdek sözleşme CLAUDE.md'ye içe aktarılır → 26 çalışma zamanı kuralı + 19 yönetişim dokümanı her oturumda aktif; 17 kural paketi + 24 sektör pack runtime sinyaline göre yüklenir
🏗️ İskelet Kurar /ulak-scaffold veya /ulak-new Tam yığın SaaS ilk commit'te - 125 şablon dosya + 8 anti-desen inşa anında kapıda tutulur

💸 Maliyet Şeffaflığı: Komple tarama tüm uygun uzmanları paralel dispatch eder. Sistem, dispatch'ten önce kaç ajanın çalışacağını ve token maliyetinin tek-ajan sorguya kıyasla ~N× artacağını belirtir; parallel_dispatch=N ile sınırlayabilirsin (bilgilendirir, durdurmaz).

🌐 Sağlayıcı Desteği

Sağlayıcı Komut Dağıtımı Durum Adaptör
Claude Code 24 slash (yerel) ✅ Tam ↗ detay
Gemini CLI 25 .toml (yerel) ✅ Tama Yakın ↗ detay
Codex 24 doğal dil ✅ Çekirdek ↗ detay
ChatGPT 24 doğal dil ✅ Çekirdek ↗ detay
OpenCode 24 doğal dil ✅ Çekirdek ↗ detay
Antigravity (AGENTS.md-yerel IDE) 24 doğal dil ✅ Çekirdek ↗ detay
Copilot Chat 22 doğal dil ⚠️ Sınırlı ↗ detay

Disk-Gerçek Eşitlik Doğrulaması: bash scripts/validate-vendor-parity.sh
Kapasite Matrisi: docs/governance/vendor-capability-matrix.md

🛠️ Desteklenen Yığın (/ulak-scaffold)

Katman Birincil Deneysel
ÖnyüzNext.js 16Remix, SvelteKit
ArkayüzSupabase SSRFastAPI + Node hibrit
ÖdemeStripe · Iyzico · ikisi · yok-
MobilExpo 55+ (opsiyonel)Flutter iOS-first (rule pack v2026)
BarındırmaKendi yönettiğin VPS + TraefikVercel · Fly.io · Railway
i18nTR + EN tabanlocalization-ssot paketi ile ≥2 dil

📜 Sürüm Geçmişi

💸 v3.3.02026-06-04Dispatch Maliyet Önizleme - komple tarama ve ağır komutlar dispatch ÖNCESİ kaç ajanın çalışacağını ve token maliyetinin tek-ajan sorguya kıyasla ~N× artacağını belirtir (bilgilendirir, durdurmaz) · `parallel_dispatch=N` cap lever · `/ulak-director` · `/ulak-score` · `/ulak-dispatch` · `/ulak-frontend`
🔗 v3.2.02026-06-03Git Tarzı Tireli CLI Komutları - `ulak-update`, `ulak-doctor`, `ulak-validate` … her alt komutun çalışan tireli alias'ı (boşluklu form da eşdeğer) · shell wrapper isim-tespiti + Node CLI delegasyonu · installer best-effort build · README hardcore Title Case + sayı reconcile (14-boyut, 110 anti-desen, 15 artefakt)
🔄 v3.1.02026-06-03`ulak update` komutu - install-method detect + deny-by-default preserve safety core + atomic apply (supply-chain pinned, sadece release tag) · `ulak validate` false-positive temizliği · 2.0→3.0 geçiş showcase'i · tek-yazar atıf
🚀 v3.0.02026-06-03BREAKING: tüm komutlar tek `/ulak-*` namespace'i · Antigravity 7. terminal (AGENTS.md-native) · osv-scanner dependency-CVE CI gate · react-doctor skill · token-budget + web-perf-budget rule pack'leri (AP-50..61) · spec-vs-disk drift validator · komut/skill/rule/governance sayı reconciliation
🪪 v2.4.02026-04-21Halka açık lansman temeli - 3 manifest'te MIT lisansı · iki dilli README (TR birincil + EN parity) · CONTRIBUTING + CODE_OF_CONDUCT + 4 GitHub şablonu · ikinci proje-adı redaksiyon geçişi (90 dosya)
🔌 v2.3.02026-04-20Plugin paketleme + tam scaffolder - `.claude-plugin` marketplace manifest · 27 scaffolder şablonu · 5 ADR (kural paketi 7. birim · Faz 5 terminal · ürün yüzey ayrımı · pattern import ledger) · 3 ince ajan tam formata genişletildi
🧱 v2.2.02026-04-20Çok-projeli pattern absorpsiyonu + scaffolder altyapısı - 5 sektör paketi · 4 kural paketi · SaaS scaffolder girişi (`/ulak-scaffold` + `saas-scaffolder` becerisi) · 59 markalı tasarım referansı (awesome-design-md) · AP-10..16
⚖️ v2.1.02026-04-11V9 çalışma zamanı disiplini - kanıt güven katmanları (T1-T7) · finding schema · 7 çıktı profili · active variable contract · bağlam bütçesi · eval harness · 8 fazlı program + gate'ler
✅ v2.0.02026-04-09Halka açık temel - English-first GitHub yüzeyi · `ulak.os` metadata · 12 dil starter temeli · no-name/no-secrets handoff · ChatGPT/OpenCode adaptörleri · 11 beceri · premium destekçi/sağlayıcı görselleri
🛡️ v1.9.02026-04-26Security primitive fail-closed disiplini - AP-41..49 · webhook/HMAC/redirect/CSP/secret-rotation guard'ları · pattern import ledger IL-027..036
🌐 v1.8.02026-04-26i18n routing disiplini - lokalize URL metadata · sitemap/hreflang kapsamı · SEO SSOT · AP-32..40 çapraz anti-pattern'ler
🧩 v1.7.02026-04-26Pattern absorption #1/#2 - multi-locale/11-RTL olgunluğu · KVKK/GDPR uyumu · async FastAPI güvenliği · AI-generated content hygiene · AP-21..31
🚀 v1.6.02026-04-21Sağlayıcılar arası parity - Gemini 7→24 yerel · Codex doğal dil · Copilot doğal dil · kapasite matrisi · kullanıcı kılavuzu tazeleme
🚶 v1.5.02026-04-21Uçtan uca rehber #1 (75dk pazaryeri) · "selam ulak" / "hi ulak" doğal selamlama
🧑‍🏫 v1.4.02026-04-21Dış servis eğitimleri - Supabase · Vercel · GitHub · Resend adım adım TR
🎓 v1.3.02026-04-21Başlangıç katmanı - görünürlük · iskelet sonrası onboarding · çift modlu sihirbaz · terim açıklayıcı · demo turu
🧙 v1.2.02026-04-21Sihirbaz derinleştirme - 6 → 27 soru × 5 faz · otomatik dağıtım · katalog eşitleme · 15 komut EN açıklaması
👁️ v1.1.02026-04-21Görünürlük katmanı - ulak-ask · ulak-packs · ulak-search · ulak-new · ulak-hello · ulak-locale
🎉 v1.0.02026-04-21Halka açık yayın - manifest sıfırlama · sürüm notları · CLI takma adı · doküman cilası

Tam notlar: CHANGELOG.md · docs/release/

📚 Daha Fazla Okuma

🎬 Başlangıç

🧰 Referans

  • Katalog - tüm kapasiteler tek yerde
  • Mimari - 4 mermaid diyagramı + açıklama
  • ADR - 6 yönetişim kararı
  • Vitrin - 4 uçtan uca rehber + video senaryosu

🤝 Katkıda Bulun

Mail atmana gerek yok - çatalla, çalıştır, PR aç. Ulak OS topluluk katkısıyla büyüyor.

⚡ 3 Dakikada İlk Katkı

gh repo fork osrt91/ulak.os --clone              # 1) Çatalla + Klonla
cd ulak.os && bash scripts/validate-imports.sh   # 2) Paket Sağlığına Bak
#    (Bir Sektör Paketi Ekle / Yazım Hatası Düzelt / Anti-Desen Yakala)
gh pr create                                     # 3) PR Aç, Şablon Seni Yönlendirir

🎯 Nereden Başlayabilirim?

İstiyorum Git
Küçük bir iş arıyorum good first issue etiketli açık konular
Yeni sektör paketi / anti-desen / kural paketi pattern_contribution şablonu
Hata raporlamak bug_report şablonu
Yeni komut / beceri / ajan fikri feature_request şablonu
Sormak istiyorum, issue açmak istemiyorum Discussions → Soru & Cevap
Derin rehber CONTRIBUTING.md - paket yönetişimi, kanıt kuralları, PR kontrol listesi

📞 İletişim

📄 Lisans - MIT · Çatalla, uyarla, kendi işinde kullan. Atıf yeterli.

👤 Geliştirici - Oğuzhan Sert

💬 İsim Notu - "Ulak" Türkçede haberci/elçi demektir: projeni okur, eksiklerini sana iletir.


Bu doküman Ulak OS v3.3.0 ile günceldir · Derleme Bilgisi: prompts/pack.json · Çekirdek Sözleşme: ulak-os-core-contract-2.0.0.md (şema v2.0 — repo sürümünden bağımsız, dosya adı import zinciri için bilinçli sabit)

About

TR: Sağlayıcıdan bağımsız prompt işletim sistemi - projeni okur, eksikleri söyler, tam yığın SaaS üretir. EN: Vendor-neutral prompt OS for AI coding CLIs - reads your project, surfaces gaps, scaffolds full-stack SaaS. Claude Code · Gemini · Codex · ChatGPT · OpenCode · Antigravity. 24 komut · 27 ajan · 12 skill · 12 dil/locale.

github.com/osrt91/ulak.os#readme

Topics

i18n opencode developer-tools codex saas-starter chatgpt gemini-cli antigravity ai-coding claude-code prompt-os

Resources

Readme

License

MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases 12

Ulak OS v3.1.0 — ulak update (server-driven pack refresh) + validate fixes Latest
Jun 3, 2026
+ 11 releases

Packages

 
 
 

Contributors

Languages

  • TypeScript 54.7%
  • Shell 32.6%
  • PowerShell 7.3%
  • Python 4.0%
  • JavaScript 1.4%