Hızlı Başlangıç

Bu rehber, ilk seferinde yaklaşık on beş dakikada seni sıfırdan ilk değerlendirilmiş ilanına götürür. Çalışma alanını kuracak, yapay zeka kodlama asistanını açacak ve bir iş ilanı yapıştıracaksın. Ajan gerekiyorsa önce onboarding'i (kısa ilk kurulum görüşmesi) tamamlar, ardından sana eksiksiz bir rapor, bir puan ve ilana göre uyarlanmış bir PDF CV verir.

Neye ihtiyacın var?

Kod yazmayı bilmen gerekmiyor. Bir terminal açıp komut çalıştırabilmen yeterli.

1. Adım: Çalışma alanını kur

career-ops'u kurmak istediğin klasörde bir terminal aç. Önerilen yol tek bir komuttan oluşur; git clone kullanan ileri düzey yol hemen altındadır. Node (22.13+, Node 23'te 23.4+) veya Git eksikse npx çalışmaz; önce ikisini de kur (yukarıdaki gereksinimlere bak).

Önerilen yol: tek komut

npx @santifer/career-ops init

Bu komut en son sürümü ./career-ops klasörüne klonlar, bağımlılıkları kurar ve çalışma alanının yapısını oluşturur. Ayrıca hangi yapay zeka kodlama CLI'ının kurulu olduğunu algılar ve başlamak için doğru komutu söyler. Yalnızca yeni bir klasöre kurulum yapar: ./career-ops zaten varsa ve boş değilse komut hata vererek durur ve hiçbir şeyi değiştirmez, yani tekrar çalıştırmak mevcut bir çalışma alanını onarmaz veya güncellemez.

Bittiğinde çalışma alanına geç:

cd career-ops

git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops
npm install

Headless tarayıcı (tek seferlik)

career-ops birkaç iş için headless Chromium kullanır: PDF oluşturmak, ilanların hâlâ yayında olup olmadığını kontrol etmek ve tam ATS taramaları yapmak. Kurulum aracı bağımlılıklardan sonra bunu otomatik olarak kurar; bu adım senin bilgisayarında başarısız olduysa elle kur:

npx playwright install chromium

PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD ortam değişkeni boş, 0 veya false dışında bir değere ayarlıysa npm install bu indirmeyi atlar; bu durumda yukarıdaki komutu kendin çalıştır. NixOS'ta bu adımı atla: indirilen tarayıcılar orada başlayamaz, çalışan tarayıcıları ise deponun flake dev shell'i sağlar. Ayrıntılar core'un NixOS rehberinde anlatılıyor.

2. Adım: Yapay zeka asistanını aç

career-ops klasörünün içindeyken kurduğun yapay zeka kodlama CLI'ını başlat.

claude

codex

opencode

qwen

copilot

agy

pi

3. Adım: İlk değerlendirmeni çalıştır

Herhangi bir iş ilanının URL'sini kopyala ve sohbete yapıştır. Profilin hazır değilse ajan önce onboarding'i tamamlar. Claude Code, Antigravity CLI veya Pi kullanıyorsan URL'nin başına açık komutu ekle; diğer CLI'larda URL'yi yapıştır ve ajandan auto-pipeline'ı çalıştırmasını iste:

/career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai

Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai

Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai

Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai

Run the auto-pipeline command with the job URL: https://jobs.example.com/senior-engineer-ai

/career-ops https://jobs.example.com/senior-engineer-ai

/skill:career-ops auto-pipeline https://jobs.example.com/senior-engineer-ai

URL'n yoksa ilanın tam metnini sohbete yapıştır. Ajan her iki girdiyi de iş ilanı olarak algılar ve tüm süreci otomatik olarak çalıştırır: işte auto-pipeline budur.

Sonra ne olur?

İlanı yapıştırdıktan sonra career-ops şunları kendi başına yapar:

Tüm süreç yaklaşık bir iki dakika sürer. Bittiğinde career-ops sana puanı ve raporun özetini gösterir.

Sonuçlarını okumak

