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

Информация о продукте
Обновлено: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
Популярные статьи

Atoms: Мультиагентная ИИ-платформа, которая превращает идеи в готовые к запуску продукты
May 22, 2026

Nano Banana SBTI: Что это такое, как это работает и как это использовать в 2026 году
Apr 15, 2026

Обзор Atoms — AI Product Builder, переопределяющий цифровое творчество в 2026 году
Apr 10, 2026

Kilo Claw: Как развернуть и использовать настоящего AI-агента "Сделай-Это-За-Вас" (Обновление 2026)
Apr 3, 2026







