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を開き、「このシードをハイドレートしてください。指定されたアプリを構築し、すべての27の§16ジャーニーが合格するまで、その## Stepsと## Verifyを実行してください。」のような指示とともにAIコーディングエージェント（例：Claude Code）に貼り付けます。 注：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 <your-almanac> --scope <your-team> - 個人：vercel link --yes --project <your-almanac> Vercelダッシュボードで、このプロジェクトにRedis用Upstashデータベースを作成して接続します（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」）: SEED.md §13.5のステップに従って、アプリをハイドレート/ビルドします。要約すると、シードはエージェントに以下を指示します。 - Node >= 18.17であることを確認する - npm依存関係をインストールする（npm install） - cookoff-seeds/コーパスが存在することを確認する（存在しない場合はシードが例を作成する） - Playwright Chromium + OS依存関係をインストールする。 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なしでローカルでサインインする: .env.localにALMANAC_TEST_LOGIN=1を設定して、以下を開きます。 http://localhost:3210/api/[email protected]&next=/ これにより、NextAuthセッションクッキーが発行され、アプリにリダイレクトされます（ローカル検証にはGoogle OAuthは不要です）。

9) シードの検証スイートを実行する（シードの§15「Verify」/ §16ジャーニー）: Playwright E2Eスイートを実行します。 npm run e2e シードの受け入れ基準は、§16の27のジャーニー（機能的 + 視覚的な計算スタイルアサーション）です。これらはすべてlocalhost:3210に対して合格する必要があります。

10) （オプション）提供されているDocker stranger-testスクリプトを使用する: 完全に隔離された「空白コンテナ」検証が必要な場合は、リポジトリの検証スクリプトを実行します（Dockerと設定済みのclaude CLIが必要です）。 verify/hydrate-and-verify.sh これにより、node:20-slimコンテナでstrangerフローが自動化され、FINAL_VERIFY結果が出力されます。

11) （公開デプロイのみ）Vercelにデプロイする（シードの§13.6「Deploy」）: ステップ0が完了し、アプリがローカルでビルドされたら、デプロイします。 vercel deploy --prod 次に、APIまたはダッシュボードを介してVercel Deployment Protection（ssoProtection）を無効にします（/loginにアクセスできるようにするために必要です）。NEXTAUTH_URLをデプロイされたURLに設定し、一度再デプロイします。 printf '%s' "https://<project>.vercel.app" | vercel env add NEXTAUTH_URL production vercel deploy --prod

12) （公開デプロイのみ）生成されたパスフレーズを使用してアクセスを共有する: デプロイされたAlmanacはパスフレーズログイン（Credentialsプロバイダー）を使用します。レビュー担当者は、任意の表示名と生成されたALMANAC_ACCESS_PASSWORDパスフレーズでサインインします。コメントがリロード後も保持されることを確認します（Upstash KVが接続されていることを証明します）。