Almanac Seed
Almanac Seed è una ricetta SEED.md a file singolo che consente a un agente di codifica AI di costruire e auto-verificare un'app completa di revisione del design HTML in stile Figma con Next.js 14, con commenti ancorati a pin, discussioni in thread, reazioni, risoluzione, presenza in tempo reale e un'API protetta da intestazione per i revisori AI.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
Informazioni sul Prodotto
Aggiornato:Jun 8, 2026
Cos'è Almanac Seed
Almanac Seed è un "seed di prodotto" autonomo per Almanac, uno strumento di revisione del design ospitabile localmente, creato per commentare direttamente gli artefatti HTML renderizzati, simile al commento basato su pin di Figma, ma per prototipi web ed esplorazioni HTML a file singolo. Invece di spedire codice applicativo, il repository fornisce un file di specifica autorevole, SEED.md, che istruisce un agente di codifica AI su come generare l'intera applicazione da zero, inclusi percorsi, modello di dati, comportamento dell'interfaccia utente, regole di sicurezza e test di accettazione. L'app risultante è un progetto Next.js 14 (App Router) con autenticazione basata su NextAuth e un livello di persistenza basato su KV, progettato per essere eseguito e verificato interamente sulla macchina di uno sviluppatore senza richiedere servizi esterni o credenziali di produzione.
Caratteristiche principali di Almanac Seed
Almanac Seed è una "ricetta" in singolo file "SEED.md" che istruisce un agente di codifica AI a costruire l'intera web app Almanac da zero: uno strumento di revisione del design Next.js 14 che consente ai collaboratori di commentare direttamente gli artefatti HTML renderizzati con thread ancorati a pin (stile Figma), reazioni, stato di risoluzione e presenza in tempo reale. Il seed include un modello di dati fisso, uno schema KV, contratti di rotta/API (inclusa un'API agente con header-gated), requisiti UI/brand e una suite di verifica automatizzata (27 percorsi di accettazione) che può essere eseguita localmente senza servizi esterni o istanze di produzione, utilizzando un percorso di test-login solo per lo sviluppo e un fallback KV in memoria opzionale.
Specifiche di prodotto in singolo file che si idratano in un'app completa: Non spedisce codice applicativo, solo SEED.md, in modo che un agente AI possa generare l'intera implementazione di Almanac (Next.js 14 + TypeScript) solo dalla specifica.
Commenti a pin in stile Figma su artefatti HTML reali: I revisori aprono un artefatto renderizzato in un iframe e inseriscono pin numerati e trascinabili con discussioni in thread, testo linkato, reazioni e comportamento di risoluzione/non risoluzione.
Verifica di accettazione integrata (27 percorsi): Include una suite Playwright end-to-end che convalida i flussi funzionali e la fedeltà visiva tramite asserzioni di stile calcolato/DOM rispetto ai token di design assoluti della specifica.
Due percorsi di accesso: sessioni umane + API agente: Supporta la revisione umana tramite sessioni NextAuth e una corsia API separata con due header-gated per i revisori AI per leggere artefatti e scrivere commenti nello stesso archivio.
Sicurezza e autenticazione portatili per locale + produzione: Utilizza middleware e header Next.js (non configurazione solo per la distribuzione) per regole di framing/sicurezza; fornisce un percorso di test-login solo per lo sviluppo per la verifica senza Google e un'opzione di accesso con passphrase di produzione.
Collaborazione basata su KV con fallback di sviluppo resiliente: Persiste commenti/presenza/reazioni in Vercel KV (Upstash Redis) con uno schema di chiave/tipo Redis bloccato, più un fallback Map in memoria quando le variabili d'ambiente KV sono assenti per le esecuzioni locali.
Casi d'uso di Almanac Seed
Revisione del design del prodotto per prototipi HTML: I team che revisionano mock-up HTML statici (landing page, esplorazioni UI, pagine di marketing) possono annotare direttamente sull'artefatto con pin e feedback in thread.
QA interno del design e approvazione degli stakeholder: PM, ingegneri e stakeholder possono risolvere thread, reagire e tracciare attività/presenza per coordinare le approvazioni senza spostare il feedback in documenti separati.
Critica UX assistita da AI e revisione automatizzata: Un agente AI può recuperare artefatti e ancore candidate, pubblicare commenti strutturati tramite l'API dell'agente e partecipare insieme agli umani nella stessa superficie di revisione.
Strumento di revisione privato e ospitato localmente per ambienti regolamentati: Le organizzazioni che necessitano di strumenti local-first possono eseguire l'app su localhost senza dipendenze esterne (autenticazione di sviluppo + KV in memoria) e successivamente distribuirla con accesso controllato.
Sistema di design e applicazione della regressione visiva: I team possono utilizzare le asserzioni visive basate su specifiche per imporre una tipografia, una maiuscola/minuscola, una densità del layout e un comportamento di interazione coerenti tra le iterazioni.
Vantaggi
Build autonomo e riproducibile: un singolo file seed più la verifica automatizzata consentono un'idratazione coerente da zero.
Primitive di collaborazione robuste: pin ancorati, thread, reazioni, stato di risoluzione e presenza rispecchiano i flussi di lavoro di revisione del design familiari.
Progettato per gli agenti: endpoint dedicati con header-gated consentono ai revisori AI di leggere e scrivere feedback in modo programmatico.
Svantaggi
Superficie di specifica complessa: schema KV rigoroso, regole di autenticazione e requisiti di fedeltà UI aumentano la complessità di implementazione e manutenzione.
La configurazione di produzione richiede ancora passaggi della piattaforma: la distribuzione pubblica richiede la configurazione del progetto Vercel e una connessione Upstash/Vercel KV (più la gestione dei segreti).
Impostazioni predefinite specifiche del dominio: il seed è adattato a un particolare flusso di lavoro (artefatti HTML, Next.js, Vercel KV, NextAuth), che potrebbe non adattarsi a tutti gli stack senza adattamento.
Come usare Almanac Seed
1) Installa Almanac Seed (ricetta CLI di Plow Seeds): Esegui:
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
Questo installa gli strumenti Plow Seeds e recupera la ricetta Almanac SEED.md.
2) Apri il SEED.md e passalo a un agente di codifica: Apri il SEED.md grezzo nel tuo editor o browser e incollalo nel tuo agente di codifica AI (ad esempio, Claude Code) con un'istruzione come: "Idrata questo seed: costruisci l'app che specifica, quindi esegui i suoi ## Steps e ## Verify finché tutti i 27 §16 percorsi non passano."
Nota: SEED.md è una specifica di prodotto completa; per sua natura non contiene codice di implementazione.
3) Decidi se stai eseguendo una verifica locale o una vera distribuzione pubblica: Build/verifica locale: puoi saltare l'intervista di distribuzione del Passaggio 0 e passare direttamente ai passaggi di build (il seed lo chiama "salta direttamente a §13.5").
Distribuzione pubblica: devi prima completare il Passaggio 0 (login Vercel + creazione/connessione dello store Upstash) prima della build.
4) (Solo distribuzione pubblica) Completa i prerequisiti dell'intervista del Passaggio 0: In un terminale, assicurati che Node sia disponibile (>= 18.17) e che Vercel CLI sia installato. Se Vercel CLI manca, installalo con un prefisso scrivibile dall'utente:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Quindi autenticati:
vercel login
Crea/collega il progetto Vercel ora (lo scope differisce per Team vs Personale):
- Team: vercel link --yes --project <il-tuo-almanac> --scope <il-tuo-team>
- Personale: vercel link --yes --project <il-tuo-almanac>
Nella dashboard di Vercel, crea + collega un database Upstash per Redis a questo progetto (Storage → Create Database → Upstash for Redis → Connect Project → All Environments).
5) (Solo distribuzione pubblica) Imposta i segreti di produzione (passphrase generata dall'agente): Genera e imposta i segreti (il seed specifica che l'agente dovrebbe generare la passphrase; l'utente non la sceglie):
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
NON impostare ALMANAC_TEST_LOGIN in produzione.
6) Esegui i passaggi di build del seed localmente (§13.5 "Steps" del seed): Segui i passaggi §13.5 del SEED.md per idratare/costruire l'app. In sintesi, il seed istruisce l'agente a:
- Assicurarsi che Node >= 18.17
- Installare le dipendenze npm (npm install)
- Assicurarsi che esista un corpus cookoff-seeds/ (il seed crea un esempio se mancante)
- Installare Playwright Chromium + dipendenze OS:
npx playwright install --with-deps chromium
- Creare .env.local per lo sviluppo locale (inclusi NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 e chiavi dell'agente di sviluppo)
- Costruire ed eseguire sulla porta 3210 (npm run build; npm start -p 3210 o equivalente)
7) Avvia l'app sulla porta 3210 e conferma che risponde: Esegui il server e conferma che /login si carica:
npm run build
npm start
Quindi controlla:
curl -sI http://localhost:3210/login
Aspettati HTTP 200.
8) Accedi localmente senza Google usando il percorso di accesso di test solo per sviluppatori: Con ALMANAC_TEST_LOGIN=1 in .env.local, apri:
http://localhost:3210/api/[email protected]&next=/
Questo crea un cookie di sessione NextAuth e ti reindirizza all'app (non è richiesto Google OAuth per la verifica locale).
9) Esegui la suite di verifica del seed (§15 "Verify" / §16 percorsi del seed): Esegui la suite Playwright E2E:
npm run e2e
I criteri di accettazione del seed sono i 27 percorsi in §16 (asserzioni funzionali + visive dello stile calcolato). Tutti devono passare contro localhost:3210.
10) (Opzionale) Usa lo script Docker stranger-test fornito: Se desideri una verifica completamente isolata in un "container vuoto", esegui lo script di verifica del repository (richiede Docker e una CLI claude configurata):
verify/hydrate-and-verify.sh
Automatizza il flusso stranger in un container node:20-slim e stampa un risultato FINAL_VERIFY.
11) (Solo distribuzione pubblica) Distribuisci su Vercel (§13.6 "Deploy" del seed): Dopo aver completato il Passaggio 0 e aver costruito l'app localmente, distribuisci:
vercel deploy --prod
Quindi disabilita la protezione della distribuzione Vercel (ssoProtection) tramite API o dashboard (necessario affinché /login sia raggiungibile). Imposta NEXTAUTH_URL sull'URL distribuito e ridistribuisci una volta:
printf '%s' "https://<progetto>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Solo distribuzione pubblica) Condividi l'accesso usando la passphrase generata: Il tuo Almanac distribuito utilizza l'accesso tramite passphrase (provider Credenziali). I revisori accedono con qualsiasi nome visualizzato + la passphrase ALMANAC_ACCESS_PASSWORD generata. Conferma che i commenti persistano dopo i ricaricamenti (dimostra che Upstash KV è connesso).
FAQ di Almanac Seed
Almanac Seed è una specifica di prodotto "SEED.md" a file singolo che istruisce un agente di codifica AI su come costruire l'intera applicazione Almanac da zero. Il repository non contiene codice applicativo, solo la ricetta.
Video di Almanac Seed
Articoli Popolari
Atoms: Una Piattaforma AI Multi-Agente Che Trasforma le Idee in Prodotti Pronti al Lancio
May 22, 2026
Nano Banana SBTI: Cos'è, come funziona e come usarlo nel 2026
Apr 15, 2026
Recensione di Atoms — Il builder di prodotti AI che ridefinisce la creazione digitale nel 2026
Apr 10, 2026
Kilo Claw: Come Distribuire e Utilizzare un Vero Agente AI "Fai-da-Te" (Aggiornamento 2026)
Apr 3, 2026
Ultimi Strumenti AI Simili a Almanac Seed
Foundry
Foundry è una piattaforma versatile che esiste in più forme - come un toolchain per lo sviluppo di smart contract, un software di gioco da tavolo virtuale e una tradizionale struttura di fusione dei metalli - ognuna delle quali offre funzionalità specializzate per i rispettivi domini.
PythonConvert.com
PythonConvert.com è uno strumento web-based gratuito che fornisce traduzione del codice alimentata dall'IA tra Python e altri linguaggi di programmazione, nonché capacità di conversione dei tipi Python.
Softgen
Softgen.ai è una piattaforma di generazione di progetti full-stack potenziata dall'IA che consente agli utenti di trasformare le loro idee in applicazioni web funzionali senza requisiti di codifica.
Micro SaaS Ideas
Le idee di Micro SaaS sono soluzioni software su piccola scala, focalizzate su nicchie, che mirano a problemi o mercati specifici, offrendo agli imprenditori un modo per costruire aziende redditizie con risorse e complessità minime.
Strumenti AI Popolari Come Almanac Seed
GitHub Copilot Chat
GitHub Copilot Chat è un assistente di codifica alimentato dall'IA che fornisce interazioni in linguaggio naturale, suggerimenti di codice in tempo reale e supporto contestuale direttamente all'interno degli IDE supportati e di GitHub.com.
CopilotForXcode
CopilotForXcode è un'estensione dell'Editor di Codice Xcode che integra GitHub Copilot, Codeium e ChatGPT per fornire suggerimenti di codice alimentati dall'IA, assistenza in chat e funzionalità di prompt-to-code all'interno di Xcode.
OpenAI Codex CLI
OpenAI Codex CLI è un agente di codifica open-source leggero che viene eseguito nel tuo terminale, consentendo agli sviluppatori di tradurre il linguaggio naturale in esecuzione di codice fornendo al contempo un ragionamento a livello di ChatGPT con la capacità di eseguire codice, manipolare file e iterare sotto controllo di versione.
GoCodeo SaaS Builder
GoCodeo SaaS Builder è un framework AI-native che genera automaticamente applicazioni SaaS full-stack pronte per la produzione utilizzando agenti AI autonomi, complete di autenticazione, funzionalità in tempo reale e integrazione TypeScript.