Almanac Seed — это однофайловый рецепт SEED.md, который позволяет агенту кодирования ИИ создавать и самостоятельно проверять полноценное приложение Next.js 14 для обзора HTML-дизайна в стиле Figma с комментариями, привязанными к булавкам, ветками обсуждений, реакциями, разрешением, живым присутствием и API с защитой заголовками для рецензентов ИИ.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
Almanac Seed

Информация о продукте

Обновлено:08/06/2026

Что такое Almanac Seed

Almanac Seed — это автономный «продукт-заготовка» для Almanac, локально размещаемого инструмента для обзора дизайна, созданного для комментирования непосредственно на отрендеренных HTML-артефактах — аналогично комментированию на основе булавок в Figma, но для веб-прототипов и однофайловых HTML-исследований. Вместо поставки кода приложения, репозиторий предоставляет один авторитетный файл спецификации, SEED.md, который инструктирует агента кодирования ИИ, как сгенерировать все приложение с нуля, включая маршруты, модель данных, поведение пользовательского интерфейса, правила безопасности и приемочные тесты. Полученное приложение представляет собой проект Next.js 14 (App Router) с аутентификацией на основе NextAuth и уровнем персистентности на основе KV, разработанный для работы и проверки полностью на машине разработчика без необходимости внешних сервисов или производственных учетных данных.

Ключевые особенности Almanac Seed

Almanac Seed — это однофайловый рецепт «SEED.md», который инструктирует AI-агента по кодированию создать полноценное веб-приложение Almanac с нуля: инструмент для проверки дизайна на Next.js 14, который позволяет соавторам комментировать непосредственно отрисованные HTML-артефакты с помощью прикрепленных веток (в стиле Figma), реакций, статуса разрешения и живого присутствия. Рецепт включает фиксированную модель данных, схему KV, контракты маршрутов/API (включая API агента с заголовком), требования к пользовательскому интерфейсу/бренду и автоматизированный набор для проверки (27 сценариев приемки), который может работать локально без внешних служб или производственного экземпляра, используя путь тестового входа только для разработки и опциональный резервный KV в памяти.
Однофайловая спецификация продукта, которая превращается в полноценное приложение: Поставляется без кода приложения — только SEED.md — поэтому агент ИИ может сгенерировать всю реализацию Almanac (Next.js 14 + TypeScript) исключительно из спецификации.
Комментарии-булавки в стиле Figma на реальных HTML-артефактах: Рецензенты открывают артефакт, отображаемый в iframe, и размещают пронумерованные, перетаскиваемые булавки с ветвящимися обсуждениями, ссылочным текстом, реакциями и поведением разрешения/отмены разрешения.
Встроенная проверка приемки (27 сценариев): Включает сквозной набор Playwright, который проверяет функциональные потоки и визуальную точность с помощью утверждений вычисленных стилей/DOM по абсолютным дизайн-токенам спецификации.
Два пути доступа: сеансы для людей + API агента: Поддерживает проверку людьми через сеансы NextAuth и отдельный API-канал с двумя заголовками для ИИ-рецензентов для чтения артефактов и записи комментариев в то же хранилище.
Портативная безопасность и аутентификация для локальной среды + продакшена: Использует промежуточное ПО и заголовки Next.js (а не только конфигурацию развертывания) для правил фрейминга/безопасности; предоставляет маршрут тестового входа только для разработчиков для проверки без Google и опцию входа по паролю для продакшена.
Совместная работа на основе KV с надежным резервом для разработчиков: Сохраняет комментарии/присутствие/реакции в Vercel KV (Upstash Redis) с прикрепленным ключом Redis/схемой типа, а также резервный вариант Map в памяти, когда переменные среды KV отсутствуют для локальных запусков.

Варианты использования Almanac Seed

