Cursor エディタ 設定ガイド for 日本人エンジニア

# 基本設定 - 日本語での応答を優先する - コードには適切なコメントを日本語で付ける - エラーメッセージの解説は詳細に行う - コーディング規約に従ったコード生成を行う # コード品質 - DRY (Don't Repeat Yourself) 原則に従う - KISS (Keep It Simple, Stupid) 原則を守る - 変数名やメソッド名は日本語の意味を英語に適切に翻訳して命名する - コメントは機能説明に重点を置き、冗長にしない # 開発効率 - 実装前に設計の概要を示す - テストコードも一緒に提案する - エラー発生時は具体的な解決策を複数提示する - リファクタリングの際は変更理由と改善点を明示する # 学習サポート - 使用している技術やライブラリの最新ベストプラクティスを提案する - コード生成時には実装の解説も行う - より効率的な実装方法がある場合は代替案も提示する - 新しい技術やパターンを使う際は簡潔な説明を加える # プロジェクト管理 - コミットメッセージの提案はプロジェクト規約に沿った形式で行う - PRの説明文も自動生成できるようにする - 実装に時間がかかりそうな箇所は事前に指摘する # 常に最後に日本語で応答すること

## Python Guidelines - Follow PEP 8 style guidelines - Use type hints for function parameters and return values - Prefer list/dict comprehensions over loops when appropriate - Document functions with docstrings using Google or NumPy style - Use meaningful exception handling with specific exception types - Structure projects with clear module organization

## TypeScript/Next.js Guidelines - Use Next.js 14.2.23 with App Router architecture - Organize code by features or domains rather than by file types - Leverage TypeScript's type system fully - avoid using 'any' type - Follow the official Next.js patterns for data fetching and routing ### Component Structure - Use functional components with hooks - Separate UI components from logic/data-fetching components - Create reusable components in a shared component library - Follow component naming convention: `ComponentName/index.tsx` with optional `ComponentName/ComponentName.module.css` ### Styling - Use Tailwind CSS for styling following utility-first approach - Group Tailwind classes logically: layout, sizing, typography, colors - IMPORTANT: Avoid using Grid components directly - use Box components instead for layouts - For complex UI components, use either MUI or Headless UI (prefer Headless UI for better UX) ### Form Handling - Use React Hook Form for all form implementations - Implement validation schemas with Zod - Structure form validations consistently - Handle form errors with clear user feedback ### State Management - Use Zustand for global state management - Keep state minimal and focused - Split stores by domain when appropriate - Use React Query for server state management

# Python & TypeScript スタック向け Cursor Rules (英語版) ## General Coding Guidelines - Follow clean code principles across all languages - Use descriptive variable names that explain their purpose - Comment complex logic or business rules - Follow DRY (Don't Repeat Yourself) principles - Write unit tests for all core functionality ## Python Guidelines - Follow PEP 8 style guidelines - Use type hints for function parameters and return values - Prefer list/dict comprehensions over loops when appropriate - Document functions with docstrings using Google or NumPy style - Use meaningful exception handling with specific exception types - Structure projects with clear module organization ## TypeScript/Next.js Guidelines - Use Next.js 14.2.23 with App Router architecture - Organize code by features or domains rather than by file types - Leverage TypeScript's type system fully - avoid using 'any' type - Follow the official Next.js patterns for data fetching and routing ### Component Structure - Use functional components with hooks - Separate UI components from logic/data-fetching components - Create reusable components in a shared component library - Follow component naming convention: `ComponentName/index.tsx` with optional `ComponentName/ComponentName.module.css` ### Styling - Use Tailwind CSS for styling following utility-first approach - Group Tailwind classes logically: layout, sizing, typography, colors - IMPORTANT: Avoid using Grid components directly - use Box components instead for layouts - For complex UI components, use either MUI or Headless UI (prefer Headless UI for better UX) ### Form Handling - Use React Hook Form for all form implementations - Implement validation schemas with Zod - Structure form validations consistently - Handle form errors with clear user feedback ### State Management - Use Zustand for global state management - Keep state minimal and focused - Split stores by domain when appropriate - Use React Query for server state management ### Performance Considerations - Implement proper code-splitting with Next.js - Use Next.js Image component for optimized images - Properly memoize components and callbacks where appropriate - Implement proper loading states and error boundaries ## Response Preferences - Provide detailed explanations for any implementation decisions - When suggesting improvements, explain the reasoning - Always include code examples when explaining concepts - Respond in Japanese with UTF-8 encoding

# Python & TypeScript スタック向け Cursor Rules (日本語版) ## 一般的なコーディングガイドライン - すべての言語でクリーンコードの原則に従う - 変数名は目的を説明する説明的な名前を使用する - 複雑なロジックやビジネスルールにはコメントを付ける - DRY（同じことを繰り返さない）原則に従う - すべての主要機能に単体テストを書く ## Pythonガイドライン - PEP 8スタイルガイドラインに従う - 関数のパラメータと戻り値に型ヒントを使用する - 適切な場合はループよりリスト/辞書内包表記を優先する - GoogleまたはNumPyスタイルを使用して関数をdocstringsでドキュメント化する - 特定の例外タイプを使用した意味のある例外処理を実装する - 明確なモジュール構成でプロジェクトを構造化する ## TypeScript/Next.jsガイドライン - Next.js 14.2.23（App Router）アーキテクチャを使用する - ファイルタイプではなく、機能やドメインでコードを整理する - TypeScriptの型システムを最大限に活用し、'any'型の使用を避ける - データフェッチングとルーティングには公式のNext.jsパターンに従う ### コンポーネント構造 - フック付きの関数コンポーネントを使用する - UIコンポーネントとロジック/データフェッチングコンポーネントを分離する - 共有コンポーネントライブラリで再利用可能なコンポーネントを作成する - コンポーネント命名規則に従う：`ComponentName/index.tsx`（オプションで`ComponentName/ComponentName.module.css`） ### スタイリング - ユーティリティファーストアプローチでTailwind CSSを使用する - Tailwindクラスを論理的にグループ化：レイアウト、サイズ調整、タイポグラフィ、色 - 重要：Gridコンポーネントを直接使用せず、代わりにレイアウトにはBoxコンポーネントを使用する - 複雑なUIコンポーネントには、MUIまたはHeadless UI（より良いUXにはHeadless UIを推奨）を使用する ### フォーム処理 - すべてのフォーム実装にはReact Hook Formを使用する - Zodでバリデーションスキーマを実装する - フォームバリデーションを一貫した構造で実装する - 明確なユーザーフィードバックでフォームエラーを処理する ### 状態管理 - グローバル状態管理にはZustandを使用する - 状態は最小限かつ焦点を絞ったものにする - 適切な場合はドメインごとにストアを分割する - サーバー状態管理にはReact Queryを使用する ### パフォーマンスの考慮事項 - Next.jsで適切なコード分割を実装する - 最適化された画像にはNext.js Imageコンポーネントを使用する - 適切な場所でコンポーネントとコールバックをメモ化する - 適切なローディング状態とエラー境界を実装する ## 応答の設定 - 実装の決定に関する詳細な説明を提供する - 改善案を提案する際は、理由を説明する - 概念を説明する際は常にコード例を含める - 日本語（UTF-8エンコーディング）で応答する