Belgeler

Kortext sizin ajan CLI'ınızı deponuzun içinde çalıştırır. Her koşu tek bir belge üretir ve taslak olarak bırakır; girdileri yerine oturduğunda proje başına en fazla üç belge paralel yazılır. Taslakları yalnızca siz onaylarsınız.

Bundan üç şey çıkar.

• Sıra bir tercih değildir. Bir belge ancak bağlı olduğu her şey yerine oturduktan sonra yazılır. SECURITY'nin ARCHITECTURE'ı beklemesi ve bir belgeyi onaylamanın sık sık üç belgeyi birden başlatması bundandır.
• Her belge önünüze konur. Atlamayın — okuyun. Bir belge size yöneltilmiş sorular, daha önce yazılmış bir belgeye değişiklik talebi ya da henüz yazılacak bir belgeye not taşıyabilir; bunlar modelin kendi bulgularıdır ve kararınızı beklerler.
• Çalıştığınız tek yer paneldir. kortext'ten sonra hiçbir şey terminal istemez.

Gruplar

Her belge durumuna göre bir grubun altında listelenir; nerede durduğunuzu bir bakışta görürsünüz: Action needed · Doing · To do · Done. Sonuncusu kapalıdır. Sizi bekleyen her belge, durumu ne derse desin, Action needed'a yükselir.

Durumlar ve rozetler

Adın yanındaki sözcük durumdur:

• waiting — sırası gelmedi ya da yazıldı, sizi bekliyor
• writing — CLI'ınız şu an üretiyor
• reading — değişen bir girdiye karşı yeniden okunuyor
• approved — onaylı
• paused — durdurduğunuz bir koşu, sürdürülecek
• failed — hata alan bir koşu, yeniden denenecek; nedeni adın altında, CLI'ın kendi sözcükleriyle
• n/a — bu projenin işine yaramayan bir belge

Yanında bir rozet olabilir:

• approve — onayınızı bekliyor
• review — soruları ya da istekleri var, incelemenizi bekliyor
• recheck — okuduğu bir belge değişti; yeniden okunacak
• revision — ilk yazım değil, yeniden yazım
• n/a? — yazar bu belgenin geçerli olmadığı kanısında ve nedenini söylüyor; Approve n/a bunu karara bağlar. Bir not ve bir revizyon yazarı yine de yazmaya geri gönderir.
• on request — EXPERIENCE.md: zincir asla sıraya koymaz, el sıkışmada sunulur

Bir belgeyi incelemek

Listeden herhangi bir belgeyi açın. Her şey çekmecede olur.

Approve — belge onaylanır, kendinden sonrakilerin referansı olur ve zincir ilerler. Belgenin açık soruları ya da karara bağlanmamış giden bir isteği varken devre dışı kalır.

Ask — bir satır seçin ve sorunuzu sorun. Belgeyi yazan persona o pasaj hakkında yanıt verir. Sorular anlamak içindir, değiştirmek için değil; bu yüzden kaydedilmezler. Birini saklamak isterseniz yanıtın altındaki Use this answer onu notunuz yapar. Başka yere tıklamak sohbeti katlar; yanıta tıklamak devam sorusu için yeniden açar; × kapatır, satır kalır.

Suggest — yazarın önerecek bir şeyi olduğu yerde — düz satır değil, soru ya da istek — Suggest, tek sözcük yazmadan onun ne yapacağını sorar. Use this answer alır; istek satırında Use this as the note not kutusunu Accept ya da Deny için doldurur. Bir soru iki basışta karara bağlanabilir.

Add note → Request revision — notlarınız belgeyi yeniden yazdırır. Belgenin açık sorularından birine bırakılan not yanıt sayılır: soru kaybolur ve ortaya koyduğu gerçek metnin parçası olur.

