
Almanac Seed
Almanac Seed é uma receita SEED.md de arquivo único que permite que um agente de codificação de IA construa e auto-verifique um aplicativo completo de revisão de design HTML estilo Figma, Next.js 14, com comentários ancorados por pin, discussões em thread, reações, resolução, presença ao vivo e uma API protegida por cabeçalho para revisores de IA.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure

Informações do Produto
Atualizado:Jun 8, 2026
O que é Almanac Seed
Almanac Seed é um "produto semente" autônomo para o Almanac, uma ferramenta de revisão de design hospedável localmente, construída para comentar diretamente em artefatos HTML renderizados – semelhante aos comentários baseados em pin do Figma, mas para protótipos da web e explorações HTML de arquivo único. Em vez de enviar código de aplicativo, o repositório fornece um arquivo de especificação autoritativo, SEED.md, que instrui um agente de codificação de IA sobre como gerar todo o aplicativo do zero, incluindo rotas, modelo de dados, comportamento da interface do usuário, regras de segurança e testes de aceitação. O aplicativo resultante é um projeto Next.js 14 (App Router) com autenticação baseada em NextAuth e uma camada de persistência KV, projetado para ser executado e verificado inteiramente na máquina de um desenvolvedor, sem a necessidade de serviços externos ou credenciais de produção.
Principais Recursos do Almanac Seed
Almanac Seed é uma "receita" de arquivo único "SEED.md" que instrui um agente de codificação de IA a construir o aplicativo web Almanac completo do zero: uma ferramenta de revisão de design Next.js 14 que permite que colaboradores comentem diretamente em artefatos HTML renderizados com threads ancorados por pinos (estilo Figma), reações, estado de resolução e presença ao vivo. A seed inclui um modelo de dados fixo, esquema KV, contratos de rota/API (incluindo uma API de agente com cabeçalho restrito), requisitos de UI/marca e um conjunto de verificação automatizado (27 jornadas de aceitação) que pode ser executado localmente sem serviços externos ou instância de produção, usando um caminho de login de teste apenas para desenvolvimento e um fallback KV opcional em memória.
Especificação de produto de arquivo único que se hidrata em um aplicativo completo: Não envia código de aplicativo – apenas SEED.md – para que um agente de IA possa gerar toda a implementação do Almanac (Next.js 14 + TypeScript) apenas a partir da especificação.
Comentários de pinos estilo Figma em artefatos HTML reais: Os revisores abrem um artefato renderizado em um iframe e soltam pinos numerados e arrastáveis com discussões em threads, texto com links, reações e comportamento de resolver/não resolver.
Verificação de aceitação integrada (27 jornadas): Inclui um conjunto Playwright de ponta a ponta que valida fluxos funcionais e fidelidade visual por meio de asserções de estilo computado/DOM contra os tokens de design absolutos da especificação.
Dois caminhos de acesso: sessões humanas + API de agente: Suporta revisão humana via sessões NextAuth e uma faixa de API separada com dois cabeçalhos restritos para revisores de IA lerem artefatos e escreverem comentários no mesmo armazenamento.
Segurança e autenticação portáteis para local + produção: Usa middleware e cabeçalhos Next.js (não configuração apenas de implantação) para regras de enquadramento/segurança; fornece uma rota de login de teste apenas para desenvolvimento para verificação sem Google e uma opção de login de frase secreta de produção.
Colaboração com suporte KV com fallback de desenvolvimento resiliente: Persiste comentários/presença/reações no Vercel KV (Upstash Redis) com um esquema de chave/tipo Redis fixado, além de um fallback de Mapa em memória quando as variáveis de ambiente KV estão ausentes para execuções locais.
Casos de Uso do Almanac Seed
Revisão de design de produto para protótipos HTML: Equipes que revisam mocks HTML estáticos (páginas de destino, explorações de UI, páginas de marketing) podem anotar diretamente no artefato com pinos e feedback em threads.
QA de design interno e aprovação de stakeholders: PMs, engenheiros e stakeholders podem resolver threads, reagir e rastrear atividades/presença para coordenar aprovações sem mover o feedback para documentos separados.
Crítica de UX assistida por IA e revisão automatizada: Um agente de IA pode buscar artefatos e âncoras candidatas, postar comentários estruturados via API do agente e participar junto com humanos na mesma superfície de revisão.
Ferramenta de revisão privada e hospedada localmente para ambientes regulamentados: Organizações que precisam de ferramentas "local-first" podem executar o aplicativo no localhost sem dependências externas (autenticação de desenvolvimento + KV em memória) e, posteriormente, implantar com acesso controlado.
Aplicação de sistema de design e regressão visual: As equipes podem usar as asserções visuais orientadas por especificações para garantir tipografia, uso de maiúsculas/minúsculas, densidade de layout e comportamento de interação consistentes em todas as iterações.
Vantagens
Construção autocontida e reproduzível: um único arquivo seed mais verificação automatizada permite hidratação consistente do zero.
Primitivos de colaboração fortes: pinos ancorados, threads, reações, estado de resolução e presença espelham fluxos de trabalho de revisão de design familiares.
Amigável ao agente por design: endpoints dedicados com cabeçalho restrito permitem que revisores de IA leiam e escrevam feedback programaticamente.
Desvantagens
Área de superfície de especificação complexa: esquema KV rigoroso, regras de autenticação e requisitos de fidelidade de UI aumentam a complexidade de implementação e manutenção.
A configuração de produção ainda requer etapas de plataforma: a implantação pública precisa de configuração de projeto Vercel e uma conexão Upstash/Vercel KV (além de gerenciamento de segredos).
Padrões específicos de domínio: a seed é adaptada a um fluxo de trabalho específico (artefatos HTML, Next.js, Vercel KV, NextAuth), o que pode não se adequar a todas as pilhas sem adaptação.
Como Usar o Almanac Seed
1) Instale o Almanac Seed (receita Plow Seeds CLI): Execute:
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
Isso instala as ferramentas Plow Seeds e busca a receita Almanac SEED.md.
2) Abra o SEED.md e entregue-o a um agente de codificação: Abra o SEED.md bruto em seu editor ou navegador e cole-o em seu agente de codificação de IA (por exemplo, Claude Code) com uma instrução como: "Hidrate esta semente: construa o aplicativo que ela especifica e, em seguida, execute suas ## Etapas e ## Verifique até que todas as 27 jornadas §16 passem."
Nota: SEED.md é uma especificação de produto completa; ele não contém código de implementação por design.
3) Decida se você está fazendo verificação local ou uma implantação pública real: Compilação/verificação local: você pode pular a entrevista de implantação da Etapa 0 e ir direto para as etapas de compilação (a semente chama isso de "pular direto para §13.5").
Implantação pública: você deve concluir a Etapa 0 primeiro (login Vercel + criação/conexão de armazenamento Upstash) antes de construir.
4) (Somente implantação pública) Conclua os pré-requisitos da entrevista da Etapa 0: Em um terminal, certifique-se de que o Node esteja disponível (>= 18.17) e que o Vercel CLI esteja instalado. Se o Vercel CLI estiver faltando, instale-o com um prefixo gravável pelo usuário:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Em seguida, autentique:
vercel login
Crie/vincule o projeto Vercel agora (o escopo difere para Equipe vs Pessoal):
- Equipe: vercel link --yes --project <seu-almanaque> --scope <sua-equipe>
- Pessoal: vercel link --yes --project <seu-almanaque>
No painel do Vercel, crie + conecte um banco de dados Upstash para Redis a este projeto (Armazenamento → Criar Banco de Dados → Upstash para Redis → Conectar Projeto → Todos os Ambientes).
5) (Somente implantação pública) Defina segredos de produção (frase secreta gerada pelo agente): Gere e defina segredos (a semente especifica que o agente deve gerar a frase secreta; o usuário não a escolhe):
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
NÃO defina ALMANAC_TEST_LOGIN em produção.
6) Execute as etapas de compilação da semente localmente (as "Etapas" §13.5 da semente): Siga as etapas §13.5 do SEED.md para hidratar/construir o aplicativo. Em resumo, a semente instrui o agente a:
- Garantir Node >= 18.17
- Instalar dependências npm (npm install)
- Garantir que um corpus cookoff-seeds/ exista (a semente cria um exemplo se estiver faltando)
- Instalar Playwright Chromium + dependências do SO:
npx playwright install --with-deps chromium
- Criar .env.local para desenvolvimento local (incluindo NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 e chaves de agente de desenvolvimento)
- Construir e executar na porta 3210 (npm run build; npm start -p 3210 ou equivalente)
7) Inicie o aplicativo na porta 3210 e confirme se ele responde: Execute o servidor e confirme se /login carrega:
npm run build
npm start
Em seguida, verifique:
curl -sI http://localhost:3210/login
Espere HTTP 200.
8) Faça login localmente sem o Google usando a rota de login de teste apenas para desenvolvimento: Com ALMANAC_TEST_LOGIN=1 em .env.local, abra:
http://localhost:3210/api/[email protected]&next=/
Isso cria um cookie de sessão NextAuth e redireciona você para o aplicativo (nenhum OAuth do Google é necessário para verificação local).
9) Execute o conjunto de verificação da semente (as jornadas §15 "Verificar" / §16 da semente): Execute o conjunto Playwright E2E:
npm run e2e
Os critérios de aceitação da semente são as 27 jornadas em §16 (asserções funcionais + visuais de estilo computado). Todas devem passar contra localhost:3210.
10) (Opcional) Use o script Docker stranger-test fornecido: Se você deseja uma verificação totalmente isolada de "contêiner em branco", execute o script de verificação do repositório (requer Docker e um CLI claude configurado):
verify/hydrate-and-verify.sh
Ele automatiza o fluxo de estranhos em um contêiner node:20-slim e imprime um resultado FINAL_VERIFY.
11) (Somente implantação pública) Implante no Vercel (o "Deploy" §13.6 da semente): Depois que a Etapa 0 for concluída e seu aplicativo for construído localmente, implante:
vercel deploy --prod
Em seguida, desative a Proteção de Implantação do Vercel (ssoProtection) via API ou painel (necessário para que /login seja acessível). Defina NEXTAUTH_URL para o URL implantado e reimplemente uma vez:
printf '%s' "https://<projeto>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Somente implantação pública) Compartilhe o acesso usando a frase secreta gerada: Seu Almanac implantado usa login por frase secreta (provedor de credenciais). Os revisores fazem login com qualquer nome de exibição + a frase secreta ALMANAC_ACCESS_PASSWORD gerada. Confirme se os comentários persistem após as recargas (prova que o Upstash KV está conectado).
Perguntas Frequentes do Almanac Seed
Almanac Seed é uma especificação de produto de "SEED.md" de arquivo único que instrui um agente de codificação de IA sobre como construir o aplicativo Almanac completo do zero. O repositório não contém código de aplicativo - apenas a receita.
Vídeo do Almanac Seed
Artigos Populares

Atoms: Uma Plataforma de IA Multiagente Que Transforma Ideias em Produtos Prontos para Lançamento
May 22, 2026

Nano Banana SBTI: O Que É, Como Funciona e Como Usá-lo em 2026
Apr 15, 2026

Análise do Atoms — O Construtor de Produtos de IA Redefinindo a Criação Digital em 2026
Apr 10, 2026

Kilo Claw: Como Implementar e Usar um Verdadeiro Agente de IA "Faça Você Mesmo" (Atualização de 2026)
Apr 3, 2026







