
Almanac Seed
Almanac Seed, bir yapay zeka kodlama aracısının iğne ile sabitlenmiş yorumlar, iş parçacıklı tartışmalar, tepkiler, çözümleme, canlı varlık ve yapay zeka inceleyicileri için başlık korumalı bir API ile tam bir Next.js 14, Figma tarzı HTML tasarım inceleme uygulamasını oluşturmasına ve kendi kendini doğrulamasına olanak tanıyan tek dosyalı bir SEED.md tarifidir.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure

Ürün Bilgisi
Güncellendi:Jun 8, 2026
Almanac Seed Nedir
Almanac Seed, Almanac için bağımsız bir "ürün tohumudur"; Figma'nın iğne tabanlı yorumlamasına benzer şekilde, ancak web prototipleri ve tek dosyalı HTML keşifleri için doğrudan işlenmiş HTML yapıtları üzerine yorum yapmak üzere oluşturulmuş, yerel olarak barındırılabilir bir tasarım inceleme aracıdır. Uygulama kodu göndermek yerine, depo, bir yapay zeka kodlama aracısına rotalar, veri modeli, kullanıcı arayüzü davranışı, güvenlik kuralları ve kabul testleri dahil olmak üzere tüm uygulamayı sıfırdan nasıl oluşturacağını öğreten tek bir yetkili belirtim dosyası, SEED.md sağlar. Ortaya çıkan uygulama, NextAuth tabanlı kimlik doğrulama ve KV destekli bir kalıcılık katmanı ile Next.js 14 (Uygulama Yönlendiricisi) projesidir ve harici hizmetler veya üretim kimlik bilgileri gerektirmeden tamamen bir geliştiricinin makinesinde çalışacak ve doğrulanacak şekilde tasarlanmıştır.
Almanac Seed Temel Özellikleri
Almanac Seed, bir yapay zeka kodlama aracısına tam Almanac web uygulamasını sıfırdan oluşturması için talimat veren tek dosyalı bir “SEED.md” tarifidir: işbirlikçilerin oluşturulmuş HTML yapıtları üzerinde pinle sabitlenmiş konular (Figma tarzı), tepkiler, çözüm durumu ve canlı varlık ile doğrudan yorum yapmasına olanak tanıyan bir Next.js 14 tasarım inceleme aracıdır. Tohum, sabit bir veri modeli, KV şeması, rota/API sözleşmeleri (başlık korumalı bir aracı API'si dahil), UI/marka gereksinimleri ve harici hizmetler veya üretim örneği olmadan yerel olarak çalışabilen otomatik bir doğrulama paketi (27 kabul yolculuğu) içerir. Bu, yalnızca geliştirme amaçlı bir test-giriş yolu ve isteğe bağlı bellek içi KV geri dönüşü kullanılarak yapılır.
Tam bir uygulamaya dönüşen tek dosyalı ürün spesifikasyonu: Uygulama kodu göndermez - yalnızca SEED.md - böylece bir yapay zeka aracı, tüm Almanac uygulamasını (Next.js 14 + TypeScript) yalnızca spesifikasyondan oluşturabilir.
Gerçek HTML yapıtları üzerinde Figma tarzı pin yorumları: İncelemeciler, bir iframe'de oluşturulan bir yapıtı açar ve iş parçacıklı tartışmalar, bağlantılı metin, tepkiler ve çözme/çözmeme davranışı ile numaralandırılmış, sürüklenebilir pinler bırakır.
Dahili kabul doğrulaması (27 yolculuk): Spesifikasyonun mutlak tasarım belirteçlerine karşı hesaplanmış stil/DOM iddiaları aracılığıyla işlevsel akışları ve görsel doğruluğu doğrulayan uçtan uca bir Playwright paketi içerir.
İki erişim yolu: insan oturumları + aracı API'si: NextAuth oturumları aracılığıyla insan incelemesini ve yapay zeka incelemecilerinin yapıtları okuması ve aynı depoya yorum yazması için ayrı, iki başlık korumalı bir API şeridini destekler.
Yerel + üretim için taşınabilir güvenlik ve kimlik doğrulama: Çerçeveleme/güvenlik kuralları için ara yazılım ve Next.js başlıkları (yalnızca dağıtım yapılandırması değil) kullanır; Google olmadan doğrulama için yalnızca geliştirme amaçlı bir test-giriş yolu ve bir üretim parola giriş seçeneği sunar.
Dayanıklı geliştirme geri dönüşü ile KV destekli işbirliği: Yorumları/varlığı/tepkileri Vercel KV'de (Upstash Redis) sabitlenmiş bir Redis anahtar/tür şemasıyla ve yerel çalıştırmalar için KV ortam değişkenleri olmadığında bellek içi bir Harita geri dönüşüyle kalıcı hale getirir.
Almanac Seed Kullanım Alanları
HTML prototipleri için ürün tasarım incelemesi: Statik HTML maketlerini (açılış sayfaları, UI keşifleri, pazarlama sayfaları) inceleyen ekipler, yapıt üzerinde doğrudan pinler ve iş parçacıklı geri bildirimlerle açıklama ekleyebilir.
Dahili tasarım kalite güvencesi ve paydaş onayı: PM'ler, mühendisler ve paydaşlar, geri bildirimleri ayrı belgelere taşımadan onayları koordine etmek için konuları çözebilir, tepki verebilir ve etkinlik/varlığı takip edebilir.
Yapay zeka destekli UX eleştirisi ve otomatik inceleme: Bir yapay zeka aracı, yapıtları ve aday bağlantıları getirebilir, aracı API'si aracılığıyla yapılandırılmış yorumlar gönderebilir ve aynı inceleme yüzeyinde insanlarla birlikte katılabilir.
Düzenlenmiş ortamlar için özel, yerel olarak barındırılan inceleme aracı: Yerel öncelikli araçlara ihtiyaç duyan kuruluşlar, uygulamayı harici bağımlılıklar olmadan (geliştirme kimlik doğrulaması + bellek KV) localhost'ta çalıştırabilir ve daha sonra kontrollü erişimle dağıtabilir.
Tasarım sistemi ve görsel regresyon uygulaması: Ekipler, yinelemeler arasında tutarlı tipografi, büyük/küçük harf kullanımı, düzen yoğunluğu ve etkileşim davranışını uygulamak için belirtim odaklı görsel iddiaları kullanabilir.
Artıları
Kendi kendine yeten, tekrarlanabilir yapı: tek bir tohum dosyası artı otomatik doğrulama, sıfırdan tutarlı hidrasyonu sağlar.
Güçlü işbirliği ilkelleri: sabitlenmiş pinler, konular, tepkiler, çözüm durumu ve varlık, tanıdık tasarım inceleme iş akışlarını yansıtır.
Tasarım gereği aracı dostu: özel başlık korumalı uç noktalar, yapay zeka incelemecilerinin geri bildirimleri programlı olarak okumasına ve yazmasına olanak tanır.
Eksileri
Karmaşık spesifikasyon yüzey alanı: katı KV şeması, kimlik doğrulama kuralları ve UI doğruluk gereksinimleri, uygulama ve bakım karmaşıklığını artırır.
Üretim kurulumu hala platform adımları gerektirir: genel olarak dağıtım, Vercel proje kurulumu ve bir Upstash/Vercel KV bağlantısı (artı gizli yönetim) gerektirir.
Alana özgü varsayılanlar: tohum, belirli bir iş akışına (HTML yapıtları, Next.js, Vercel KV, NextAuth) göre uyarlanmıştır ve adaptasyon olmadan tüm yığınlara uymayabilir.
Almanac Seed Nasıl Kullanılır
1) Almanac Seed'i Kurun (Plow Seeds CLI tarifi): Şunu çalıştırın:
curl -fsSL https://raw.githubusercontent.com/plow-pbc/seed/main/install.sh | bash -s -- https://github.com/plow-pbc/almanac-seed/blob/main/SEED.md
Bu, Plow Seeds araçlarını kurar ve Almanac SEED.md tarifini getirir.
2) SEED.md'yi açın ve bir kodlama aracısına verin: SEED.md'yi düzenleyicinizde veya tarayıcınızda açın ve yapay zeka kodlama aracınıza (örneğin, Claude Code) şu talimatla yapıştırın: "Bu tohumu nemlendirin: belirttiği uygulamayı oluşturun, ardından tüm 27 §16 yolculuğu geçene kadar ## Adımlarını ve ## Doğrulamasını çalıştırın."
Not: SEED.md tam bir ürün belirtimidir; tasarım gereği uygulama kodu içermez.
3) Yerel doğrulama mı yoksa gerçek bir genel dağıtım mı yapacağınıza karar verin: Yerel derleme/doğrulama: Adım 0'ın dağıtım görüşmesini atlayabilir ve doğrudan derleme adımlarına geçebilirsiniz (tohum buna "doğrudan §13.5'e atla" der).
Genel dağıtım: Derlemeden önce Adım 0'ı (Vercel girişi + Upstash mağaza oluşturma/bağlantı) tamamlamanız gerekir.
4) (Yalnızca genel dağıtım) Adım 0 görüşmesi ön koşullarını tamamlayın: Bir terminalde, Node'un mevcut olduğundan (>= 18.17) ve Vercel CLI'nin yüklü olduğundan emin olun. Vercel CLI eksikse, kullanıcı tarafından yazılabilir bir önekle yükleyin:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Ardından kimlik doğrulayın:
vercel login
Şimdi Vercel projesini oluşturun/bağlayın (Kişisel ve Ekip için kapsam farklıdır):
- Ekip: vercel link --yes --project <sizin-almanac> --scope <sizin-ekip>
- Kişisel: vercel link --yes --project <sizin-almanac>
Vercel kontrol panelinde, bu projeye bir Redis için Upstash veritabanı oluşturun + bağlayın (Depolama → Veritabanı Oluştur → Redis için Upstash → Projeyi Bağla → Tüm Ortamlar).
5) (Yalnızca genel dağıtım) Üretim sırlarını ayarlayın (aracı tarafından oluşturulan parola): Sırları oluşturun ve ayarlayın (tohum, aracının parolayı oluşturması gerektiğini belirtir; kullanıcı seçmez):
PASSPHRASE="$(openssl rand -base64 18)"
printf '%s' "$(openssl rand -base64 32)" | vercel env add NEXTAUTH_SECRET production
printf '%s' "$PASSPHRASE" | vercel env add ALMANAC_ACCESS_PASSWORD production
Üretimde ALMANAC_TEST_LOGIN'i ayarlamayın.
6) Tohumun derleme adımlarını yerel olarak çalıştırın (tohumun §13.5 "Adımları"): Uygulamayı nemlendirmek/oluşturmak için SEED.md §13.5 adımlarını izleyin. Özetle, tohum aracıya şunları yapmasını söyler:
- Node >= 18.17 olduğundan emin olun
- npm bağımlılıklarını yükleyin (npm install)
- cookoff-seeds/ corpus'unun mevcut olduğundan emin olun (eksikse tohum bir örnek oluşturur)
- Playwright Chromium + OS bağımlılıklarını yükleyin:
npx playwright install --with-deps chromium
- Yerel geliştirme için .env.local oluşturun (NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 ve geliştirme aracı anahtarları dahil)
- 3210 portunda derleyin ve çalıştırın (npm run build; npm start -p 3210 veya eşdeğeri)
7) Uygulamayı 3210 portunda başlatın ve yanıt verdiğini onaylayın: Sunucuyu çalıştırın ve /login'in yüklendiğini onaylayın:
npm run build
npm start
Ardından kontrol edin:
curl -sI http://localhost:3210/login
HTTP 200 bekleniyor.
8) Yalnızca geliştirme amaçlı test giriş yolunu kullanarak Google olmadan yerel olarak oturum açın: .env.local'da ALMANAC_TEST_LOGIN=1 ile şunu açın:
http://localhost:3210/api/[email protected]&next=/
Bu, bir NextAuth oturum çerezi oluşturur ve sizi uygulamaya yönlendirir (yerel doğrulama için Google OAuth gerekmez).
9) Tohumun doğrulama paketini çalıştırın (tohumun §15 "Doğrula" / §16 yolculukları): Playwright E2E paketini çalıştırın:
npm run e2e
Tohumun kabul kriterleri §16'daki 27 yolculuktur (işlevsel + görsel hesaplanmış stil iddiaları). Hepsi localhost:3210'a karşı geçmelidir.
10) (İsteğe bağlı) Sağlanan Docker yabancı-test betiğini kullanın: Tamamen izole edilmiş bir "boş konteyner" doğrulaması istiyorsanız, deponun doğrulama betiğini çalıştırın (Docker ve yapılandırılmış bir claude CLI gerektirir):
verify/hydrate-and-verify.sh
Bu, node:20-slim konteynerinde yabancı akışını otomatikleştirir ve bir FINAL_VERIFY sonucu yazdırır.
11) (Yalnızca genel dağıtım) Vercel'e dağıtın (tohumun §13.6 "Dağıt"): Adım 0 tamamlandıktan ve uygulamanız yerel olarak derlendikten sonra dağıtın:
vercel deploy --prod
Ardından Vercel Dağıtım Korumasını (ssoProtection) API veya kontrol paneli aracılığıyla devre dışı bırakın (/login'e ulaşılabilmesi için gereklidir). NEXTAUTH_URL'yi dağıtılan URL'ye ayarlayın ve bir kez yeniden dağıtın:
printf '%s' "https://<proje>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Yalnızca genel dağıtım) Oluşturulan parolayı kullanarak erişimi paylaşın: Dağıtılan Almanac'ınız parola girişi kullanır (Kimlik Bilgileri sağlayıcısı). İnceleyiciler herhangi bir görünen ad + oluşturulan ALMANAC_ACCESS_PASSWORD parolası ile oturum açar. Yorumların yeniden yüklemeler arasında kalıcı olduğunu onaylayın (Upstash KV'nin bağlı olduğunu kanıtlar).
Almanac Seed SSS
Almanac Seed, bir yapay zeka kodlama aracısına tüm Almanac uygulamasını sıfırdan nasıl oluşturacağını öğreten tek dosyalı bir “SEED.md” ürün spesifikasyonudur. Depo, uygulama kodu içermez; yalnızca tarifi içerir.
Almanac Seed Videosu
Popüler Makaleler

Atoms: Fikirleri Lansmana Hazır Ürünlere Dönüştüren Çoklu Ajan Yapay Zeka Platformu
May 22, 2026

Nano Banana SBTI: Nedir, Nasıl Çalışır ve 2026'da Nasıl Kullanılır
Apr 15, 2026

Atoms İncelemesi — 2026'da Dijital Oluşumu Yeniden Tanımlayan Yapay Zeka Ürün Geliştiricisi
Apr 10, 2026

Kilo Claw: Gerçek Bir "Senin Yerine Yapan" Yapay Zeka Aracısı Nasıl Kurulur ve Kullanılır (2026 Güncellemesi)
Apr 3, 2026







