Almanac Seed est une recette SEED.md à fichier unique qui permet à un agent de codage IA de construire et d'auto-vérifier une application complète de révision de conception HTML de style Figma, basée sur Next.js 14, avec des commentaires ancrés par des épingles, des discussions filées, des réactions, la résolution, la présence en direct et une API protégée par en-tête pour les réviseurs IA.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure
Almanac Seed

Informations sur le produit

Mis à jour:Jun 8, 2026

Qu'est-ce que Almanac Seed

Almanac Seed est une "graine de produit" autonome pour Almanac, un outil d'examen de conception hébergeable localement, conçu pour commenter directement les artefacts HTML rendus – similaire aux commentaires basés sur des épingles de Figma, mais pour les prototypes web et les explorations HTML à fichier unique. Au lieu de livrer du code d'application, le dépôt fournit un fichier de spécification faisant autorité, SEED.md, qui indique à un agent de codage IA comment générer l'application entière à partir de zéro, y compris les routes, le modèle de données, le comportement de l'interface utilisateur, les règles de sécurité et les tests d'acceptation. L'application résultante est un projet Next.js 14 (App Router) avec une authentification basée sur NextAuth et une couche de persistance basée sur KV, conçue pour fonctionner et être vérifiée entièrement sur la machine d'un développeur sans nécessiter de services externes ou de justificatifs de production.

Caractéristiques principales de Almanac Seed

Almanac Seed est une recette "SEED.md" monofichier qui demande à un agent de codage IA de construire l'application web complète Almanac à partir de zéro : un outil de revue de conception Next.js 14 qui permet aux collaborateurs de commenter directement les artefacts HTML rendus avec des fils de discussion ancrés par des épingles (à la manière de Figma), des réactions, un état de résolution et une présence en direct. Le seed comprend un modèle de données fixe, un schéma KV, des contrats de route/API (y compris une API d'agent protégée par en-tête), des exigences d'interface utilisateur/de marque, et une suite de vérification automatisée (27 parcours d'acceptation) qui peut s'exécuter localement sans services externes ni instance de production, en utilisant un chemin de connexion de test réservé aux développeurs et un fallback KV en mémoire facultatif.
Spécification de produit monofichier qui se transforme en une application complète: Ne livre aucun code d'application – seulement SEED.md – afin qu'un agent IA puisse générer l'implémentation complète d'Almanac (Next.js 14 + TypeScript) à partir de la seule spécification.
Commentaires épinglés à la Figma sur de vrais artefacts HTML: Les relecteurs ouvrent un artefact rendu dans un iframe et déposent des épingles numérotées et déplaçables avec des discussions filaires, du texte lié, des réactions et un comportement de résolution/non-résolution.
Vérification d'acceptation intégrée (27 parcours): Comprend une suite Playwright de bout en bout qui valide les flux fonctionnels et la fidélité visuelle via des assertions de style calculé/DOM par rapport aux jetons de conception absolus de la spécification.
Deux chemins d'accès : sessions humaines + API d'agent: Prend en charge la revue humaine via les sessions NextAuth et une voie API distincte protégée par deux en-têtes pour que les relecteurs IA puissent lire les artefacts et écrire des commentaires dans le même magasin.
Sécurité et authentification portables pour le local + la production: Utilise des middlewares et des en-têtes Next.js (pas de configuration uniquement pour le déploiement) pour les règles de cadrage/sécurité ; fournit une route de connexion de test réservée aux développeurs pour la vérification sans Google et une option de connexion par phrase secrète de production.
Collaboration basée sur KV avec un fallback de développement résilient: Persiste les commentaires/présence/réactions dans Vercel KV (Upstash Redis) avec un schéma de clé/type Redis épinglé, plus un fallback Map en mémoire lorsque les variables d'environnement KV sont absentes pour les exécutions locales.

Cas d'utilisation de Almanac Seed

