project-naming
プロジェクト全域の命名規則。ディレクトリ、ファイル、コード内の全ルールを網羅した唯一の正解（SSoT）。
When & Why to Use This Skill
This Claude skill serves as the Single Source of Truth (SSoT) for project-wide naming conventions. It provides a comprehensive framework for naming directories, files, and code elements (variables, functions, classes), ensuring absolute consistency across the development lifecycle. By centralizing these rules, it eliminates ambiguity, streamlines collaboration, and enhances codebase maintainability for modern web development stacks like Next.js.
Use Cases
- Standardizing Project Structure: Automatically applying kebab-case for directories and specific naming patterns for Next.js system files (page.tsx, layout.tsx) to maintain a clean architecture.
- Component and Logic Organization: Differentiating between shadcn/ui components (kebab-case) and custom PascalCase components, while enforcing strict suffixes for Hooks, Services, and Actions.
- Code-Level Consistency: Aligning team members on the use of PascalCase for types/interfaces, camelCase for functions/variables, and UPPER_SNAKE_CASE for global constants to improve readability.
- Onboarding and Code Reviews: Providing an instant reference for new developers and a benchmark for automated or manual code reviews to prevent naming debt.
| name | project-naming |
|---|---|
| description | プロジェクト全域の命名規則。ディレクトリ、ファイル、コード内の全ルールを網羅した唯一の正解（SSoT）。 |
プロジェクト命名規則
このスキルは、プロジェクトにおけるすべての命名の「唯一の正解 (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で常に内容を同期させます。 - 命名に迷った場合、ドキュメントではなくこのスキルの定義を優先してください。