
Almanac Seed
Almanac Seed ist ein einteiliges SEED.md-Rezept, das einem KI-Codierungsagenten ermöglicht, eine vollständige Next.js 14, Figma-ähnliche HTML-Design-Review-App mit Pin-verankerten Kommentaren, Thread-Diskussionen, Reaktionen, Auflösung, Live-Anwesenheit und einer Header-geschützten API für KI-Prüfer zu erstellen und selbst zu verifizieren.
https://seeds.plow.co/seed/plow-pbc/almanac-seed?ref=producthunt&utm_source=aipure

Produktinformationen
Aktualisiert:Jun 8, 2026
Was ist Almanac Seed
Almanac Seed ist ein eigenständiges „Produkt-Seed“ für Almanac, ein lokal hostbares Design-Review-Tool, das zum Kommentieren direkt auf gerenderten HTML-Artefakten entwickelt wurde – ähnlich dem Pin-basierten Kommentieren von Figma, aber für Web-Prototypen und Single-File-HTML-Explorationen. Anstatt Anwendungscode auszuliefern, stellt das Repository eine maßgebliche Spezifikationsdatei, SEED.md, bereit, die einem KI-Codierungsagenten Anweisungen gibt, wie die gesamte Anwendung von Grund auf neu generiert werden kann, einschließlich Routen, Datenmodell, UI-Verhalten, Sicherheitsregeln und Akzeptanztests. Die resultierende App ist ein Next.js 14 (App Router)-Projekt mit NextAuth-basierter Authentifizierung und einer KV-gestützten Persistenzschicht, das so konzipiert ist, dass es vollständig auf dem Computer eines Entwicklers ausgeführt und verifiziert werden kann, ohne externe Dienste oder Produktionsanmeldeinformationen zu erfordern.
Hauptfunktionen von Almanac Seed
Almanac Seed ist ein einteiliges „SEED.md“-Rezept, das einem KI-Codierungsagenten Anweisungen gibt, die vollständige Almanac-Web-App von Grund auf neu zu erstellen: ein Next.js 14 Design-Review-Tool, das es Mitarbeitern ermöglicht, direkt auf gerenderte HTML-Artefakte mit angehefteten Threads (Figma-Stil), Reaktionen, Lösungsstatus und Live-Präsenz zu kommentieren. Der Seed enthält ein festes Datenmodell, ein KV-Schema, Routen-/API-Verträge (einschließlich einer Header-geschützten Agenten-API), UI-/Markenanforderungen und eine automatisierte Verifizierungssuite (27 Akzeptanz-Journeys), die lokal ohne externe Dienste oder Produktionsinstanz ausgeführt werden kann, unter Verwendung eines nur für Entwickler bestimmten Test-Login-Pfads und eines optionalen In-Memory-KV-Fallbacks.
Ein-Dateien-Produktspezifikation, die sich zu einer vollständigen App hydriert: Liefert keinen Anwendungscode – nur SEED.md – sodass ein KI-Agent die gesamte Almanac-Implementierung (Next.js 14 + TypeScript) allein aus der Spezifikation generieren kann.
Figma-ähnliche Pin-Kommentare zu echten HTML-Artefakten: Rezensenten öffnen ein in einem Iframe gerendertes Artefakt und setzen nummerierte, ziehbare Pins mit Thread-Diskussionen, verlinktem Text, Reaktionen und Auflösungs-/Nicht-Auflösungsverhalten.
Integrierte Akzeptanzprüfung (27 Journeys): Enthält eine End-to-End-Playwright-Suite, die funktionale Abläufe und visuelle Wiedergabetreue über Computed-Style-/DOM-Assertions gegen die absoluten Design-Tokens der Spezifikation validiert.
Zwei Zugriffspfade: menschliche Sitzungen + Agenten-API: Unterstützt menschliche Überprüfung über NextAuth-Sitzungen und eine separate, durch zwei Header geschützte API-Spur für KI-Rezensenten, um Artefakte zu lesen und Kommentare in denselben Speicher zu schreiben.
Portable Sicherheit und Authentifizierung für lokal + Produktion: Verwendet Middleware und Next.js-Header (nicht nur Deploy-Konfiguration) für Framing-/Sicherheitsregeln; bietet eine nur für Entwickler bestimmte Test-Login-Route zur Verifizierung ohne Google und eine Produktions-Passphrase-Login-Option.
KV-gestützte Zusammenarbeit mit resilientem Entwicklungs-Fallback: Persistiert Kommentare/Präsenz/Reaktionen in Vercel KV (Upstash Redis) mit einem angehefteten Redis-Schlüssel-/Typ-Schema, plus einem In-Memory-Map-Fallback, wenn KV-Umgebungsvariablen für lokale Ausführungen fehlen.
Anwendungsfälle von Almanac Seed
Produktdesign-Review für HTML-Prototypen: Teams, die statische HTML-Mocks (Landing Pages, UI-Explorationen, Marketing-Seiten) überprüfen, können direkt auf dem Artefakt mit Pins und Thread-Feedback Anmerkungen machen.
Interne Design-QA und Stakeholder-Freigabe: PMs, Ingenieure und Stakeholder können Threads auflösen, reagieren und Aktivitäten/Präsenz verfolgen, um Genehmigungen zu koordinieren, ohne Feedback in separate Dokumente verschieben zu müssen.
KI-gestützte UX-Kritik und automatisierte Überprüfung: Ein KI-Agent kann Artefakte und Kandidatenanker abrufen, strukturierte Kommentare über die Agenten-API posten und zusammen mit Menschen an derselben Überprüfungsfläche teilnehmen.
Privates, lokal gehostetes Überprüfungstool für regulierte Umgebungen: Organisationen, die Local-First-Tools benötigen, können die App auf localhost ohne externe Abhängigkeiten (Dev-Authentifizierung + In-Memory-KV) ausführen und später mit kontrolliertem Zugriff bereitstellen.
Design-System und visuelle Regressionsdurchsetzung: Teams können die spezifikationsgesteuerten visuellen Zusicherungen verwenden, um konsistente Typografie, Groß-/Kleinschreibung, Layoutdichte und Interaktionsverhalten über Iterationen hinweg durchzusetzen.
Vorteile
Eigenständiger, reproduzierbarer Build: Eine einzelne Seed-Datei plus automatisierte Verifizierung ermöglicht eine konsistente Hydrierung von Grund auf.
Starke Kollaborations-Grundlagen: Angeheftete Pins, Threads, Reaktionen, Lösungsstatus und Präsenz spiegeln vertraute Design-Review-Workflows wider.
Agentenfreundlich von Design: Dedizierte, durch Header geschützte Endpunkte ermöglichen es KI-Rezensenten, Feedback programmatisch zu lesen und zu schreiben.
Nachteile
Komplexe Spezifikationsoberfläche: strenge KV-Schema, Authentifizierungsregeln und UI-Genauigkeitsanforderungen erhöhen die Implementierungs- und Wartungskomplexität.
Produktions-Setup erfordert immer noch Plattformschritte: Die öffentliche Bereitstellung erfordert ein Vercel-Projekt-Setup und eine Upstash-/Vercel-KV-Verbindung (plus Geheimnisverwaltung).
Domänenspezifische Standardwerte: Der Seed ist auf einen bestimmten Workflow zugeschnitten (HTML-Artefakte, Next.js, Vercel KV, NextAuth), der möglicherweise nicht ohne Anpassung zu allen Stacks passt.
Wie verwendet man Almanac Seed
1) Almanac Seed installieren (Plow Seeds CLI Rezept): Ausführen:
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
Dies installiert die Plow Seeds Tools und ruft das Almanac SEED.md Rezept ab.
2) Die SEED.md öffnen und einem Codierungsagenten übergeben: Öffnen Sie die rohe SEED.md in Ihrem Editor oder Browser und fügen Sie sie in Ihren KI-Codierungsagenten (z. B. Claude Code) ein, mit einer Anweisung wie: „Hydrate this seed: build the app it specifies, then run its ## Steps and ## Verify until all 27 §16 journeys pass.“
Hinweis: SEED.md ist eine vollständige Produktspezifikation; sie enthält absichtlich keinen Implementierungscode.
3) Entscheiden Sie, ob Sie eine lokale Verifizierung oder einen echten öffentlichen Einsatz durchführen: Lokaler Build/Verifizierung: Sie können das Bereitstellungsinterview von Schritt 0 überspringen und direkt zu den Build-Schritten gehen (der Seed nennt dies „skip straight to §13.5“).
Öffentlicher Einsatz: Sie müssen zuerst Schritt 0 abschließen (Vercel-Login + Upstash-Speichererstellung/-verbindung), bevor Sie bauen.
4) (Nur öffentlicher Einsatz) Voraussetzungen für Schritt 0 Interview abschließen: Stellen Sie in einem Terminal sicher, dass Node verfügbar ist (>= 18.17) und Vercel CLI installiert ist. Falls Vercel CLI fehlt, installieren Sie es mit einem benutzerbeschreibbaren Präfix:
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
export PATH="$HOME/.npm-global/bin:$PATH"
npm i -g vercel
Dann authentifizieren:
vercel login
Erstellen/verknüpfen Sie das Vercel-Projekt jetzt (Umfang unterscheidet sich für Team vs. Persönlich):
- Team: vercel link --yes --project <your-almanac> --scope <your-team>
- Persönlich: vercel link --yes --project <your-almanac>
Im Vercel-Dashboard erstellen und verbinden Sie eine Upstash for Redis-Datenbank mit diesem Projekt (Storage → Create Database → Upstash for Redis → Connect Project → All Environments).
5) (Nur öffentlicher Einsatz) Produktionsgeheimnisse festlegen (vom Agenten generiertes Passwort): Geheimnisse generieren und festlegen (der Seed gibt an, dass der Agent das Passwort generieren soll; der Benutzer wählt es nicht):
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 NICHT in der Produktion festlegen.
6) Die Build-Schritte des Seeds lokal ausführen (die §13.5 „Steps“ des Seeds): Befolgen Sie die Schritte in SEED.md §13.5, um die App zu hydrieren/bauen. Zusammenfassend weist der Seed den Agenten an:
- Sicherstellen, dass Node >= 18.17
- npm-Abhängigkeiten installieren (npm install)
- Sicherstellen, dass ein cookoff-seeds/ Korpus existiert (Seed erstellt ein Beispiel, falls es fehlt)
- Playwright Chromium + OS-Abhängigkeiten installieren:
npx playwright install --with-deps chromium
- .env.local für die lokale Entwicklung erstellen (einschließlich NEXTAUTH_SECRET, NEXTAUTH_URL=http://localhost:3210, ALMANAC_TEST_LOGIN=1 und Entwicklungsagentenschlüssel)
- Auf Port 3210 bauen und ausführen (npm run build; npm start -p 3210 oder Ähnliches)
7) Die App auf Port 3210 starten und bestätigen, dass sie antwortet: Starten Sie den Server und bestätigen Sie, dass /login geladen wird:
npm run build
npm start
Dann prüfen:
curl -sI http://localhost:3210/login
Erwartet HTTP 200.
8) Lokal ohne Google über die nur für Entwickler verfügbare Test-Login-Route anmelden: Mit ALMANAC_TEST_LOGIN=1 in .env.local öffnen Sie:
http://localhost:3210/api/[email protected]&next=/
Dies erstellt ein NextAuth-Sitzungscookie und leitet Sie zur App weiter (kein Google OAuth für die lokale Verifizierung erforderlich).
9) Die Verifizierungssuite des Seeds ausführen (die §15 „Verify“ / §16 Journeys des Seeds): Führen Sie die Playwright E2E-Suite aus:
npm run e2e
Die Akzeptanzkriterien des Seeds sind die 27 Journeys in §16 (funktionale + visuelle Computed-Style-Assertions). Alle müssen gegen localhost:3210 bestehen.
10) (Optional) Das bereitgestellte Docker Stranger-Testskript verwenden: Wenn Sie eine vollständig isolierte „leere Container“-Verifizierung wünschen, führen Sie das Verify-Skript des Repos aus (erfordert Docker und ein konfiguriertes Claude CLI):
verify/hydrate-and-verify.sh
Es automatisiert den Stranger-Flow in einem node:20-slim Container und gibt ein FINAL_VERIFY-Ergebnis aus.
11) (Nur öffentlicher Einsatz) Auf Vercel bereitstellen (die §13.6 „Deploy“ des Seeds): Nachdem Schritt 0 abgeschlossen ist und Ihre App lokal gebaut wurde, stellen Sie bereit:
vercel deploy --prod
Deaktivieren Sie dann den Vercel Deployment Protection (ssoProtection) über API oder Dashboard (erforderlich, damit /login erreichbar ist). Setzen Sie NEXTAUTH_URL auf die bereitgestellte URL und stellen Sie einmal erneut bereit:
printf '%s' "https://<project>.vercel.app" | vercel env add NEXTAUTH_URL production
vercel deploy --prod
12) (Nur öffentlicher Einsatz) Zugriff mit dem generierten Passwort teilen: Ihr bereitgestellter Almanac verwendet die Passwort-Anmeldung (Credentials-Anbieter). Prüfer melden sich mit einem beliebigen Anzeigenamen + dem generierten ALMANAC_ACCESS_PASSWORD-Passwort an. Bestätigen Sie, dass Kommentare nach dem Neuladen bestehen bleiben (beweist, dass Upstash KV verbunden ist).
Almanac Seed FAQs
Almanac Seed ist eine einzelne Datei namens „SEED.md“, eine Produktspezifikation, die einem KI-Codierungsagenten Anweisungen gibt, wie die vollständige Almanac-App von Grund auf neu erstellt werden kann. Das Repository enthält keinen Anwendungscode – nur das Rezept.
Almanac Seed Video
Beliebte Artikel

Atoms: Eine Multi-Agenten-KI-Plattform, die Ideen in startbereite Produkte verwandelt
May 22, 2026

Nano Banana SBTI: Was es ist, wie es funktioniert und wie man es im Jahr 2026 einsetzt
Apr 15, 2026

Atoms Review – Der KI-Produkt-Builder, der die digitale Erstellung im Jahr 2026 neu definiert
Apr 10, 2026

Kilo Claw: Wie man einen echten "Do-It-For-You" KI-Agenten bereitstellt und verwendet (2026 Update)
Apr 3, 2026







