Pazar araştırma ajanı

DemandRift

DemandRift — Startup Market Intelligence Agent.

DemandRift, kanıt odaklı bir girişim araştırma ve karar platformudur. Erken aşamadaki bir fikri izlenebilir bir araştırma özetine dönüştürür, izin verilen pazar kanıtlarını toplayıp normalize eder, hâlâ bilinmeyenleri belirler ve savunulabilir bir yön üretir: Build, Modify, Kill veya Investigate More.

Ürün vaadi

Fikrinizi sadece doğrulamayın. Kurulmaya hazır bir MVP ile çıkın.

Depo durumu

Bu depo şu anda Faz 1–7 için onaylanmış mimari ve uygulama planlarını içerir. Bir planlama temelidir; uygulama çalışma zamanının hâlihazırda uygulandığı iddiası değildir. Faz 8, açıkça onaylanana kadar bilinçli olarak kapsam dışıdır.

Araştırma yaşam döngüsü

Faz	Sorumluluk	Ana çıktı
1 — Intake	Alan kökenlerini ve varsayımları koruyarak belirsiz bir fikri, kullanıcının onayladığı araştırılabilir bir özete dönüştürmek.	IdeaBriefVersion
2 — Planning	Araştırma sorularını, kaynak/sorgu kapsamını, pazar ve dil kapsamını ve bir bütçe sözleşmesini derlemek.	ResearchPlanVersion
3 — Acquisition	Politika onaylı kaynaklardan; köken, yürütme durumu, maliyet ve erişim meta verisiyle ham kanıt toplamak.	RawArtifact set
4 — Normalization	Değişmez artefaktları ayrıştırıp normalize etmek; segmentler, tekilleştirme ilişkileri, varlık adayları ve soy bilgisi üretmek.	Normalized corpus
5 — Gap policy	İkincil araştırma boşluklarını denetlemek ve politika ile bütçe izin verdiğinde boşluk odaklı işi Faz 3 toplama çalışma zamanına geri yönlendirmek.	Gap-closure trace
6 — Analysis	Atıfla bağlanmış iddialar, bağımsızlık grupları, kümeler, kanıt haritaları, karşı kanıt ve sınıflandırılmış araştırma boşlukları oluşturmak.	AnalysisDossier
7 — Decision	Deterministik yeterlilik ve karar geçitlerini uygulamak, ardından temellendirilmiş ve sürümlenmiş bir karar dosyası üretmek.	DecisionDossier

Çekirdek akış şudur:

Intake -> Plan -> Acquire -> Normalize -> Analyze -> Decide
           ^                                |
           |                                v
           +-------------------------- Gap policy

Faz 5 ikinci bir toplama hattı oluşturmaz. Faz 3, 4 ve 6 üzerinden sınırlı bir gap_driven döngüyü kontrol eder. Birincil doğrulama boşlukları ayrı tutulur ve ek web araştırmasıyla kapatılamaz.

Planlanan platform mimarisi

DemandRift, faz modülleri arasında açık ve sürümlenmiş sözleşmeleri olan bir TypeScript/Node.js modüler monoliti olarak tasarlanmıştır.

Web ve API katmanı için Next.js
Birincil işlemsel ve analitik depo olarak PostgreSQL
Değişmez ham artefaktlar için S3 uyumlu nesne depolama
Dayanıklı iş akışları için, bir adaptör sınırı arkasında Temporal
Şema doğrulama, model yönlendirme, prompt sürümleme ve maliyet muhasebesi içeren, sağlayıcıdan bağımsız bir AI Gateway
Paylaşılan bir Egress Gateway arkasında, politika denetimli bir bağlayıcı çalışma zamanı
İsteğe bağlı izole Playwright ve Python analitik worker’ları
OpenTelemetry tabanlı trace’ler, metrikler, yapılandırılmış loglar ve denetim kayıtları

Kesişen platform modülleri; kiracı izolasyonu, kaynak politikası, iş akışı durumu, bütçe rezervasyonları, atıf bağlama, depolama ve gözlemlenebilirliğin sahibidir. Paylaşılan sözleşmelerin Zod ve JSON Schema kullanılarak packages/contracts altında yer alması planlanmaktadır.

Tavizsiz kanıt kuralları

Doğrulanmamış bir yapay zekâ hipotezi araştırmayı başlatamaz.
Bir arama sonucu getirilmiş kanıt değildir; erişilemeyen bir kaynak da “sonuç yok” bulgusu değildir.
Kopyalar ve yeniden paylaşımlar bağımsız kanıt değildir.
Bir atıf, tam alıntıyı offset’lere, içerik hash’lerine ve bir normalizasyon sürümüne bağlamalıdır.
Beyan edilen ödeme isteği, gözlemlenmiş ödeme davranışı değildir.
Şikâyetin yokluğu, memnuniyetin kanıtı değildir.
Yeni bir pazarda kanıt kıtlığı, tek başına bir Kill sinyali değildir.
Yapay zekâ; kaynak, kiracı, bütçe, atıf veya karar politikası geçitlerini atlayamaz.

Planlama dokümanları

Proje dokümanlarını şu sırayla okuyun:

Ust-Yonetim-Ana-Mimari-Plani.md — sistem kapsamı, faz sınırları ve entegrasyon sırası
Platform-Temeli.md — paylaşılan teknik mimari ve değişmezler
Faz1-Plan.md — Faz7-Plan.md — faza özgü planlar
.orchestrator/SYSTEM.md — teslim kontrol düzlemi ve kanıta dayalı iş kalemi yaşam döngüsü

Yerel yapılandırma

Yalnızca güvenli şablonlar commit edilir. Uygun şablonu kopyalayın ve boş ya da replace-with-* değerlerini yerelde değiştirin:

Copy-Item .env.example .env.local

İzole test yapılandırması için temel olarak .env.test.example kullanın. Gerçek .env varyantları Git tarafından yok sayılır ve asla commit edilmemelidir.