🐱 ネコノテAI（第二期）

小説をはじめとする長文（技術書などの解説書を含む）の執筆を支援するWebアプリ。作品そのものは人間が執筆し、AIはペルソナを持つエージェント（担当編集・校正さん・アシスタント等）として、構想のネタ出し・企画レビュー・構成設計・校正の各フェーズに伴走する。原稿の実体はGitHubリポジトリで管理し、本アプリはレビューと進捗管理に専念する。

主な機能

• ペルソナ制AIレビュー: 企画書・構成・原稿を、役割の異なるAIエージェントがレビュー（Anthropic / OpenAI / Google をマルチプロバイダで呼び分け）
• 手帳（ノート）: ネタ・設定を貯める自由記述ノート＋タグ・テンプレート・版履歴
• ビートボード / 目次ボード: 章・シーン単位の構成管理と進捗集計（小説は6種の構成テンプレート、技術書等は目次形式）
• 原稿連携: GitHub上の原稿リポジトリを読み書き（校正・全体校正の書き戻し・Webエディタ・縦書き／横書き（技術書）の組版プレビュー・Vivliostyleによる入稿PDF/EPUB/電子配布用PDFビルド）
• 対話型ペルソナ: 構想の壁打ちと執筆スケジュールの提案・管理（締切リマインドメール付き）
• アトリエ: 表紙・挿絵・キャラクター・コンセプトアートのイラスト生成
• Zenn連携: Zenn記事リポジトリへの直接執筆・投稿

技術スタック

• Next.js（App Router）+ TypeScript（strict）
• UI: shadcn/ui + Tailwind CSS
• DB/認証: Supabase（PostgreSQL + Auth、全テーブルRLS）
• AI: Vercel AI SDK
• デプロイ: Vercel

重要な設計前提

本アプリは単一ユーザー（もしくはごく少人数の許可リスト制）での運用を前提としている。

• 認証はメール許可リストのフェイルクローズ2層ゲート（環境変数＋DBテーブル）。リストが空なら誰もログインできない
• レートリミットはインメモリ方式で、サーバーレスのインスタンス間では共有されない
• 不特定多数向けサービスとして運用する場合は上記の見直しが必要（SECURITY.md 参照）

セットアップ

1. Supabase プロジェクトの作成とマイグレーション適用

Supabase でプロジェクトを作成し、CLIでリンクしてマイグレーションを適用する。

npx supabase link --project-ref <your-project-ref>
npx supabase db push

注意: supabase/migrations/20260712000001_auth_allowlist.sql の許可リスト投入行はコメントアウトされている。適用前に自分のメールアドレスへ書き換えるか、適用後に Supabase の SQL Editor から insert into private.auth_allowlist (email) values ('[email protected]'); を実行すること（未投入だと全サインアップが拒否される）。

あわせて Supabase Dashboard で Google OAuth プロバイダを設定する（詳細は docs/SPEC-auth.md）。

2. 環境変数の設定

cp .env.local.example .env.local

変数	用途
NEXT_PUBLIC_SUPABASE_URL / NEXT_PUBLIC_SUPABASE_ANON_KEY	Supabase 接続情報
ALLOWED_EMAILS	ログインを許可するメール（カンマ区切り。DB側許可リストと手動同期）
ANTHROPIC_API_KEY / OPENAI_API_KEY / GOOGLE_GENERATIVE_AI_API_KEY	AIプロバイダのAPIキー（使うものだけでよい）
ENCRYPTION_KEY	GitHub PAT の暗号化キー（32バイトのbase64。再発行不能）
SUPABASE_SERVICE_ROLE_KEY	cron（締切リマインド）用。クライアントへ露出しないこと
RESEND_API_KEY / REMINDER_FROM_EMAIL / CRON_SECRET	リマインドメール送信と cron 認証

3. 起動

npm install
npm run dev

postinstall で Vivliostyle Viewer が public/vivliostyle/ へコピーされる（縦書きプレビュー用）。

検証コマンド

npm run typecheck
npm run lint
npm run format:check

整形崩れは npm run format で直す（リントは prettier を見ないため、format:check でしか検出できない。CI でも3つとも実行される）。

ドキュメント

• 変更履歴（CHANGELOG）
• ユーザーマニュアル
• 運用ランブック（RUNBOOK）
• 既存の原稿リポジトリの更新ガイド
• 要求仕様
• 実装計画
• 機能仕様の索引（SPEC-index.md）
• Claude Code 運用計画
• 開発ログ
• 開発記録（書籍ドラフト）
• 第一期・第二期の比較と KPT
• 第三期引き継ぎメモ

ライセンス

MIT