| name | project-naming |
| description | プロジェクト全域の命名規則。ディレクトリ、ファイル、コード内の全ルールを網羅した唯一の正解(SSoT)。 |
| metadata | [object Object] |
プロジェクト命名規則
このスキルは、プロジェクトにおけるすべての命名の「唯一の正解 (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で常に内容を同期させます。 - 命名に迷った場合、ドキュメントではなくこのスキルの定義を優先してください。