pocketlantern

PocketLantern

AI エージェントは自信たっぷりに答えます。しかし、障害となる要因を見落としています。

価格は変動し、バージョンアップで互換性が失われ、ライセンスも変更されます。PocketLantern は、ソースへのリンク付きで時間とともに変化する事実に基づき、障害要因を考慮した意思決定レイヤーを AI コーディングエージェントに提供します。

次の質問を試してみましょう

PocketLantern をインストールした後、AI エージェントに質問してください。

「認証プロバイダーは Clerk、Auth0、Cognito のどれがよいですか？」

⚠️ Cognito password hashes are permanently non-exportable
⚠️ Auth0 password export requires support ticket — Free tier excluded
⚠️ Auth0 Rules/Hooks EOL 2026-11-18 — Actions not portable
✅ Clerk has the most flexible migration path

「Next.js 16 にアップグレードすべきですか？」

⚠️ Sync API access fully removed — all dynamic calls must be awaited
⚠️ Custom webpack config breaks next build
⚠️ next lint removed — switch to Biome or ESLint CLI
⚠️ Requires Node.js 20.9.0+, TypeScript 5.1.0+, React 19.0+
✅ Plan phased migration — codemod doesn't cover webpack or middleware

「OpenAI Realtime API は使えますか？」

⚠️ gpt-4o-realtime-preview removed 2026-05-07
⚠️ Beta interface (realtime=v1 header) removed same date
⚠️ GA event schema incompatible — 4 event renames
✅ Start on GA from day one — or plan dual-stack migration

3つの質問。3種類の障害要因。同じ AI でも、事実はそれぞれ異なります。

クイックスタート

前提条件：Node.js >= 22、MCP クライアント（Claude Code、Cursor など）

npm install -g pocketlantern

Claude Code

プロジェクトディレクトリで次を実行します。

cd your-project
pocketlantern init

init は MCP サーバーを ~/.claude.json に登録し、プロジェクトの CLAUDE.md に1行のルールを追加します。Claude Code を再起動し（Ctrl+C を押してから、もう一度 claude を実行します）、最初の質問をしてみましょう。

Cursor / Windsurf / その他の MCP クライアント

MCP 設定に追加します（Cursor の場合：~/.cursor/mcp.json）。

{
  "mcpServers": {
    "pocketlantern": {
      "command": "pocketlantern-mcp"
    }
  }
}

次に、プロジェクトのルール（.cursorrules、Kiro のステアリングファイルなど）に次の1行を追加します。

For technology decisions, upgrades, migrations, or licensing questions: before finalizing your answer, check the PocketLantern MCP server's search_cards tool for blockers in these bundled decision cards — your training data may be stale.

MCP サーバーを再読み込みします。Cursor の場合は、Cmd+Shift+P ->「MCP: Restart Servers」を実行します。Windsurf の場合は、エディターを再起動します。

さらに試せる質問

4. 「Fluid Compute によって Vercel の料金体系はどう変わりましたか？」 課金は Active CPU と Memory に分割され、共有プロセスでの並行処理によって分離が損なわれます

5. 「Edge／サーバーレスには Prisma と Drizzle のどちらがよいですか？」 Prisma v7 は ESM とドライバーアダプターで破壊的変更があり、Edge はプレビュー版のみです。Drizzle 0.30-1.0 にも破壊的変更があります

インストールの確認

pocketlantern doctor               # check installation status
pocketlantern search "auth pricing" # search cards from CLI

仕組み

PocketLantern は MCP サーバーです。AI エージェントは search_cards を呼び出し、ソースへのリンク付き意思決定カードと、利用可能な場合はソースへのリンク付きの障害要因に関する警告を取得します。

Agent asks question
  -> search_cards("clerk vs auth0 authentication")
  -> 3 cards + 5 blocker warnings (lock-in, EOL, export restrictions)
  -> Agent answers with source-linked constraints

ローカルのカードセットによる即時検索。ベクトルデータベースも、埋め込みも不要です。キーワード検索、カードへのリンク、利用可能な場合はソースへのリンク付きの障害要因に関する警告を提供します。価値の中心は、巧妙な検索だけではなく、ソースへのリンク付き意思決定カードです。

search_cards("auth", constraints:["serverless"]) -> cards + blockers
get_card("auth/clerk-vs-auth0-vs-cognito-2026")  -> full card with facts
get_related_cards(...)                           -> connected topics

含まれる内容

27カテゴリにわたる、障害要因を考慮した意思決定カードに加え、同梱のグラフインデックスからソースへのリンク付きの障害要因に関する警告を提供します。npm パッケージに含まれており、ネットワーク接続もアカウントも不要ですぐに使えます。

カテゴリ	対象
auth	ベンダーロックイン、移行の負担、SSO、RBAC、パスキー
frontend	Next.js、React、Svelte、Vite、Angular のアップグレードに伴う障害要因
database	Prisma、Drizzle、Postgres、Aurora、Neon、Supabase
ai	OpenAI API の移行、モデルの料金、バッチ処理とストリーミング
serverless	Vercel、Cloudflare Workers、Lambda のコストとランタイム
infra	ホスティングプラットフォーム、Terraform、Node.js LTS、Python EOL
backend	Supabase と Firebase の比較、Express、ジョブキュー、リアルタイム同期
+ 18 more	デプロイ、開発ツール、テスト、セキュリティ、コンプライアンスなど

カードの例

各カードは、ソースへのリンク付きの事実と公式リファレンスへのリンクを含む、構造化された YAML ファイルです。

id: auth/clerk-vs-auth0-vs-cognito-2026
title: Clerk vs Auth0 vs Cognito Under Current Pricing and Feature Changes
problem: Select an auth vendor given recent pricing shifts, MAU economics, ...
constraints: [cost-sensitive, low-ops, enterprise, compliance, serverless]
candidates:
  - name: Clerk
    summary: "Pro starts at $20/mo, includes 50,000 MRUs per app..."
    when_to_use: "Choose for small-team + low-ops + cost-sensitive SaaS..."
    tradeoffs: "Best DX and fastest implementation..."
    cautions: "Be precise about org-member limits..."
    links:
      - https://clerk.com/pricing
      - https://clerk.com/docs/guides/organizations/configure
  - name: Auth0
    # ...
  - name: Amazon Cognito
    # ...
tags: [auth, clerk, auth0, pricing, passkeys, b2b, compliance]
related_cards: [auth/sso-for-b2b-saas, auth/rbac-vs-abac-vs-rebac]
updated: 2026-03-14

スキーマ定義の全容については、packages/schema/src/card.ts を参照してください。

プロジェクト構成

pocketlantern/
  packages/schema/       <- Card schema (zod + TypeScript types)
  apps/mcp-server/       <- MCP server (search, retrieval, tool handlers)
  apps/cli/              <- CLI (validate, search, init, doctor)
  packages/knowledge/    <- Decision cards + graph index (data package)
  docs/                  <- User guides & roadmap

モノレポ：pnpm ワークスペースです。ビルド順序は schema -> knowledge (no build) -> mcp-server -> cli です。

開発

pnpm build              # Build all packages
pnpm test               # Run tests (299 tests)
pnpm test:coverage      # Run with coverage report
pnpm lint               # ESLint
pnpm format:check       # Prettier check

トピックが見つかりませんか？カードリクエストで対応をリクエストしてください。

コントリビューション

ツール（スキーマ、MCP サーバー、CLI、検索）へのコントリビューションを歓迎します。ガイドラインについては、CONTRIBUTING.mdをご覧ください。

ライセンス

MIT