Raporda Risk Summary'den sonra Score Evidence bölümü yer alır. Bu bölüm beş boyutu kapsar: CV eşleşmesi, North Star uyumu, ücret, kültürel sinyaller ve uyarı işaretleri. Her satırda bir kanıt durumu (supported, partial veya unknown), somut bir kaynak ya da gözlem ve yanıtlanmamış bir soru bulunur. Bölüm; bir kanıt güveni düzeyi (High, Medium veya Low), bunun gerekçesi ve en fazla üç doğrulama önceliğiyle biter.

reports/ içindeki rapor dosyasını aç. Dosya adı {number}-{company}-{date}.md kalıbını izler. İçinde şunları bulursun:

• Puan: 1-5 arası bir sayı. 4,0'ın altındaki bir puan, ilanın büyük olasılıkla sana pek uygun olmadığı anlamına gelir.
• A Bloğu: rolün sade bir dille özeti.
• B Bloğu: CV'nin her gereksinimle nasıl eşleştiğini ve varsa eksikleri gösteren bir tablo.
• C Bloğu: bu rol için kendini nasıl konumlandıracağına dair bir strateji önerisi.
• D Bloğu: ilandaki ücreti piyasa ücretleriyle karşılaştıran bir ücret araştırması.
• E Bloğu: başvurun için kişiselleştirme notları.
• F Bloğu: bu ilana göre uyarlanmış STAR hikayeleriyle mülakat hazırlığı.
• G Bloğu: ilanın güvenilirliği; ilanın hâlâ açık olup olmadığı ve tekrar tekrar yayımlanıp yayımlanmadığı gibi sinyallerin sezgisel bir kontrolü. Bulduklarını bildirir, kararı sana bırakır.
• H Bloğu: başvuru formu için taslak yanıtlar; yalnızca puan 4,5 veya üzeriyse yazılır.

G Bloğu'nun hemen ardından gelen Verdict, kararı kalın harflerle (Apply, Consider, Research first veya Skip) ve yukarıdaki bloklardan çıkarılan tek bir gerekçeyle verir; böylece gerisini okumadan yanıtı öğrenirsin.

İlana göre uyarlanmış PDF CV'n output/ klasöründedir. Bir yere göndermeden önce gözden geçir; career-ops senin onayın olmadan hiçbir şey göndermez.

Şimdi ne yapmalısın?

İlk değerlendirmen tamamlandığına göre keşfedebileceğin birkaç şey var:

• Profilini geliştir. Ajana kendin hakkında yeni bir şey söyle: "Biraz daha bağlam vereyim: az önce X'i yayına aldım." Profili günceller ve sonraki değerlendirmeler daha isabetli olur.
• Daha fazla ilan değerlendir. Başka URL'ler veya iş tanımları yapıştır. Her biri tracker'ına eklenir.
• İş ilanı sitelerini tara. Önceden yapılandırılmış onlarca şirketin kariyer sayfasını tek seferde taramak için /career-ops scan yaz.
• İlanları karşılaştır. Birkaç raporun varsa sıralı bir karşılaştırma almak için /career-ops ofertas yaz.

Sorun giderme

Hata mı buldun, soruların mı var?

Bir şey bu rehberde anlatıldığı gibi çalışmıyorsa lütfen bildir. Hata bildirimleri senden sonra gelen herkesin işine yarar.

• Hata bildir: GitHub deposunda bir issue aç. Ne olmasını beklediğini, gerçekte ne olduğunu anlat ve gördüğün hata mesajını yapıştır.
• Soru sor: Discord topluluğuna katıl. Diğer kullanıcılardan ve yazardan yardım almanın en hızlı yolu budur.
• Düzeltme gönder: Sorunu kendin nasıl düzelteceğini biliyorsan pull request açmadan önce CONTRIBUTING.md dosyasını oku. Kısaca: yeni bir özellik, yeni bir mod veya komut ya da mimari değişiklik için önce issue aç. Hata düzeltmeleri, kimlik doğrulama gerektirmeyen yeni tarama sağlayıcıları, dokümantasyon ve çeviriler doğrudan pull request olarak gönderilebilir.