プロジェクト命名規則
このスキルは、プロジェクトにおけるすべての命名の「唯一の正解 (Single Source of Truth)」を定義します。常にこの規約を守ってください。
命名規則ガイドライン
1. ディレクトリ命名
- •原則: すべて
kebab-case(例:business-info/,api/line-oauth/,src/server/actions/)
2. ファイル命名 (接尾辞・ケースの徹底)
- •Next.js 固定名:
page.tsx,layout.tsx,route.ts,error.tsx,loading.tsx,not-found.tsx,template.tsx - •コンポーネント:
- •shadcn/ui:
kebab-case.tsx(例:button.tsx,avatar.tsx) - •カスタム:
PascalCase.tsx(例:ChatClient.tsx,CanvasPanel.tsx)
- •shadcn/ui:
- •実装ファイル (論理命名/ドメイン系):
- •Hooks:
camelCase.ts(例:useChatSession.ts) - •Services:
...Service.ts(例:chatService.ts,supabaseService.ts) - •Actions:
...actions.ts(例:user.actions.ts) - •Middleware:
...middleware.ts(例:auth.middleware.ts) - •Schemas:
...schema.ts(例:brief.schema.ts) - •Models:
...Models.ts(例:chatModels.ts)
- •Hooks:
- •その他 (物理命名/モジュール系):
- •Types:
kebab-case.ts(例:chat.ts,analytics.ts) - •Lib/Utils:
kebab-case.ts(例:client-manager.ts,blog-canvas.ts)
- •Types:
3. コード内命名
- •React コンポーネント / クラス / 型 / インターフェース / Enum:
PascalCase - •関数・メソッド / 変数 / パラメータ:
camelCase - •定数 (グローバル・設定):
UPPER_SNAKE_CASE(例:MODEL_CONFIGS,ERROR_MESSAGES)
運用ルール
- •このファイルを絶対的な基準とし、
.claudeと.codexで常に内容を同期させます。 - •命名に迷った場合、ドキュメントではなくこのスキルの定義を優先してください。