Edit — ajan gerektirmeyen bir düzeltme için dosyayı kendiniz yazın. Yalnızca metni günceller; değişiklik isteklerini kapatmaz, açık soruları kaldırmaz. Bekleyen istekler varken ikinci bir düğme belirir: Save, requests done — metni kaydeder ve onları kapatır.

Preview — yalnızca DESIGN.md'de. Tasarımcının yazdığı token'lar — renkler, yazı tipleri ve ölçek, boşluklar, köşe yarıçapları, gölgeler — somutlaşmış ve çizilmiş, açık ve koyu modda, her renk kendisine uygulanan kontrasta göre derecelendirilmiş. Aynı sayfa deponuzda .kortext/DESIGN.html olarak durur.

Export — açık belgenin bir kopyasını dosya olarak kaydeder. .kortext/ gizli bir klasördür; dosya seçici göstermez. Bir tasarım yapay zekâsı EXPERIENCE.md'yi istediğinde yol budur. Seçilmiş bir belge kümesi projenin ⚙'sinden tek zip olarak çıkar — bkz. Çalıştırma ve bakım.

Approve anyway — hâlâ birebir şablon satırı taşıyan bir taslak reddedilir; panel satırı söyler, tıklayınca oraya atlar. Okuduysanız ve kararlıysanız ısrar etmenin yolu çekmecenin altında, Request revision'ın yanında bekler.

Action Needed

Belgenin tepesinde: sizden beklediği her şey, gruplar halinde. Bir satır seçin; yanıtladığınız ya da karara bağladığınız ne varsa altta birikir ve Apply'a bastığınızda tek bir yeniden yazıma gider.

Questions — belgenin size sordukları. Birine tıklayın, yanıtlayın, Add note. Her soru yanıtlanmadan belge onaylanamaz.

Incoming Requests — başka belgelerin bu belgeye gönderdiği revizyon istekleri: sözgelimi ENVIRONMENT, log satırlarının log tutmama kararıyla çeliştiğini söylüyor. Satırı seçin, sonra Accept ya da Deny. Deny gerekçe ister. Bir istek belirsizse Ask soruyu isteği yapan belgeye sorar.

Brief'te Accept yoktur — onu bir persona değil siz yazdınız. Yerinde Draft the change durur: ajan, isteği işlenmiş brief'i hazırlar ve editörde açar; Save brief'i günceller ve isteği kapatır.

Apply hepsini tek seferde gönderir. Yanıtlarınız ve kabul ettiğiniz istekler tek bir yeniden yazıma girer. Reddettikleriniz, gerekçesiyle, belgenin ## Decisions bölümüne yazılır. Size yeniden sorulmaz; kodu yazan ajan oradan okur.

Outgoing Requests — bir belge kendinden önce yazılmış bir belgede değişiklik isteyebilir ya da sonra yazılacak bir belgeye not bırakabilir. İsteyen belge hâlâ taslakken istek burada bekler: Accept ya da Discard. Karara bağlanmamış isteği olan bir belge onaylanamaz. Kabul edilince hedefe gider ve orada Incoming Requests altında, işaretli ve accepted there notuyla bekler — bir kez karar verdiniz, işareti yine de kaldırabilirsiniz. Hedefin bir sonraki yeniden yazımına, orada borçlu olunan her şeyle birlikte, tek geçişte girer.

Çekmecenin geri kalanı

Findings — hiçbir belgenin sahiplenmediği dosyalardaki sorunlar (eksik bir .gitignore, sözgelimi), bilginiz için belgeye yazılmış. Sizden bir şey istemezler.

Related documents — bu belgeyi okuyan belgeler. Bunu değiştirin, onlar yeniden okunur. Henüz yazılmamış olanların üstü çizilidir.

Recheck — belge onaylı ama okuduğu bir belge değişti. Sizin işiniz değil: sırası gelince yeniden okunur ve yalnızca gerçek bir çelişki size istek gönderir.

Her şey yerine oturduğunda sıradaki el sıkışmadır.