code-naming

Installation
SKILL.md

Code Naming

名前の目的は、利用者が対象を正しく識別できることである。最短の名前や、宣言元でだけ自然な名前を目標にしない。実際の参照箇所で必要な意味を保ち、そこですでに明らかな語だけを削る。

1. 追加する前に既存の構造を調べる

新規ファイルやシンボルを作る前に、影響する実コードの責務・同階層・利用側を読む。既存の所有者への統合や境界の再配置を先に評価し、似た名前のファイルを横へ増やしてからリファクタリングする進め方を完成としない。

新規実装・追加・変更・レビュー・リネームでは、判断に必要な範囲で確認する。

  • repositoryの既存規約、対象言語・frameworkの命名制約、隣接する名前
  • 対象の責務・実際の値や振る舞い・同階層で区別すべき概念と既存の所有者
  • 変更するdirectoryの兄弟entry、近接する階層、似た名前と責務の重複・細片化
  • 宣言元だけでなく、representativeな参照箇所とimport / export形態
  • 公開API、schema、永続化データ、CLI、file pathなど、名前が外部契約になっているか

2. 名前を評価する

以下を満たす最小限の情報で命名する。

Installs
11
GitHub Stars
2
First Seen
Oct 29, 2026