Almanac Seed
Almanac Seed es una receta SEED.md de un solo archivo que permite a un agente de codificación de IA construir y autoverificar una aplicación completa de revisión de diseño HTML estilo Figma con Next.js 14, con comentarios anclados por pines, discusiones en hilos, reacciones, resolución, presencia en vivo y una API con encabezado para revisores de IA.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
Información del Producto
Actualizado:08/06/2026
¿Qué es Almanac Seed?
Almanac Seed es una "semilla de producto" independiente para Almanac, una herramienta de revisión de diseño alojable localmente creada para comentar directamente sobre artefactos HTML renderizados, similar a los comentarios basados en pines de Figma, pero para prototipos web y exploraciones HTML de un solo archivo. En lugar de enviar código de aplicación, el repositorio proporciona un archivo de especificación autoritativo, SEED.md, que instruye a un agente de codificación de IA sobre cómo generar toda la aplicación desde cero, incluyendo rutas, modelo de datos, comportamiento de la interfaz de usuario, reglas de seguridad y pruebas de aceptación. La aplicación resultante es un proyecto Next.js 14 (App Router) con autenticación basada en NextAuth y una capa de persistencia respaldada por KV, diseñada para ejecutarse y verificarse completamente en la máquina de un desarrollador sin requerir servicios externos o credenciales de producción.
Características Principales de Almanac Seed
Almanac Seed es una receta de "SEED.md" de un solo archivo que instruye a un agente de codificación de IA para construir la aplicación web completa de Almanac desde cero: una herramienta de revisión de diseño Next.js 14 que permite a los colaboradores comentar directamente sobre artefactos HTML renderizados con hilos anclados por pines (estilo Figma), reacciones, estado de resolución y presencia en vivo. La semilla incluye un modelo de datos fijo, esquema KV, contratos de ruta/API (incluida una API de agente con cabecera), requisitos de interfaz de usuario/marca y un conjunto de verificación automatizado (27 viajes de aceptación) que puede ejecutarse localmente sin servicios externos o instancia de producción, utilizando una ruta de inicio de sesión de prueba solo para desarrollo y una opción de respaldo KV en memoria opcional.
Especificación de producto de un solo archivo que se hidrata en una aplicación completa: No envía código de aplicación, solo SEED.md, para que un agente de IA pueda generar toda la implementación de Almanac (Next.js 14 + TypeScript) solo a partir de la especificación.
Comentarios de pines estilo Figma en artefactos HTML reales: Los revisores abren un artefacto renderizado en un iframe y colocan pines numerados y arrastrables con discusiones en hilos, texto con enlaces, reacciones y comportamiento de resolver/deshacer resolución.
Verificación de aceptación incorporada (27 viajes): Incluye un conjunto Playwright de extremo a extremo que valida flujos funcionales y fidelidad visual a través de aserciones de estilo calculado/DOM contra los tokens de diseño absolutos de la especificación.
Dos rutas de acceso: sesiones humanas + API de agente: Admite la revisión humana a través de sesiones de NextAuth y una vía de API separada con dos cabeceras para que los revisores de IA lean artefactos y escriban comentarios en el mismo almacén.
Seguridad y autenticación portátiles para local + producción: Utiliza middleware y encabezados de Next.js (no configuración solo de implementación) para reglas de encuadre/seguridad; proporciona una ruta de inicio de sesión de prueba solo para desarrollo para verificación sin Google y una opción de inicio de sesión con frase de contraseña de producción.
Colaboración respaldada por KV con respaldo de desarrollo resiliente: Persiste comentarios/presencia/reacciones en Vercel KV (Upstash Redis) con un esquema de clave/tipo de Redis anclado, además de un respaldo de Map en memoria cuando las variables de entorno KV están ausentes para ejecuciones locales.
Casos de Uso de Almanac Seed
Revisión de diseño de producto para prototipos HTML: Los equipos que revisan maquetas HTML estáticas (páginas de destino, exploraciones de UI, páginas de marketing) pueden anotar directamente en el artefacto con pines y comentarios en hilos.
Control de calidad de diseño interno y aprobación de partes interesadas: Los gerentes de producto, ingenieros y partes interesadas pueden resolver hilos, reaccionar y rastrear la actividad/presencia para coordinar aprobaciones sin mover los comentarios a documentos separados.
Crítica de UX asistida por IA y revisión automatizada: Un agente de IA puede obtener artefactos y anclajes candidatos, publicar comentarios estructurados a través de la API del agente y participar junto a los humanos en la misma superficie de revisión.
Herramienta de revisión privada y alojada localmente para entornos regulados: Las organizaciones que necesitan herramientas locales pueden ejecutar la aplicación en localhost sin dependencias externas (autenticación de desarrollo + KV en memoria) y luego implementarla con acceso controlado.
Aplicación de sistemas de diseño y regresión visual: Los equipos pueden usar las aserciones visuales basadas en especificaciones para garantizar una tipografía, uso de mayúsculas y minúsculas, densidad de diseño y comportamiento de interacción consistentes en todas las iteraciones.
Ventajas
Construcción autocontenida y reproducible: un solo archivo semilla más la verificación automatizada permite una hidratación consistente desde cero.
Fuertes primitivas de colaboración: pines anclados, hilos, reacciones, estado de resolución y presencia reflejan flujos de trabajo familiares de revisión de diseño.
Diseñado para agentes: los puntos finales dedicados con cabecera permiten a los revisores de IA leer y escribir comentarios programáticamente.
Desventajas
Superficie de especificación compleja: el estricto esquema KV, las reglas de autenticación y los requisitos de fidelidad de la interfaz de usuario aumentan la complejidad de implementación y mantenimiento.
La configuración de producción aún requiere pasos de plataforma: la implementación pública necesita la configuración del proyecto Vercel y una conexión Upstash/Vercel KV (además de la gestión de secretos).
Valores predeterminados específicos del dominio: la semilla está adaptada a un flujo de trabajo particular (artefactos HTML, Next.js, Vercel KV, NextAuth), lo que puede no ajustarse a todas las pilas sin adaptación.
Cómo Usar Almanac Seed
1) Instalar Almanac Seed (receta CLI de Plow Seeds): Ejecute:
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
Esto instala las herramientas de Plow Seeds y obtiene la receta SEED.md de Almanac.
2) Abra el SEED.md y entrégueselo a un agente de codificación: Abra el SEED.md sin formato en su editor o navegador y péguelo en su agente de codificación de IA (por ejemplo, Claude Code) con una instrucción como: "Hidrate esta semilla: construya la aplicación que especifica, luego ejecute sus ## Pasos y ## Verifique hasta que pasen los 27 viajes del §16."
Nota: SEED.md es una especificación de producto completa; por diseño, no contiene código de implementación.
3) Decida si está realizando una verificación local o una implementación pública real: Compilación/verificación local: puede omitir la entrevista de implementación del Paso 0 e ir directamente a los pasos de compilación (la semilla lo llama "saltar directamente al §13.5").
Implementación pública: debe completar el Paso 0 primero (inicio de sesión de Vercel + creación/conexión de la tienda Upstash) antes de la compilación.
4) (Solo implementación pública) Complete los requisitos previos de la entrevista del Paso 0: En una terminal, asegúrese de que Node esté disponible (>= 18.17) y que Vercel CLI esté instalado. Si falta Vercel CLI, instálelo con un prefijo de escritura de usuario:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Luego autentíquese:
vercel login
Cree/vincule el proyecto de Vercel ahora (el alcance difiere para Equipo vs Personal):
- Equipo: vercel link --yes --project <su-almanac> --scope <su-equipo>
- Personal: vercel link --yes --project <su-almanac>
En el panel de control de Vercel, cree + conecte una base de datos Upstash para Redis a este proyecto (Almacenamiento → Crear base de datos → Upstash para Redis → Conectar proyecto → Todos los entornos).
5) (Solo implementación pública) Establezca secretos de producción (frase de contraseña generada por el agente): Genere y establezca secretos (la semilla especifica que el agente debe generar la frase de contraseña; el usuario no la elige):
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
NO establezca ALMANAC_TEST_LOGIN en producción.
6) Ejecute los pasos de compilación de la semilla localmente (los "Pasos" del §13.5 de la semilla): Siga los pasos del §13.5 de SEED.md para hidratar/construir la aplicación. En resumen, la semilla instruye al agente a:
- Asegurarse de que Node >= 18.17
- Instalar dependencias de npm (npm install)
- Asegurarse de que exista un corpus cookoff-seeds/ (la semilla crea un ejemplo si falta)
- Instalar Playwright Chromium + dependencias del SO:
npx playwright install --with-deps chromium
- Crear .env.local para desarrollo local (incluyendo NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 y claves de agente de desarrollo)
- Compilar y ejecutar en el puerto 3210 (npm run build; npm start -p 3210 o equivalente)
7) Inicie la aplicación en el puerto 3210 y confirme que responde: Ejecute el servidor y confirme que /login se carga:
npm run build
npm start
Luego verifique:
curl -sI http://localhost:3210/login
Espere HTTP 200.
8) Inicie sesión localmente sin Google usando la ruta de inicio de sesión de prueba solo para desarrolladores: Con ALMANAC_TEST_LOGIN=1 en .env.local, abra:
http://localhost:3210/api/[email protected]&next=/
Esto crea una cookie de sesión de NextAuth y lo redirige a la aplicación (no se requiere Google OAuth para la verificación local).
9) Ejecute el conjunto de verificación de la semilla (el "Verificar" del §15 / los viajes del §16 de la semilla): Ejecute el conjunto E2E de Playwright:
npm run e2e
Los criterios de aceptación de la semilla son los 27 viajes del §16 (aserciones funcionales + visuales de estilo calculado). Todos deben pasar contra localhost:3210.
10) (Opcional) Use el script de prueba de Docker stranger proporcionado: Si desea una verificación de "contenedor en blanco" completamente aislada, ejecute el script de verificación del repositorio (requiere Docker y un CLI de claude configurado):
verify/hydrate-and-verify.sh
Automatiza el flujo de stranger en un contenedor node:20-slim e imprime un resultado FINAL_VERIFY.
11) (Solo implementación pública) Implementar en Vercel (el "Implementar" del §13.6 de la semilla): Una vez completado el Paso 0 y su aplicación se compile localmente, implemente:
vercel deploy --prod
Luego deshabilite la Protección de Implementación de Vercel (ssoProtection) a través de la API o el panel de control (requerido para que /login sea accesible). Establezca NEXTAUTH_URL en la URL implementada y vuelva a implementar una vez:
printf '%s' "https://<proyecto>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Solo implementación pública) Comparta el acceso usando la frase de contraseña generada: Su Almanac implementado usa inicio de sesión con frase de contraseña (proveedor de credenciales). Los revisores inician sesión con cualquier nombre de visualización + la frase de contraseña ALMANAC_ACCESS_PASSWORD generada. Confirme que los comentarios persisten después de las recargas (prueba que Upstash KV está conectado).
Preguntas Frecuentes de Almanac Seed
Almanac Seed es una especificación de producto de "SEED.md" de un solo archivo que instruye a un agente de codificación de IA sobre cómo construir la aplicación completa de Almanac desde cero. El repositorio no contiene código de aplicación, solo la receta.
Video de Almanac Seed
Artículos Populares
Atoms: Una Plataforma de IA Multiagente Que Transforma Ideas en Productos Listos para Lanzar
May 22, 2026
Nano Banana SBTI: Qué es, cómo funciona y cómo usarlo en 2026
Apr 15, 2026
Reseña de Atoms: El Constructor de Productos de IA que Redefine la Creación Digital en 2026
Apr 10, 2026
Kilo Claw: Cómo implementar y usar un verdadero agente de IA "Hágalo por usted" (Actualización 2026)
Apr 3, 2026
Últimas herramientas de IA similares a Almanac Seed
Foundry
Foundry es una plataforma versátil que existe en múltiples formas: como una cadena de herramientas para el desarrollo de contratos inteligentes, un software de juegos de mesa virtual y una instalación tradicional de fundición de metales, cada una ofreciendo características especializadas para sus respectivos dominios.
PythonConvert.com
PythonConvert.com es una herramienta gratuita basada en la web que proporciona traducción de código impulsada por IA entre Python y otros lenguajes de programación, así como capacidades de conversión de tipos de Python.
Softgen
Softgen.ai es una plataforma generadora de proyectos de pila completa impulsada por IA que permite a los usuarios transformar sus ideas en aplicaciones web funcionales sin requisitos de codificación.
Micro SaaS Ideas
Las Ideas de Micro SaaS son soluciones de software pequeñas y enfocadas en nichos que abordan problemas o mercados específicos, ofreciendo a los emprendedores una forma de construir negocios rentables con recursos y complejidad mínimas.
Herramientas de IA populares como Almanac Seed
GitHub Copilot Chat
GitHub Copilot Chat es un asistente de codificación impulsado por IA que proporciona interacciones en lenguaje natural, sugerencias de código en tiempo real y soporte contextual directamente dentro de los IDEs compatibles y GitHub.com.
CopilotForXcode
CopilotForXcode es una Extensión del Editor de Código de Xcode que integra GitHub Copilot, Codeium y ChatGPT para proporcionar sugerencias de código impulsadas por IA, asistencia de chat y funcionalidad de prompt-a-código dentro de Xcode.
OpenAI Codex CLI
OpenAI Codex CLI es un agente de codificación ligero de código abierto que se ejecuta en su terminal, lo que permite a los desarrolladores traducir el lenguaje natural en la ejecución de código al tiempo que proporciona un razonamiento a nivel de ChatGPT con la capacidad de ejecutar código, manipular archivos e iterar bajo control de versiones.
GoCodeo SaaS Builder
GoCodeo SaaS Builder es un framework nativo de IA que genera automáticamente aplicaciones SaaS full-stack listas para producción utilizando agentes de IA autónomos, completas con autenticación, funciones en tiempo real e integración de TypeScript.