Revue de conception de produit pour les prototypes HTML: Les équipes qui examinent des maquettes HTML statiques (pages de destination, explorations d'interface utilisateur, pages marketing) peuvent annoter directement l'artefact avec des épingles et des commentaires filaires.
Assurance qualité de la conception interne et approbation des parties prenantes: Les chefs de produit, les ingénieurs et les parties prenantes peuvent résoudre les fils de discussion, réagir et suivre l'activité/la présence pour coordonner les approbations sans déplacer les commentaires dans des documents séparés.
Critique UX assistée par l'IA et revue automatisée: Un agent IA peut récupérer des artefacts et des ancres candidates, publier des commentaires structurés via l'API de l'agent et participer aux côtés des humains sur la même surface de revue.
Outil de revue privé, hébergé localement pour les environnements réglementés: Les organisations ayant besoin d'outils locaux peuvent exécuter l'application sur localhost sans dépendances externes (authentification de développement + KV en mémoire) et la déployer ultérieurement avec un accès contrôlé.
Application du système de conception et de la régression visuelle: Les équipes peuvent utiliser les assertions visuelles basées sur les spécifications pour garantir une typographie, une casse, une densité de mise en page et un comportement d'interaction cohérents à travers les itérations.

Avantages

Construction autonome et reproductible : un seul fichier seed et une vérification automatisée permettent une hydratation cohérente à partir de zéro.
Primitives de collaboration solides : les épingles ancrées, les fils de discussion, les réactions, l'état de résolution et la présence reflètent les flux de travail familiers de revue de conception.
Conçu pour les agents : des points de terminaison dédiés protégés par en-tête permettent aux relecteurs IA de lire et d'écrire des commentaires par programmation.

Inconvénients

Surface de spécification complexe : le schéma KV strict, les règles d'authentification et les exigences de fidélité de l'interface utilisateur augmentent la complexité de l'implémentation et de la maintenance.
La configuration de production nécessite toujours des étapes de plateforme : le déploiement public nécessite la configuration du projet Vercel et une connexion Upstash/Vercel KV (plus la gestion des secrets).
Paramètres par défaut spécifiques au domaine : le seed est adapté à un flux de travail particulier (artefacts HTML, Next.js, Vercel KV, NextAuth), ce qui peut ne pas convenir à toutes les piles sans adaptation.

Comment utiliser Almanac Seed

1) Installer Almanac Seed (recette CLI Plow Seeds): Exécutez : 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 Ceci installe les outils Plow Seeds et récupère la recette Almanac SEED.md.
2) Ouvrez le SEED.md et confiez-le à un agent de codage: Ouvrez le SEED.md brut dans votre éditeur ou navigateur et collez-le dans votre agent de codage IA (par exemple, Claude Code) avec une instruction telle que : "Hydratez cette graine : construisez l'application qu'elle spécifie, puis exécutez ses ## Étapes et ## Vérifiez jusqu'à ce que les 27 parcours §16 soient passés." Note : SEED.md est une spécification de produit complète ; il ne contient aucun code d'implémentation par conception.
3) Décidez si vous effectuez une vérification locale ou un déploiement public réel: Construction/vérification locale : vous pouvez ignorer l'entretien de déploiement de l'étape 0 et passer directement aux étapes de construction (la graine appelle cela "passer directement au §13.5"). Déploiement public : vous devez d'abord compléter l'étape 0 (connexion Vercel + création/connexion du magasin Upstash) avant de construire.
4) (Déploiement public uniquement) Complétez les prérequis de l'entretien de l'étape 0: Dans un terminal, assurez-vous que Node est disponible (>= 18.17) et que Vercel CLI est installé. Si Vercel CLI est manquant, installez-le avec un préfixe accessible en écriture par l'utilisateur : mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global export PATH="$HOME/.npm-global/bin:$PATH" npm i -g vercel Puis authentifiez-vous : vercel login Créez/liez le projet Vercel maintenant (la portée diffère pour Équipe vs Personnel) : - Équipe : vercel link --yes --project <votre-almanac> --scope <votre-équipe> - Personnel : vercel link --yes --project <votre-almanac> Dans le tableau de bord Vercel, créez + connectez une base de données Upstash pour Redis à ce projet (Stockage → Créer une base de données → Upstash pour Redis → Connecter le projet → Tous les environnements).
5) (Déploiement public uniquement) Définissez les secrets de production (phrase secrète générée par l'agent): Générez et définissez les secrets (la graine spécifie que l'agent doit générer la phrase secrète ; l'utilisateur ne la choisit pas) : 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 Ne définissez PAS ALMANAC_TEST_LOGIN en production.
6) Exécutez les étapes de construction de la graine localement (les "Étapes" §13.5 de la graine): Suivez les étapes §13.5 du SEED.md pour hydrater/construire l'application. En résumé, la graine instruit l'agent de : - S'assurer que Node >= 18.17 - Installer les dépendances npm (npm install) - S'assurer qu'un corpus cookoff-seeds/ existe (la graine en crée un exemple s'il est manquant) - Installer Playwright Chromium + dépendances OS : npx playwright install --with-deps chromium - Créer .env.local pour le développement local (y compris NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1, et les clés d'agent de développement) - Construire et exécuter sur le port 3210 (npm run build; npm start -p 3210 ou équivalent)
7) Démarrez l'application sur le port 3210 et confirmez qu'elle répond: Exécutez le serveur et confirmez que /login se charge : npm run build npm start Puis vérifiez : curl -sI http://localhost:3210/login Attendez-vous à un HTTP 200.
8) Connectez-vous localement sans Google en utilisant la route de connexion de test réservée aux développeurs: Avec ALMANAC_TEST_LOGIN=1 dans .env.local, ouvrez : http://localhost:3210/api/[email protected]&next=/ Ceci crée un cookie de session NextAuth et vous redirige vers l'application (aucune authentification Google OAuth n'est requise pour la vérification locale).
9) Exécutez la suite de vérification de la graine (les parcours §15 "Vérifier" / §16 de la graine): Exécutez la suite E2E de Playwright : npm run e2e Les critères d'acceptation de la graine sont les 27 parcours du §16 (assertions fonctionnelles + visuelles de style calculé). Tous doivent passer contre localhost:3210.
10) (Facultatif) Utilisez le script de test étranger Docker fourni: Si vous souhaitez une vérification "conteneur vierge" entièrement isolée, exécutez le script de vérification du dépôt (nécessite Docker et un CLI claude configuré) : verify/hydrate-and-verify.sh Il automatise le flux étranger dans un conteneur node:20-slim et imprime un résultat FINAL_VERIFY.
11) (Déploiement public uniquement) Déployez sur Vercel (le §13.6 "Déployer" de la graine): Une fois l'étape 0 terminée et votre application construite localement, déployez : vercel deploy --prod Puis désactivez la protection de déploiement Vercel (ssoProtection) via l'API ou le tableau de bord (requis pour que /login soit accessible). Définissez NEXTAUTH_URL sur l'URL déployée et redéployez une fois : printf '%s' "https://<projet>.vercel.app" | vercel env add NEXTAUTH_URL production vercel deploy --prod
12) (Déploiement public uniquement) Partagez l'accès en utilisant la phrase secrète générée: Votre Almanac déployé utilise la connexion par phrase secrète (fournisseur d'informations d'identification). Les réviseurs se connectent avec n'importe quel nom d'affichage + la phrase secrète ALMANAC_ACCESS_PASSWORD générée. Confirmez que les commentaires persistent après les rechargements (prouve que Upstash KV est connecté).

