@book000/eslint-config 1.15.43 → 1.15.44

package/.github/copilot-instructions.md

@@ -1,82 +1,42 @@
-# GitHub Copilot Instructions
+# GitHub Copilot レビュー指示
 
-## プロジェクト概要
+`@book000/eslint-config` は npm に公開される共有 ESLint flat config パッケージです。
+コードレビュー時は以下の観点を優先してください。
 
-- 目的: 個人用 ESLint 設定を提供するパッケージ
-- 主な機能: ESLint flat config に基づいた TypeScript / JavaScript プロジェクト向けのルール定義
-- 対象ユーザー: book000 の個人プロジェクト開発者
+## リポジトリ構成
 
-## 共通ルール
+- `index.mjs`: 公開される ESLint flat config 本体 (エントリポイント)。
+- `test.mjs`: `index.mjs` のルール挙動を検証するカスタムテストスクリプト。
+- 実行環境: pnpm 11.10.0 / ESM (`.mjs`)。
 
-- 会話は日本語で行う。
-- コミットメッセージは [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) に従う。`<description>` は日本語で記載。
-- ブランチ命名は [Conventional Branch](https://conventional-branch.github.io) に従う。`<type>` は短縮形 (feat, fix) を使用。
-- 日本語と英数字の間には半角スペースを入れる。
-
-## 技術スタック
-
-- 言語: JavaScript (ES Modules), TypeScript (設定対象)
-- ESLint: Flat Config (eslint.config.mjs 形式)
-- パッケージマネージャー: pnpm (10.28.1)
-- 主要パッケージ:
-  - typescript-eslint
-  - eslint-plugin-unicorn
-  - neostandard
-  - eslint-config-prettier
-
-## コーディング規約
-
-- フォーマット: Prettier との統合 (eslint-config-prettier)
-- コメント言語: 日本語
-- エラーメッセージ: 英語
-- TypeScript の `skipLibCheck` での回避は禁止
-- 関数・インターフェースには docstring (JSDoc など) を日本語で記載
-
-## 開発コマンド
-
-```bash
-# 依存関係のインストール
-pnpm install
+## 重点的に確認する点
 
-# テスト実行
-pnpm test
-```
+- **ルール変更には必ずテストを伴うこと**: `index.mjs` のルールを追加・変更する PR で
+  `test.mjs` の `testCases` にケースが追加・更新されていない場合は指摘する。
+- **flat config の配列順序**: flat config は「後勝ち」。`eslintPrettier` は必ず配列末尾に
+  置くこと。`unicorn/filename-case` のような後段オーバーライドの順序が入れ替わっていないか
+  確認する。
+- **公開パッケージとしての破壊的変更**: ルールの追加・厳格化は利用側プロジェクトに影響する。
+  破壊的変更に見合うバージョニング (Conventional Commits の `feat!:` / `fix:` など) が
+  適切か確認する。
+- **コメント**: `index.mjs` の各ルール調整には「なぜ off / 変更したか」の日本語コメントを
+  付ける慣習がある。理由コメントなしのルール変更は指摘する。
 
-## テスト方針
+## フラグすべきでない既知パターン (誤検知防止)
 
-- テストフレームワーク: Node.js の exec を使用したカスタムテストスクリプト (test.mjs)
-- テストコマンド: `pnpm test`
-- テスト追加: ESLint ルールの動作検証を追加する場合、test.mjs の testCases 配列に新しいケースを追加
+- **意図的に off / 緩和されているルール**: このパッケージは設計方針として
+  `@typescript-eslint/no-explicit-any`・`no-unsafe-assignment`・`no-unsafe-argument`・
+  `unicorn/prevent-abbreviations`・`unicorn/no-null`・`unicorn/prefer-top-level-await` などを
+  意図的に off にしている。これらを「有効化すべき」と指摘しない。
+- **`index.mjs` 内の `@ts-expect-error`**: `unicorn.configs["flat/recommended"]` の型不整合を
+  回避するための意図的な記述。削除を促さない。
+- **`test.mjs` が生成する一時ファイル**: テストは一時的に `src/__tmp__cli` と `tsconfig.json` を
+  作成して ESLint を実行する。この一時生成物を問題として扱わない。
 
-## セキュリティ / 機密情報
+## コーディング規約 (lint / 慣習で強制)
 
-- API キーや認証情報を Git にコミットしない。
-- ログに個人情報や認証情報を出力しない。
-
-## ドキュメント更新
-
-変更時に以下のドキュメントを更新すること：
-
-- `README.md`: パッケージの使用方法、インストール手順
-- `index.mjs`: ESLint ルール設定の変更時
-- `test.mjs`: テストケースの追加・変更時
-
-## リポジトリ固有
-
-- このパッケージは npm に公開される共有可能な ESLint 設定です。
-- index.mjs が ESLint flat config のエントリポイントです。
-- TypeScript プロジェクト向けに `files: ["**/*.ts", "**/*.tsx"]` で TypeScript 専用ルールを適用しています。
-- 以下のルールが特別に調整されています：
-  - `@typescript-eslint/no-explicit-any`: off (any 型の使用を許可)
-  - `@typescript-eslint/no-unsafe-assignment`: off (危険な代入を許可)
-  - `@typescript-eslint/no-unsafe-argument`: off (危険な引数を許可)
-  - `@typescript-eslint/restrict-template-expressions`: テンプレート式で number, boolean, any, nullish を許可
-  - `@typescript-eslint/no-floating-promises`: void 演算子と即時関数での Promise を許可
-  - `@typescript-eslint/no-unnecessary-condition`: 定数ループ条件 (無限ループ) を許可
-  - `@typescript-eslint/no-extraneous-class`: 名前空間として使用されるクラスを許可
-  - `@typescript-eslint/no-use-before-define`: TypeScript 準拠に変更
-  - `unicorn/prefer-top-level-await`: off (トップレベル await を許可)
-  - `unicorn/prevent-abbreviations`: off (省略形を許可)
-  - `unicorn/no-null`: off (null を許可)
-  - `unicorn/no-useless-undefined`: off (無駄な undefined を許可)
-- Renovate による依存パッケージの自動更新が有効です。
+- コメント: 日本語。エラーメッセージ: 英語。
+- 日本語と英数字の間には半角スペースを入れる。
+- `skipLibCheck` による TypeScript エラー回避は禁止。
+- コミットメッセージは [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)
+  (`<description>` は日本語)。

package/CLAUDE.md

@@ -47,35 +47,6 @@
 - TypeScript プロジェクトにおいて、skipLibCheck を有効にして回避することは絶対にしてはならない
 - 関数やインターフェースには、docstring (JSDoc など) を日本語で記載・更新する
 
-## 相談ルール
-
-Codex CLI や Gemini CLI の他エージェントに相談することができます。以下の観点で使い分けてください：
-
-### Codex CLI (ask-codex)
-
-- 実装コードに対するソースコードレビュー
-- 関数設計、モジュール内部の実装方針などの局所的な技術判断
-- アーキテクチャ、モジュール間契約、パフォーマンス / セキュリティといった全体影響の判断
-- 実装の正当性確認、機械的ミスの検出、既存コードとの整合性確認
-
-### Gemini CLI (ask-gemini)
-
-- SaaS 仕様、言語・ランタイムのバージョン差、料金・制限・クォータといった、最新の適切な情報が必要な外部依存の判断
-- 外部一次情報の確認、最新仕様の調査、外部前提条件の検証
-
-### 指摘への対応ルール
-
-他エージェントが指摘・異議を提示した場合、Claude Code は必ず以下のいずれかを行う。黙殺・無言での不採用は禁止する：
-
-- 指摘を受け入れ、判断を修正する
-- 指摘を退け、その理由を明示する
-
-以下は必ず実施：
-
-- 他エージェントの提案を鵜呑みにせず、その根拠や理由を理解する
-- 自身の分析結果と他エージェントの意見が異なる場合は、双方の視点を比較検討する
-- 最終的な判断は、両者の意見を総合的に評価した上で、自身で下す
-
 ## 開発コマンド
 
 ```bash
@@ -182,8 +153,11 @@ pnpm test
   - `@typescript-eslint/no-extraneous-class`: 名前空間として使用されるクラスを許可
   - `@typescript-eslint/no-use-before-define`: TypeScript 準拠に変更
   - `unicorn/prefer-top-level-await`: off (トップレベル await を許可)
+  - `unicorn/consistent-class-member-order`: off (private before public を強制せず public-first の慣習を許可)
   - `unicorn/prevent-abbreviations`: off (省略形を許可)
   - `unicorn/no-null`: off (null を許可)
   - `unicorn/no-useless-undefined`: off (無駄な undefined を許可)
+  - `unicorn/catch-error-name`: catch のエラー変数名を `error` に統一 (`err` も許可)
+  - `unicorn/filename-case`: `checkDirectories: false` でディレクトリ名チェックを無効化し、`__xxx__` 形式は対象外。`.vue` ファイルのみ pascalCase を適用
 - Renovate による依存パッケージの自動更新が有効です。Renovate の PR には追加コミットや更新を行わないこと。
 - テスト (test.mjs) は、一時的に `src/__tmp__cli` ディレクトリと `tsconfig.json` を作成して ESLint を実行します。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@book000/eslint-config",
-  "version": "1.15.43",
+  "version": "1.15.44",
   "description": "ESLint config",
   "keywords": [
     "eslint-config"

package/AGENTS.md

@@ -1,70 +0,0 @@
-# AI エージェント作業方針
-
-## 目的
-
-このドキュメントは、一般的な AI エージェントがこのプロジェクトで作業する際の共通の作業方針を定義します。
-
-## 基本方針
-
-- 会話言語: 日本語
-- コメント言語: 日本語
-- エラーメッセージ言語: 英語
-- コミット規約: [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) に従う (`<description>` は日本語)
-- 日本語と英数字の間: 半角スペースを挿入
-
-## 判断記録のルール
-
-判断は必ずレビュー可能な形で記録すること：
-
-1. 判断内容の要約
-2. 検討した代替案
-3. 採用しなかった案とその理由
-4. 前提条件・仮定・不確実性
-5. 他エージェントによるレビュー可否
-
-前提・仮定・不確実性を明示すること。仮定を事実のように扱ってはならない。
-
-## 開発手順（概要）
-
-1. **プロジェクト理解**
-   - README.md、package.json、主要ファイルを読んで理解する
-   - このプロジェクトは個人用 ESLint 設定パッケージです
-
-2. **依存関係インストール**
-   - パッケージマネージャー: pnpm (10.28.1)
-   - コマンド: `pnpm install`
-
-3. **変更実装**
-   - TypeScript / JavaScript のコーディング規約に従う
-   - 関数・インターフェースには日本語で docstring を記載
-   - skipLibCheck での TypeScript エラー回避は禁止
-
-4. **テストと Lint/Format 実行**
-   - テストコマンド: `pnpm test`
-   - ESLint ルールの動作を検証する
-
-## セキュリティ / 機密情報
-
-- API キーや認証情報を Git にコミットしない。
-- ログに個人情報や認証情報を出力しない。
-
-## リポジトリ固有
-
-- このパッケージは npm に公開される共有可能な ESLint 設定です。
-- `index.mjs` が ESLint flat config のエントリポイントです。
-- TypeScript プロジェクト向けに `files: ["**/*.ts", "**/*.tsx"]` で TypeScript 専用ルールを適用しています。
-- 以下のルールが特別に調整されています：
-  - `@typescript-eslint/no-explicit-any`: off (any 型の使用を許可)
-  - `@typescript-eslint/no-unsafe-assignment`: off (危険な代入を許可)
-  - `@typescript-eslint/no-unsafe-argument`: off (危険な引数を許可)
-  - `@typescript-eslint/restrict-template-expressions`: テンプレート式で number, boolean, any, nullish を許可
-  - `@typescript-eslint/no-floating-promises`: void 演算子と即時関数での Promise を許可
-  - `@typescript-eslint/no-unnecessary-condition`: 定数ループ条件 (無限ループ) を許可
-  - `@typescript-eslint/no-extraneous-class`: 名前空間として使用されるクラスを許可
-  - `@typescript-eslint/no-use-before-define`: TypeScript 準拠に変更
-  - `unicorn/prefer-top-level-await`: off (トップレベル await を許可)
-  - `unicorn/prevent-abbreviations`: off (省略形を許可)
-  - `unicorn/no-null`: off (null を許可)
-  - `unicorn/no-useless-undefined`: off (無駄な undefined を許可)
-- Renovate による依存パッケージの自動更新が有効です。
-- テスト (test.mjs) は、一時的に `src/__tmp__cli` ディレクトリと `tsconfig.json` を作成して ESLint を実行します。

package/GEMINI.md

@@ -1,78 +0,0 @@
-# Gemini CLI 作業方針
-
-## 目的
-
-このドキュメントは、Gemini CLI がこのプロジェクトで作業する際のコンテキストと作業方針を定義します。
-
-## 出力スタイル
-
-- 言語: 日本語
-- トーン: プロフェッショナルで簡潔
-- 形式: 構造化された説明とコード例
-
-## 共通ルール
-
-- 会話言語: 日本語
-- コミット規約: [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) に従う (`<description>` は日本語)
-- 日本語と英数字の間: 半角スペースを挿入
-
-## プロジェクト概要
-
-- 目的: 個人用 ESLint 設定を提供するパッケージ
-- 主な機能: ESLint flat config に基づいた TypeScript / JavaScript プロジェクト向けのルール定義
-- 技術スタック: JavaScript (ES Modules), TypeScript (設定対象), ESLint flat config
-
-## コーディング規約
-
-- フォーマット: Prettier との統合 (eslint-config-prettier)
-- 命名規則: camelCase (変数・関数), PascalCase (クラス・型)
-- コメント言語: 日本語
-- エラーメッセージ言語: 英語
-- TypeScript の `skipLibCheck` での回避は禁止
-- 関数・インターフェースには docstring (JSDoc など) を日本語で記載
-
-## 開発コマンド
-
-```bash
-# 依存関係のインストール
-pnpm install
-
-# テスト実行
-pnpm test
-```
-
-## 注意事項
-
-### セキュリティ / 機密情報
-
-- API キーや認証情報を Git にコミットしない。
-- ログに個人情報や認証情報を出力しない。
-
-### 既存ルールの優先
-
-- 既存のコーディングスタイルに従う。
-- 不必要なリファクタリングは避ける。
-
-### 既知の制約
-
-- このパッケージは npm に公開される共有可能な ESLint 設定です。
-- Renovate による依存パッケージの自動更新が有効です。
-
-## リポジトリ固有
-
-- `index.mjs` が ESLint flat config のエントリポイントです。
-- TypeScript プロジェクト向けに `files: ["**/*.ts", "**/*.tsx"]` で TypeScript 専用ルールを適用しています。
-- 以下のルールが特別に調整されています：
-  - `@typescript-eslint/no-explicit-any`: off (any 型の使用を許可)
-  - `@typescript-eslint/no-unsafe-assignment`: off (危険な代入を許可)
-  - `@typescript-eslint/no-unsafe-argument`: off (危険な引数を許可)
-  - `@typescript-eslint/restrict-template-expressions`: テンプレート式で number, boolean, any, nullish を許可
-  - `@typescript-eslint/no-floating-promises`: void 演算子と即時関数での Promise を許可
-  - `@typescript-eslint/no-unnecessary-condition`: 定数ループ条件 (無限ループ) を許可
-  - `@typescript-eslint/no-extraneous-class`: 名前空間として使用されるクラスを許可
-  - `@typescript-eslint/no-use-before-define`: TypeScript 準拠に変更
-  - `unicorn/prefer-top-level-await`: off (トップレベル await を許可)
-  - `unicorn/prevent-abbreviations`: off (省略形を許可)
-  - `unicorn/no-null`: off (null を許可)
-  - `unicorn/no-useless-undefined`: off (無駄な undefined を許可)
-- テスト (test.mjs) は、一時的に `src/__tmp__cli` ディレクトリと `tsconfig.json` を作成して ESLint を実行します。