Agentic Trader Rehberi

Agentic Trader nedir

Agentic Trader local-first çalışan bir trading araştırma ve paper-operation sistemidir. Market context, specialist analizleri, memory/review kanıtı, broker durumu ve operatör kontrollerini tek bir denetlenebilir runtime içinde toplar.

Mevcut V1 duruşu bilinçli olarak temkinlidir:

• varsayılan mod paper trading'dir
• desteklenen V1 aktif al-sat yolu approval ve readiness gate'lerinden geçmelidir
• gate'siz real-money execution blokludur
• readiness gate'leri açık olmalıdır
• eksik provider, broker veya model kanıtı görünür kalmalıdır
• her operatör yüzeyi aynı runtime gerçeğini anlatmalıdır

Bu rehberi sistemi bugün ne yapabildiğini anlamak, güvenli çalıştırmak ve bir kararı bir sonraki karara güvenmeden önce incelemek için kullan.

Operatör görevine göre okuma yolları

İlk kurulum

1. Başlangıç sayfasını oku.
2. doctor, provider-diagnostics ve v1-readiness kontrollerini çalıştır.
3. Ink control room ya da Web GUI'yi alt katman kontrolleri uyumlu olduktan sonra aç.

Paper cycle öncesi

1. Runtime And Operations sayfasını oku.
2. Provider, model, broker ve runtime-mode hazır oluşunu kontrol et.
3. Web GUI veya observer yüzeylerini localhost dışına açmadan önce Güvenlik Duruşu sayfasını oku.
4. Broker, account, approval, risk ve kill-switch gate'leri açıkça aksini göstermedikçe koşuyu paper-first tut.

Ne olduğunu inceleme

1. Hafıza ve Review sayfasını oku.
2. Review snapshot, market context, broker durumu, loglar ve evidence bundle'ı incele.
3. Eksik veya stale kanıtı kozmetik uyarı değil, gerçek sinyal olarak değerlendir.

Kafa karıştıran durumları çözme

1. QA And Debugging sayfasını oku.
2. CLI JSON, observer API, Rich/Ink/Web GUI durumu ve persist edilmiş kayıtları karşılaştır.
3. Tek bir UI banner'ının söylediğinden çok runtime kanıtına güven.

Katkı verenler için yol

Kod değiştiriyorsan operatör yolundan sonra şunları oku:

1. Architecture
2. Agent Pipeline
3. Operator Surfaces
4. Frontend System

Temel vazgeçilmezler

• Varsayılan çalışma biçimi local-first kalmalı.
• Varsayılan execution modu paper trading kalmalı.
• Degrade truth'u gizleyen sessiz fallback'ler kabul edilemez.
• CLI, Rich, Ink, observer API ve Web GUI aynı runtime state'i anlatmalı.
• Docs uygulaması ve Web GUI mevcut runtime'ın etrafındaki kabuklardır; onun yerine geçmezler.

Bu rehber neyi açıklamalı

Bu docs sitesi önce operatör sorularına cevap vermeli:

• Agentic Trader bugün ne yapabilir?
• Hangi moddayım: training, lokal paper, external paper readiness, yoksa blocked live?
• Sistem gerçekte hangi veriyi gördü?
• Bir aksiyonu neden approve, block, hold veya reject etti?
• Broker/account, runtime, memory ve review gerçeğini nereden doğrulayabilirim?

Katkı veren notları sistemin bakımına yardım ettiği yerde kalmalı, ama ürün anlatısının ve operasyonel risklerin önüne geçmemeli.

Katkı bakım sözleşmesi

Bir değişiklik runtime davranışını, ürün yönünü, operatör workflow'unu veya geliştirici varsayımlarını etkiliyorsa aynı branch içinde şunları birlikte güncelle:

• etkilenen docs sayfası
• .ai/current-state.instructions.md
• .ai/tasks.instructions.md
• .ai/decisions.instructions.md

Böylece docs sitesi, repo hafızası ve gerçek implementasyon birbirinden kopmaz.