naming-rule · git:20260427.cc366ee · 2026-04-27 · sha256 3a2ab2d0f7fecab2

naming-rule git:20260427.cc366eeA

Immutable. This exact content never changes and is served at /api/v1/blob/3a2ab2d0f7fecab2.

---
name: naming-rule
description: General naming rules across programming languages. Avoid meaningless words like `common` or `util`, and prefer singular base forms. Use when creating or reviewing names of files, directories, modules, functions, or variables.
user-invocable: false
---

# 命名規則

## 意味のない単語の使用禁止

以下の要素、

- ファイル名
- ディレクトリ名
- モジュール名
- 関数名
- 変数名

などに`common`や`util`のような意味のない単語を使うのは禁止します。
それらの単語は乱用されていて意味がなくなっており、見ても何の意味を持っているのか分からないから。

変数名に`result`のような意味のない名前を使うのは禁止します。
その変数名に何を保存しているのか意味のある名前を付けてください。
実際に`Result`型の関連処理を行っている場合などは仕方ないですが。

## 原形の単数の利用の推奨

モジュール名や型の名前は、原形の単数形式を使うことを推奨します。
むやみに複数形を使うのは禁止。

変数の場合でも複数形よりも、もっと性質を表す名前を使うことを推奨します。