Проверка дизайна продукта для HTML-прототипов: Команды, просматривающие статические HTML-макеты (целевые страницы, исследования пользовательского интерфейса, маркетинговые страницы), могут комментировать непосредственно артефакт с помощью булавок и ветвящихся отзывов.
Внутренний контроль качества дизайна и утверждение заинтересованными сторонами: Менеджеры по продукту, инженеры и заинтересованные стороны могут разрешать ветки, реагировать и отслеживать активность/присутствие для координации утверждений без переноса отзывов в отдельные документы.
Критика UX с помощью ИИ и автоматизированная проверка: Агент ИИ может получать артефакты и потенциальные привязки, публиковать структурированные комментарии через API агента и участвовать вместе с людьми на той же поверхности для проверки.
Частный, локально размещенный инструмент проверки для регулируемых сред: Организации, нуждающиеся в локальных инструментах, могут запускать приложение на localhost без внешних зависимостей (аутентификация для разработчиков + KV в памяти) и впоследствии развертывать с контролируемым доступом.
Применение дизайн-систем и визуальной регрессии: Команды могут использовать визуальные утверждения, основанные на спецификациях, для обеспечения согласованной типографики, регистра, плотности макета и поведения взаимодействия на протяжении итераций.

Преимущества

Автономная, воспроизводимая сборка: один файл-рецепт плюс автоматизированная проверка обеспечивают согласованное создание с нуля.
Мощные примитивы для совместной работы: прикрепленные булавки, ветки, реакции, состояние разрешения и присутствие отражают привычные рабочие процессы проверки дизайна.
Удобный для агентов по умолчанию: выделенные конечные точки с заголовками позволяют ИИ-рецензентам читать и записывать отзывы программно.

Недостатки

Сложная область спецификации: строгая схема KV, правила аутентификации и требования к точности пользовательского интерфейса увеличивают сложность реализации и поддержки.
Настройка продакшена по-прежнему требует шагов платформы: для публичного развертывания требуется настройка проекта Vercel и подключение Upstash/Vercel KV (плюс управление секретами).
Специфичные для домена значения по умолчанию: рецепт адаптирован к конкретному рабочему процессу (HTML-артефакты, Next.js, Vercel KV, NextAuth), который может не подходить для всех стеков без адаптации.

Как использовать Almanac Seed

