Almanac Seed
Almanac Seed adalah resep SEED.md satu file yang memungkinkan agen pengkodean AI membangun dan memverifikasi sendiri aplikasi tinjauan desain HTML gaya Figma Next.js 14 lengkap dengan komentar berjangkar pin, diskusi berulir, reaksi, penyelesaian, kehadiran langsung, dan API berpagar header untuk peninjau AI.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
Informasi Produk
Diperbarui:Jun 8, 2026
Apa itu Almanac Seed
Almanac Seed adalah “benih produk” mandiri untuk Almanac, alat tinjauan desain yang dapat di-host secara lokal yang dibangun untuk mengomentari langsung artefak HTML yang dirender—mirip dengan komentar berbasis pin Figma, tetapi untuk prototipe web dan eksplorasi HTML satu file. Alih-alih mengirimkan kode aplikasi, repositori menyediakan satu file spesifikasi otoritatif, SEED.md, yang menginstruksikan agen pengkodean AI cara membuat seluruh aplikasi dari awal, termasuk rute, model data, perilaku UI, aturan keamanan, dan tes penerimaan. Aplikasi yang dihasilkan adalah proyek Next.js 14 (App Router) dengan otentikasi berbasis NextAuth dan lapisan persistensi berbasis KV, yang dirancang untuk berjalan dan memverifikasi sepenuhnya di mesin pengembang tanpa memerlukan layanan eksternal atau kredensial produksi.
Fitur Utama Almanac Seed
Almanac Seed adalah resep "SEED.md" satu file yang menginstruksikan agen pengkodean AI untuk membangun aplikasi web Almanac lengkap dari awal: alat peninjauan desain Next.js 14 yang memungkinkan kolaborator berkomentar langsung pada artefak HTML yang dirender dengan utas yang ditambatkan pin (gaya Figma), reaksi, status resolusi, dan kehadiran langsung. Seed ini mencakup model data tetap, skema KV, kontrak rute/API (termasuk API agen yang digerbang header), persyaratan UI/merek, dan rangkaian verifikasi otomatis (27 perjalanan penerimaan) yang dapat berjalan secara lokal tanpa layanan eksternal atau instans produksi, menggunakan jalur login pengujian khusus pengembangan dan fallback KV dalam memori opsional.
Spesifikasi produk satu file yang terhidrasi menjadi aplikasi lengkap: Tidak mengirimkan kode aplikasi—hanya SEED.md—sehingga agen AI dapat menghasilkan seluruh implementasi Almanac (Next.js 14 + TypeScript) dari spesifikasi saja.
Komentar pin gaya Figma pada artefak HTML asli: Peninjau membuka artefak yang dirender dalam iframe dan menjatuhkan pin bernomor yang dapat diseret dengan diskusi berulir, teks yang dihubungkan, reaksi, dan perilaku penyelesaian/pembatalan penyelesaian.
Verifikasi penerimaan bawaan (27 perjalanan): Mencakup rangkaian Playwright end-to-end yang memvalidasi alur fungsional dan fidelitas visual melalui pernyataan gaya/DOM yang dihitung terhadap token desain absolut spesifikasi.
Dua jalur akses: sesi manusia + API agen: Mendukung tinjauan manusia melalui sesi NextAuth dan jalur API dua header terpisah untuk peninjau AI untuk membaca artefak dan menulis komentar ke penyimpanan yang sama.
Keamanan dan autentikasi portabel untuk lokal + produksi: Menggunakan middleware dan header Next.js (bukan konfigurasi khusus penyebaran) untuk aturan pembingkaian/keamanan; menyediakan rute login pengujian khusus pengembangan untuk verifikasi tanpa Google dan opsi login frasa sandi produksi.
Kolaborasi berbasis KV dengan fallback dev yang tangguh: Mempertahankan komentar/kehadiran/reaksi di Vercel KV (Upstash Redis) dengan skema kunci/tipe Redis yang disematkan, ditambah fallback Map dalam memori ketika variabel lingkungan KV tidak ada untuk menjalankan lokal.
Kasus Penggunaan Almanac Seed
Tinjauan desain produk untuk prototipe HTML: Tim yang meninjau mock HTML statis (halaman arahan, eksplorasi UI, halaman pemasaran) dapat membuat anotasi langsung pada artefak dengan pin dan umpan balik berulir.
QA desain internal dan persetujuan pemangku kepentingan: PM, insinyur, dan pemangku kepentingan dapat menyelesaikan utas, bereaksi, dan melacak aktivitas/kehadiran untuk mengoordinasikan persetujuan tanpa memindahkan umpan balik ke dokumen terpisah.
Kritik UX yang dibantu AI dan tinjauan otomatis: Agen AI dapat mengambil artefak dan jangkar kandidat, memposting komentar terstruktur melalui API agen, dan berpartisipasi bersama manusia di permukaan tinjauan yang sama.
Alat tinjauan pribadi yang dihosting secara lokal untuk lingkungan yang diatur: Organisasi yang membutuhkan alat yang mengutamakan lokal dapat menjalankan aplikasi di localhost tanpa dependensi eksternal (autentikasi dev + KV memori) dan kemudian menyebarkan dengan akses terkontrol.
Sistem desain dan penegakan regresi visual: Tim dapat menggunakan pernyataan visual berbasis spesifikasi untuk menegakkan tipografi yang konsisten, kapitalisasi, kepadatan tata letak, dan perilaku interaksi di seluruh iterasi.
Kelebihan
Build mandiri yang dapat direproduksi: satu file seed ditambah verifikasi otomatis memungkinkan hidrasi yang konsisten dari awal.
Primitif kolaborasi yang kuat: pin yang ditambatkan, utas, reaksi, status penyelesaian, dan kehadiran mencerminkan alur kerja peninjauan desain yang sudah dikenal.
Ramah agen berdasarkan desain: titik akhir yang digerbang header khusus memungkinkan peninjau AI untuk membaca dan menulis umpan balik secara terprogram.
Kekurangan
Area permukaan spesifikasi yang kompleks: skema KV yang ketat, aturan autentikasi, dan persyaratan fidelitas UI meningkatkan kompleksitas implementasi dan pemeliharaan.
Penyiapan produksi masih memerlukan langkah-langkah platform: penyebaran publik membutuhkan penyiapan proyek Vercel dan koneksi Upstash/Vercel KV (ditambah manajemen rahasia).
Default khusus domain: seed disesuaikan dengan alur kerja tertentu (artefak HTML, Next.js, Vercel KV, NextAuth), yang mungkin tidak cocok untuk semua tumpukan tanpa adaptasi.
Cara Menggunakan Almanac Seed
1) Instal Almanac Seed (resep Plow Seeds CLI): Jalankan:
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
Ini menginstal alat Plow Seeds dan mengambil resep Almanac SEED.md.
2) Buka SEED.md dan berikan kepada agen pengkodean: Buka SEED.md mentah di editor atau browser Anda dan tempelkan ke agen pengkodean AI Anda (misalnya, Claude Code) dengan instruksi seperti: “Hidrasi benih ini: bangun aplikasi yang ditentukannya, lalu jalankan ## Langkah dan ## Verifikasi hingga semua 27 §16 perjalanan berhasil.”
Catatan: SEED.md adalah spesifikasi produk lengkap; secara desain tidak mengandung kode implementasi.
3) Putuskan apakah Anda melakukan verifikasi lokal atau penyebaran publik nyata: Pembuatan/verifikasi lokal: Anda dapat melewati wawancara penyebaran Langkah 0 dan langsung ke langkah-langkah pembuatan (benih menyebut ini “langsung ke §13.5”).
Penyebaran publik: Anda harus menyelesaikan Langkah 0 terlebih dahulu (login Vercel + pembuatan/koneksi toko Upstash) sebelum membangun.
4) (Hanya penyebaran publik) Selesaikan prasyarat wawancara Langkah 0: Di terminal, pastikan Node tersedia (>= 18.17) dan Vercel CLI terinstal. Jika Vercel CLI tidak ada, instal dengan awalan yang dapat ditulis pengguna:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Kemudian otentikasi:
vercel login
Buat/tautkan proyek Vercel sekarang (cakupan berbeda untuk Tim vs Pribadi):
- Tim: vercel link --yes --project <nama-almanac-anda> --scope <nama-tim-anda>
- Pribadi: vercel link --yes --project <nama-almanac-anda>
Di dasbor Vercel, buat + hubungkan database Upstash for Redis ke proyek ini (Penyimpanan → Buat Database → Upstash for Redis → Hubungkan Proyek → Semua Lingkungan).
5) (Hanya penyebaran publik) Atur rahasia produksi (frasa sandi yang dihasilkan agen): Buat dan atur rahasia (benih menentukan agen harus menghasilkan frasa sandi; pengguna tidak memilihnya):
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
JANGAN atur ALMANAC_TEST_LOGIN di produksi.
6) Jalankan langkah-langkah pembuatan benih secara lokal (benih §13.5 “Langkah”): Ikuti langkah-langkah SEED.md §13.5 untuk menghidrasi/membangun aplikasi. Singkatnya, benih menginstruksikan agen untuk:
- Memastikan Node >= 18.17
- Menginstal dependensi npm (npm install)
- Memastikan korpus cookoff-seeds/ ada (benih membuat contoh jika tidak ada)
- Menginstal Playwright Chromium + dependensi OS:
npx playwright install --with-deps chromium
- Membuat .env.local untuk pengembangan lokal (termasuk NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1, dan kunci agen dev)
- Membangun dan menjalankan di port 3210 (npm run build; npm start -p 3210 atau yang setara)
7) Mulai aplikasi di port 3210 dan konfirmasi responsnya: Jalankan server dan konfirmasi /login dimuat:
npm run build
npm start
Kemudian periksa:
curl -sI http://localhost:3210/login
Harapkan HTTP 200.
8) Masuk secara lokal tanpa Google menggunakan rute login tes khusus dev: Dengan ALMANAC_TEST_LOGIN=1 di .env.local, buka:
http://localhost:3210/api/[email protected]&next=/
Ini membuat cookie sesi NextAuth dan mengarahkan Anda ke aplikasi (tidak diperlukan Google OAuth untuk verifikasi lokal).
9) Jalankan rangkaian verifikasi benih (benih §15 “Verifikasi” / §16 perjalanan): Jalankan rangkaian Playwright E2E:
npm run e2e
Kriteria penerimaan benih adalah 27 perjalanan di §16 (fungsional + pernyataan gaya terhitung visual). Semua harus lulus terhadap localhost:3210.
10) (Opsional) Gunakan skrip stranger-test Docker yang disediakan: Jika Anda menginginkan verifikasi “kontainer kosong” yang sepenuhnya terisolasi, jalankan skrip verifikasi repositori (memerlukan Docker dan CLI claude yang dikonfigurasi):
verify/hydrate-and-verify.sh
Ini mengotomatiskan alur orang asing dalam kontainer node:20-slim dan mencetak hasil FINAL_VERIFY.
11) (Hanya penyebaran publik) Sebarkan ke Vercel (benih §13.6 “Sebarkan”): Setelah Langkah 0 selesai dan aplikasi Anda dibangun secara lokal, sebarkan:
vercel deploy --prod
Kemudian nonaktifkan Perlindungan Penyebaran Vercel (ssoProtection) melalui API atau dasbor (diperlukan agar /login dapat dijangkau). Atur NEXTAUTH_URL ke URL yang disebarkan dan sebarkan ulang sekali:
printf '%s' "https://<proyek>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Hanya penyebaran publik) Bagikan akses menggunakan frasa sandi yang dihasilkan: Almanac yang Anda sebarkan menggunakan login frasa sandi (penyedia Kredensial). Peninjau masuk dengan nama tampilan apa pun + frasa sandi ALMANAC_ACCESS_PASSWORD yang dihasilkan. Konfirmasi komentar tetap ada setelah memuat ulang (membuktikan Upstash KV terhubung).
FAQ Almanac Seed
Almanac Seed adalah spesifikasi produk "SEED.md" satu file yang menginstruksikan agen pengkodean AI tentang cara membangun aplikasi Almanac lengkap dari awal. Repo ini tidak berisi kode aplikasi—hanya resepnya.
Video Almanac Seed
Artikel Populer
Atoms: Platform AI Multi-Agen yang Mengubah Ide menjadi Produk Siap Diluncurkan
May 22, 2026
Nano Banana SBTI: Apa Itu, Bagaimana Cara Kerjanya, dan Cara Menggunakannya di Tahun 2026
Apr 15, 2026
Ulasan Atoms — Pembuat Produk AI yang Mendefinisikan Ulang Kreasi Digital di Tahun 2026
Apr 10, 2026
Kilo Claw: Cara Menerapkan dan Menggunakan Agen AI "Lakukan-Untuk-Anda" Sejati (Pembaruan 2026)
Apr 3, 2026
Alat AI Terbaru Serupa dengan Almanac Seed
Foundry
Foundry adalah platform serbaguna yang ada dalam berbagai bentuk - sebagai alat pengembangan kontrak pintar, perangkat lunak permainan tabletop virtual, dan fasilitas pengecoran logam tradisional - masing-masing menawarkan fitur khusus untuk domain mereka masing-masing.
PythonConvert.com
PythonConvert.com adalah alat berbasis web gratis yang menyediakan terjemahan kode yang didukung AI antara Python dan bahasa pemrograman lainnya serta kemampuan konversi tipe Python.
Softgen
Softgen.ai adalah platform generator proyek full-stack bertenaga AI yang memungkinkan pengguna mengubah ide mereka menjadi aplikasi web fungsional tanpa persyaratan pengkodean.
Micro SaaS Ideas
Ide Micro SaaS adalah solusi perangkat lunak berskala kecil yang fokus pada ceruk yang menargetkan masalah atau pasar tertentu, menawarkan pengusaha cara untuk membangun bisnis yang menguntungkan dengan sumber daya dan kompleksitas minimal.
Alat AI Populer Seperti Almanac Seed
GitHub Copilot Chat
GitHub Copilot Chat adalah asisten pengkodean bertenaga AI yang menyediakan interaksi bahasa alami, saran kode waktu nyata, dan dukungan kontekstual langsung di dalam IDE yang didukung dan GitHub.com.
CopilotForXcode
CopilotForXcode adalah Ekstensi Editor Sumber Xcode yang mengintegrasikan GitHub Copilot, Codeium, dan ChatGPT untuk memberikan saran kode yang didukung AI, bantuan obrolan, dan fungsionalitas prompt-to-code di dalam Xcode.
OpenAI Codex CLI
OpenAI Codex CLI adalah agen pengkodean sumber terbuka ringan yang berjalan di terminal Anda, memungkinkan pengembang untuk menerjemahkan bahasa alami ke dalam eksekusi kode sambil memberikan penalaran tingkat ChatGPT dengan kemampuan untuk menjalankan kode, memanipulasi file, dan melakukan iterasi di bawah kontrol versi.
GoCodeo SaaS Builder
GoCodeo SaaS Builder adalah kerangka kerja asli AI yang secara otomatis menghasilkan aplikasi SaaS full-stack siap produksi menggunakan agen AI otonom, lengkap dengan autentikasi, fitur real-time, dan integrasi TypeScript.