Projeni okur · eksikleri söyler · tam yığın SaaS üretir
🇹🇷 Türkçe (bu dosya) · 🇬🇧 English · 📚 Docs · 🗺️ Catalog · 📝 Changelog
30 saniyelik tur |
Phase 0→5 denetim |
27 soruluk sihirbaz |
# 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-osSonra: 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
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 CLI]
V --> CP[Copilot Chat]
CC --> R[Router]
GM --> R
CX --> R
CP --> R
R --> P0[Phase 0 - Ortam]
P0 --> P1[Phase 1 - Derin Envanter]
P1 --> P2[Phase 2 - Paralel Kanıt]
P2 --> P3[Phase 3 - Did-You-Know]
P3 --> P4[Phase 4 - Sentez]
P4 --> P5[Phase 5 - Karar]
P5 --> A[13 Artefakt<br/>reports/current/]
classDef primary fill:#ea580c,stroke:#7c2d12,color:#fff,stroke-width:2px
classDef accent fill:#10b981,stroke:#047857,color:#fff,stroke-width:2px
class V,R primary
class A accent
İç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 + 4 sağlayıcı adaptörü. Tek dosyadan tüm katmanlar yüklenir.
|
1. Yeni SaaS başlat · /ulak-start27 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 · /director komplePhase 0→5: derin envanter (dosya+satır) · 4-13 uzman paralel · did-you-know · 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
/pack-gap-audit
/ulak-mcp-discoverTüm 24 komut + 10 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 # slash30 saniyede ilk ekran, 4 seçenek, doğrudan yönlendirme. |
6. Güncelle + doğrula git pull origin main
ulak doctor
bash scripts/validate-*.shPlatform bağımsız doğrulayıcı zinciri. Hepsi yeşilse paket sağlıklı. |
Uçtan uca rehber: docs/walkthrough/01-first-saas-end-to-end.md — 75 dakikalık pazaryeri senaryosu (Supabase + GitHub + Vercel + Resend + Iyzico)
| 24 | 10 | 27 | 15 | 9 | 23 | 36 | ~100 |
|---|---|---|---|---|---|---|---|
| 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/ — /director, /ulak-start, /ulak-hello, /ulak-scaffold, /ulak-ask, /final-verdict, /intake, /frontend-war-room, /pack-gap-audit, /triage-build, /ulak-design-ref, /ulak-audit-deep, /ulak-pattern-extract, /ulak-mcp-discover, /ulak-brainstorm, /ulak-subagent-dispatch, /ulak-test-driven, /ulak-packs, /ulak-search, /ulak-locale, /ulak-intake, /ulak-demo, /ulak-explain, /ulak-next-steps |
| Beceriler | 10 | .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 |
| 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 paketleri | 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 |
| Kural paketleri | 15 | 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 |
| Yönetişim | 23 | 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 (Phase 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 | ~100 | 49 AP-NN (AP-01..AP-49 — 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) + 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ı |
| Komut | Ne üretir | |
|---|---|---|
| 🔍 Denetler | /director komple |
Phase 0→5 protokolü: 27 uzman paralel, 15 boyutlu değerlendirme, ~100 anti-desen taraması, 13 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 → 23 yönetişim + 15 sektör + 9 kural paketi her oturumda aktif |
| 🏗️ İskelet kurar | /ulak-scaffold veya /ulak-start |
Tam yığın SaaS ilk commit'te — 125 şablon dosya + 8 anti-desen inşa anında kapıda tutulur |
| Sağlayıcı | Komut dağıtımı | Durum | Adaptör |
|---|---|---|---|
| Claude Code | 24 slash (yerel) | ✅ FULL | ↗ detay |
| Gemini CLI | 24 .toml (yerel) |
✅ FULL-MINUS | ↗ detay |
| Codex CLI | 24 doğal dil | ✅ CORE | ↗ detay |
| Copilot Chat | 22 doğal dil | ↗ detay |
Disk-gerçek parity doğrulaması:
bash scripts/validate-vendor-parity.sh
Kapasite matrisi:docs/governance/vendor-capability-matrix.md
| Katman | Birincil | Deneysel |
|---|---|---|
| Önyüz | Next.js 16 | Remix, SvelteKit |
| Arkayüz | Supabase SSR | FastAPI + Node hibrit |
| Ödeme | Stripe · Iyzico · ikisi · yok | — |
| Mobil | Expo 55+ (opsiyonel) | Flutter iOS-first (rule pack v2026) |
| Barındırma | Kendi yönettiğin VPS + Traefik | Vercel · Fly.io · Railway |
| i18n | TR + EN taban | localization-ssot paketi ile ≥2 dil |
| 🚀 v1.6.0-final | 2026-04-21 | Sağ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.0 | 2026-04-21 | Uçtan uca rehber #1 (75dk pazaryeri) · "selam ulak" / "hi ulak" doğal selamlama |
| 🧑🏫 v1.4.0 | 2026-04-21 | Dış servis eğitimleri — Supabase · Vercel · GitHub · Resend adım adım TR |
| 🎓 v1.3.0 | 2026-04-21 | Başlangıç katmanı — görünürlük · iskelet sonrası onboarding · çift modlu sihirbaz · terim açıklayıcı · demo turu |
| 🧙 v1.2.0 | 2026-04-21 | Sihirbaz derinleştirme — 6 → 27 soru × 5 faz · otomatik dağıtım · katalog eşitleme · 15 komut EN açıklaması |
| 👁️ v1.1.0 | 2026-04-21 | Görünürlük katmanı — ulak-ask · ulak-packs · ulak-search · ulak-start · ulak-hello · ulak-locale |
| 🎉 v1.0.0 | 2026-04-21 | Halka açık yayın — manifest sıfırlama · sürüm notları · CLI takma adı · doküman cilası |
Tam notlar: CHANGELOG.md · docs/release/
|
🎬 Başlangıç
|
🧰 Referans |
Mail atmana gerek yok — çatalla, çalıştır, PR aç. Ulak OS topluluk katkısıyla büyüyor.
gh repo fork osrt91/ulak-os --clone # 1) fork + 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| İ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 |
- Genel soru / öneri / fikir → GitHub Discussions (mail'den hızlı cevap)
- Hata raporu → Issues
- 🔒 Güvenlik açığı → issue AÇMAYIN, doğrudan mail:
info@oguzhansert.dev(SECURITY.md) - Davranış Kuralları — topluluk standardı
📄 Lisans — MIT · çatalla, uyarla, kendi operasyonuna uygula. Atıf yeterli.
👤 Sorumlu — Oğuzhan Sert · info@oguzhansert.dev
Ulak OS v1.9.0 itibarıyla yetkili · Derleme bilgisi: prompts/pack.json · Çekirdek sözleşme: ulak-os-core-contract-2.0.0.md