FAQ de Almanac Seed

Almanac Seed est une spécification de produit "SEED.md" à fichier unique qui indique à un agent de codage IA comment construire l'application Almanac complète à partir de zéro. Le dépôt ne contient aucun code d'application, seulement la recette.

Derniers outils d'IA similaires à Almanac Seed

Foundry
Foundry
Contact for PricingAI Code GeneratorGame Tools
Foundry est une plateforme polyvalente qui existe sous plusieurs formes - en tant qu'outil de développement de contrats intelligents, logiciel de jeux de société virtuels, et installation traditionnelle de moulage de métaux - chacune offrant des fonctionnalités spécialisées pour leurs domaines respectifs.
PythonConvert.com
PythonConvert.com
PythonConvert.com est un outil gratuit basé sur le web qui fournit une traduction de code alimentée par l'IA entre Python et d'autres langages de programmation ainsi que des capacités de conversion de type Python.
Softgen
Softgen
Softgen.ai est une plateforme génératrice de projets full-stack alimentée par l'IA qui permet aux utilisateurs de transformer leurs idées en applications web fonctionnelles sans exigences de codage.
Micro SaaS Ideas
Micro SaaS Ideas
Les idées de Micro SaaS sont des solutions logicielles à petite échelle, axées sur des niches, qui ciblent des problèmes ou des marchés spécifiques, offrant aux entrepreneurs un moyen de construire des entreprises rentables avec des ressources et une complexité minimales.