1) Установите Almanac Seed (рецепт Plow Seeds CLI): Выполните: 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 Это устанавливает инструменты Plow Seeds и загружает рецепт Almanac SEED.md.
2) Откройте SEED.md и передайте его агенту кодирования: Откройте исходный SEED.md в своем редакторе или браузере и вставьте его в своего агента кодирования ИИ (например, Claude Code) с инструкцией типа: «Гидратируйте эту заготовку: создайте приложение, которое она указывает, затем выполните его ## Steps и ## Verify, пока все 27 §16 путешествий не будут пройдены». Примечание: SEED.md — это полная спецификация продукта; он по замыслу не содержит кода реализации.
3) Решите, выполняете ли вы локальную проверку или реальное публичное развертывание: Локальная сборка/проверка: вы можете пропустить этап развертывания Шага 0 и перейти непосредственно к этапам сборки (заготовка называет это «перейти непосредственно к §13.5»). Публичное развертывание: вы должны сначала завершить Шаг 0 (вход в Vercel + создание/подключение хранилища Upstash) перед сборкой.
4) (Только для публичного развертывания) Завершите предварительные условия Шага 0: В терминале убедитесь, что Node доступен (>= 18.17) и установлен Vercel CLI. Если Vercel CLI отсутствует, установите его с префиксом, доступным для записи пользователем: mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global export PATH="$HOME/.npm-global/bin:$PATH" npm i -g vercel Затем пройдите аутентификацию: vercel login Создайте/свяжите проект Vercel сейчас (область действия отличается для команды и личного использования): - Команда: vercel link --yes --project <ваш-almanac> --scope <ваша-команда> - Личное: vercel link --yes --project <ваш-almanac> На панели управления Vercel создайте и подключите базу данных Upstash for Redis к этому проекту (Storage → Create Database → Upstash for Redis → Connect Project → All Environments).
5) (Только для публичного развертывания) Установите производственные секреты (парольная фраза, сгенерированная агентом): Сгенерируйте и установите секреты (заготовка указывает, что агент должен генерировать парольную фразу; пользователь ее не выбирает): 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 НЕ устанавливайте ALMANAC_TEST_LOGIN в производственной среде.
6) Выполните этапы сборки заготовки локально (§13.5 «Steps» заготовки): Следуйте шагам §13.5 SEED.md для гидратации/сборки приложения. Вкратце, заготовка инструктирует агента: - Убедиться, что Node >= 18.17 - Установить зависимости npm (npm install) - Убедиться, что существует корпус cookoff-seeds/ (заготовка создает пример, если он отсутствует) - Установить Playwright Chromium + зависимости ОС: npx playwright install --with-deps chromium - Создать .env.local для локальной разработки (включая NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 и ключи агента разработки) - Собрать и запустить на порту 3210 (npm run build; npm start -p 3210 или эквивалент)
7) Запустите приложение на порту 3210 и убедитесь, что оно отвечает: Запустите сервер и убедитесь, что /login загружается: npm run build npm start Затем проверьте: curl -sI http://localhost:3210/login Ожидается HTTP 200.
8) Войдите локально без Google, используя тестовый маршрут входа только для разработки: С ALMANAC_TEST_LOGIN=1 в .env.local откройте: http://localhost:3210/api/[email protected]&next=/ Это создает сессионный файл cookie NextAuth и перенаправляет вас в приложение (для локальной проверки не требуется Google OAuth).
9) Запустите набор проверки заготовки (§15 «Verify» / §16 journeys заготовки): Запустите набор E2E Playwright: npm run e2e Критерии приемки заготовки — это 27 путешествий в §16 (функциональные + визуальные утверждения по вычисленным стилям). Все они должны пройти проверку на localhost:3210.
10) (Необязательно) Используйте предоставленный скрипт Docker stranger-test: Если вам нужна полностью изолированная проверка в «пустом контейнере», запустите скрипт проверки репозитория (требуется Docker и настроенный claude CLI): verify/hydrate-and-verify.sh Он автоматизирует процесс stranger в контейнере node:20-slim и выводит результат FINAL_VERIFY.
11) (Только для публичного развертывания) Разверните в Vercel (§13.6 «Deploy» заготовки): После завершения Шага 0 и локальной сборки вашего приложения разверните его: vercel deploy --prod Затем отключите Vercel Deployment Protection (ssoProtection) через API или панель управления (требуется для доступности /login). Установите NEXTAUTH_URL на развернутый URL и разверните еще раз: printf '%s' "https://<project>.vercel.app" | vercel env add NEXTAUTH_URL production vercel deploy --prod
12) (Только для публичного развертывания) Предоставьте доступ с помощью сгенерированной парольной фразы: Ваш развернутый Almanac использует вход по парольной фразе (провайдер учетных данных). Рецензенты входят с любым отображаемым именем + сгенерированной парольной фразой ALMANAC_ACCESS_PASSWORD. Убедитесь, что комментарии сохраняются при перезагрузках (доказывает, что Upstash KV подключен).

Часто задаваемые вопросы о Almanac Seed

Almanac Seed — это однофайловая спецификация продукта "SEED.md", которая инструктирует AI-агента по кодированию, как создать полноценное приложение Almanac с нуля. Репозиторий не содержит кода приложения — только рецепт.

Последние ИИ-инструменты, похожие на Almanac Seed

Foundry
Foundry
Contact for PricingAI Code GeneratorGame Tools
Foundry — это универсальная платформа, существующая в нескольких формах — как инструментарий для разработки смарт-контрактов, программное обеспечение для виртуальных настольных игр и традиционный литейный цех — каждая из которых предлагает специализированные функции для своих respective областей.
PythonConvert.com
PythonConvert.com
PythonConvert.com is a free web-based tool that provides AI-powered code translation between Python and other programming languages as well as Python type conversion capabilities.
Softgen
Softgen
Softgen.ai — это платформа для генерации полностековых проектов с поддержкой ИИ, которая позволяет пользователям превращать свои идеи в функциональные веб-приложения без необходимости в кодировании.
Micro SaaS Ideas
Micro SaaS Ideas
Идеи Micro SaaS — это небольшие, ориентированные на нишу программные решения, которые направлены на решение конкретных проблем или рынков, предлагая предпринимателям способ создания прибыльных бизнесов с минимальными ресурсами и сложностью.