tomevault-io Bingify Project Guide
Bingifyプロジェクト固有の内部ガイドです。開発を行う際は 必ずこのスキルを参照してください。
クイックスタート
# 環境構築
pnpm install
pnpm local:setup
pnpm dev
# コード品質チェック
pnpm check # Lint + Format
pnpm type-check # TypeScript
pnpm test # テスト
プロジェクト概要
- Framework: Next.js + App Router
- Language: TypeScript
- Styling: Tailwind CSS + shadcn/ui
- Backend: Supabase (Auth, Database)
- Testing: Vitest
- i18n: next-intl (en, ja)
スキルセクション
詳細は references/ 内の各ドキュメントを参照：
参照ガイド
| ファイル | 参照タイミング | 内容 |
|---|---|---|
| authentication.md | ログイン機能実装・認証周りのバグ | Supabase Auth、マジックリンク、OAuth、ミドルウェア保護 |
| code-conventions.md | 日々のコーディング | TypeScriptパターン、shadcn/ui管理、Server Actions |
| form-validation.md | フォーム実装 | Zod + TanStack Form統一パターン、命名規則 |
| github-workflow.md | コミット・PR作成 | Conventional Commits、ブランチ戦略、PRタイトル規約 |
| review-response.md | PRレビュー対応 | 行単位レビューコメント取得、レビュー対応ワークフロー |
| internationalization.md | 多言語対応・i18n実装 | next-intl設定、locale-based routing、メッセージ管理 |
| mailpit-testing.md | メール機能のテスト・確認 | Mailpit UIアクセス、メール送信検証 |
| supabase-setup.md | DB初期化・マイグレーション・RLS | Supabase CLIコマンド、migration管理、RLSポリシー |
| testing.md | ユニットテスト・コード品質 | Vitestパターン、テストファイル配置、Biome使用法 |
| ci-cd.md | CI/CD・GitHub Actions・デプロイ | GitHub Actions設定、ドキュメント編集、デプロイメント |
| debugging.md | バグ調査・デバッグ・ログ確認 | ローカル環境へのアクセス、デバッグツール、よくあるシナリオ |
プロジェクト構造
app/[locale]/ # ページ・レイアウト（i18n対応）
components/ # カスタムコンポーネント
components/ui/ # shadcn/ui（自動生成）
lib/ # ユーティリティ・API・スキーマ
messages/ # i18nメッセージ
docs/ # ドキュメント
外部スキル（汎用）
以下はプロジェクト外からインストールされた汎用スキルです：
- Supabase Postgresベストプラクティス -
.github/skills/supabase-postgres-best-practices/SKILL.md - Reactベストプラクティス -
.github/skills/vercel-react-best-practices/SKILL.md - ウェブデザインガイドライン -
.github/skills/web-design-guidelines/SKILL.md
関連ドキュメント
- AGENTS.md - 開発ガイドライン全体
- CONTRIBUTING.md - 貢献ガイドライン
- docs/STYLE_GUIDE.md - 表記ルール
- docs/GLOSSARY.md - 用語定義
Converted and distributed by TomeVault — claim your Tome and manage your conversions.