Geliştirici DokümanlarıFumadocs + MDXLocal-first

Operatörün gördüğü runtime gerçeğiyle aynı yerden geliştir.

Agentic Trader ikinci derece bir sohbet demosu değil. Bu docs yüzeyi; inspect edilebilir depolama, açık güvenlik kapıları ve CLI, Ink, observer API ile Web GUI arasında paylaşılan sözleşmeler üzerine kurulu paper-first bir trading runtime için geliştirici yüzeyidir.

Runtime öncelikli
Bir cycle'a güvenmeden önce model servisi, runtime durumu, broker durumu ve review yüzeyleri birbiriyle uyuşmalı.
Güvenlik kapılı
Paper execution, strict LLM gating, provider görünürlüğü ve sessiz runtime fallback yokluğu vazgeçilmezdir.
Çoklu yüzey
CLI, Rich, Ink, observer API ve Web GUI ayrı UI doğruları üretmek yerine aynı sözleşmelerin üstünde çalışır.
Güncel V1 odağı
Proje şu anda sertleştirme aşamasında; paralel bir sistem icat etme aşamasında değil.
İsteğe bağlı app-managed Ollama supervision mevcut daemon ve log yüzeyini genişletmeli.
`webgui` ince bir local kabuk olarak kalırken `docs` kanonik geliştirici yüzeyi olmalı.
Bootstrap, provider hazırlığı ve QA kanıtları daha standart bir onboarding yoluna taşınıyor.
Kurulum
Başlangıç
Depoyu kur, doctor çalıştır, model hazırlığını doğrula ve ana operatör yüzeylerini aç.
Sistem haritası
Mimari
Paket sahipliğini, runtime sınırlarını ve neden paralel bir orkestrasyon katmanı istemediğimizi oku.
Operasyon
Runtime ve Operasyon
Modları, supervision, logları, stop kontrollerini ve operatöre görünen runtime gerçeğini anla.
Sinyaller
Veri ve Zekâ Katmanı
Market context, provider normalization ve feature bundle'ların agent graph'i nasıl beslediğini gör.
Frontend
Frontend Sistemi
`docs` ile `webgui`yi paylaşılan shadcn preset'i, JetBrains Mono tipografi ve modüler dosya organizasyonu üzerinden hizalı tut.
Süreklilik
Hafıza ve Review
Docs, `.ai` notları, feedback taslakları ve review artefact'lerinin runtime gerçeğiyle nasıl hizalı kaldığını gör.
Doğrulama
QA ve Debugging
Bir değişikliği yayınlanabilir saymadan önce smoke QA, runtime kanıtı ve operatör-gerçeği kontrollerini kullan.
Kurulum izi
Önce `README.md`yi oku, sonra `doctor`, local model hazırlığı ve docs hızlı başlangıcı ile ortamı doğrula.
Mimari izi
Edit yapmadan önce en küçük sahip modülü bulmak için `dev/code-map.md` ve mimari docs'unu birlikte kullan.
Frontend izi
`webgui` ve `docs` Next.js App Router, Tailwind v4 ve shadcn primitive'lerini paylaşır; ama erken paylaşılan paket icat etmemelidir.

Dokümanlar runtime gerçeğine yakın durmalı; ikinci bir mimari anlatısı olmamalı.