# インストール
pnpm add -D eslint @eslint/js typescript-eslint globals
 
# 型チェック統合が必要な場合
pnpm add -D @typescript-eslint/parser
 
# React プロジェクトの場合
pnpm add -D eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-jsx-a11y
 
# Next.js プロジェクトの場合
pnpm add -D @next/eslint-plugin-next
 
# インポート整理
pnpm add -D eslint-plugin-import eslint-plugin-unused-imports
 
# Prettier との競合回避
pnpm add -D eslint-config-prettier

// eslint.config.js (Flat Config 形式 -- v9 推奨)
import js from "@eslint/js";
import tseslint from "typescript-eslint";
import globals from "globals";
 
export default tseslint.config(
  // グローバル無視
  {
    ignores: [
      "dist/",
      "build/",
      "node_modules/",
      "coverage/",
      ".next/",
      "*.config.js",
      "*.config.mjs",
      "*.config.cjs",
    ],
  },
 
  // JavaScript 推奨ルール
  js.configs.recommended,
 
  // TypeScript 推奨ルール
  ...tseslint.configs.recommendedTypeChecked,
 
  // プロジェクト共通設定
  {
    languageOptions: {
      ecmaVersion: 2024,
      sourceType: "module",
      globals: {
        ...globals.browser,
        ...globals.node,
      },
      parserOptions: {
        projectService: true,
        tsconfigRootDir: import.meta.dirname,
      },
    },
    rules: {
      // ─── 型安全性 ───
      "@typescript-eslint/no-explicit-any": "error",
      "@typescript-eslint/no-unsafe-assignment": "error",
      "@typescript-eslint/no-unsafe-call": "error",
      "@typescript-eslint/no-unsafe-return": "error",
      "@typescript-eslint/no-unsafe-member-access": "error",
      "@typescript-eslint/no-unsafe-argument": "error",
      "@typescript-eslint/prefer-as-const": "error",
      "@typescript-eslint/no-non-null-assertion": "warn",
      "@typescript-eslint/consistent-type-imports": ["error", {
        prefer: "type-imports",
        fixStyle: "inline-type-imports",
      }],
      "@typescript-eslint/consistent-type-exports": "error",
 
      // ─── コード品質 ───
      "@typescript-eslint/no-unused-vars": [
        "error",
        {
          argsIgnorePattern: "^_",
          varsIgnorePattern: "^_",
          destructuredArrayIgnorePattern: "^_",
          caughtErrorsIgnorePattern: "^_",
        },
      ],
      "no-console": ["warn", { allow: ["warn", "error"] }],
      "prefer-const": "error",
      "no-var": "error",
      eqeqeq: ["error", "always"],
      "no-eval": "error",
      "no-implied-eval": "error",
      "no-new-func": "error",
      curly: ["error", "all"],
      "no-throw-literal": "error",
 
      // ─── Promise / Async ───
      "@typescript-eslint/no-floating-promises": "error",
      "@typescript-eslint/no-misused-promises": "error",
      "@typescript-eslint/require-await": "warn",
      "no-return-await": "off",
      "@typescript-eslint/return-await": ["error", "in-try-catch"],
 
      // ─── 命名規則 ───
      "@typescript-eslint/naming-convention": [
        "error",
        {
          selector: "interface",
          format: ["PascalCase"],
        },
        {
          selector: "typeAlias",
          format: ["PascalCase"],
        },
        {
          selector: "enum",
          format: ["PascalCase"],
        },
        {
          selector: "enumMember",
          format: ["UPPER_CASE"],
        },
      ],
    },
  },
 
  // テストファイル用の緩和ルール
  {
    files: ["**/*.test.ts", "**/*.spec.ts", "**/__tests__/**"],
    rules: {
      "@typescript-eslint/no-unsafe-assignment": "off",
      "@typescript-eslint/no-explicit-any": "off",
      "@typescript-eslint/no-non-null-assertion": "off",
      "@typescript-eslint/no-unsafe-call": "off",
      "@typescript-eslint/no-unsafe-member-access": "off",
      "no-console": "off",
    },
  },
 
  // 設定ファイル用
  {
    files: ["*.config.ts", "*.config.js"],
    rules: {
      "no-console": "off",
      "@typescript-eslint/no-require-imports": "off",
    },
  }
);

// eslint.config.js (React + Next.js)
import js from "@eslint/js";
import tseslint from "typescript-eslint";
import globals from "globals";
import reactPlugin from "eslint-plugin-react";
import reactHooksPlugin from "eslint-plugin-react-hooks";
import jsxA11y from "eslint-plugin-jsx-a11y";
import nextPlugin from "@next/eslint-plugin-next";
import prettierConfig from "eslint-config-prettier";
 
export default tseslint.config(
  {
    ignores: ["dist/", "node_modules/", ".next/", "coverage/"],
  },
 
  js.configs.recommended,
  ...tseslint.configs.recommended,
 
  // React 設定
  {
    files: ["**/*.tsx", "**/*.jsx"],
    plugins: {
      react: reactPlugin,
      "react-hooks": reactHooksPlugin,
      "jsx-a11y": jsxA11y,
    },
    languageOptions: {
      globals: {
        ...globals.browser,
      },
      parserOptions: {
        ecmaFeatures: { jsx: true },
      },
    },
    settings: {
      react: { version: "detect" },
    },
    rules: {
      // React
      "react/prop-types": "off",
      "react/react-in-jsx-scope": "off",
      "react/self-closing-comp": "error",
      "react/jsx-no-target-blank": "error",
      "react/jsx-boolean-value": ["error", "never"],
      "react/jsx-curly-brace-presence": ["error", {
        props: "never",
        children: "never",
      }],
      "react/no-array-index-key": "warn",
      "react/no-unstable-nested-components": "error",
 
      // React Hooks
      "react-hooks/rules-of-hooks": "error",
      "react-hooks/exhaustive-deps": "warn",
 
      // アクセシビリティ
      "jsx-a11y/alt-text": "error",
      "jsx-a11y/anchor-is-valid": "error",
      "jsx-a11y/click-events-have-key-events": "warn",
      "jsx-a11y/no-static-element-interactions": "warn",
      "jsx-a11y/heading-has-content": "error",
      "jsx-a11y/label-has-associated-control": "error",
    },
  },
 
  // Next.js 固有ルール
  {
    plugins: { "@next/next": nextPlugin },
    rules: {
      ...nextPlugin.configs.recommended.rules,
      ...nextPlugin.configs["core-web-vitals"].rules,
    },
  },
 
  // Prettier と競合するルールを無効化 (必ず最後)
  prettierConfig,
);

# リント実行
pnpm eslint .
 
# 自動修正
pnpm eslint --fix .
 
# 特定ファイル
pnpm eslint src/utils/validate.ts
 
# キャッシュを使って高速化
pnpm eslint --cache .
pnpm eslint --cache --cache-location .eslintcache .
 
# デバッグ (どのルールが適用されているか確認)
pnpm eslint --print-config src/index.ts
pnpm eslint --debug src/index.ts
 
# package.json に scripts を追加
# {
#   "scripts": {
#     "lint": "eslint .",
#     "lint:fix": "eslint --fix .",
#     "lint:cache": "eslint --cache ."
#   }
# }

// eslint-rules/no-hardcoded-credentials.js
/** @type {import('eslint').Rule.RuleModule} */
export default {
  meta: {
    type: "problem",
    docs: {
      description: "ハードコードされた認証情報を禁止する",
    },
    messages: {
      hardcodedCredential: "認証情報をハードコードしないでください。環境変数を使用してください。",
    },
    schema: [],
  },
  create(context) {
    const suspiciousPatterns = [
      /password\s*[:=]\s*['"][^'"]+['"]/i,
      /api[_-]?key\s*[:=]\s*['"][^'"]+['"]/i,
      /secret\s*[:=]\s*['"][^'"]+['"]/i,
      /token\s*[:=]\s*['"][^'"]+['"]/i,
    ];
 
    return {
      Literal(node) {
        if (typeof node.value === "string") {
          for (const pattern of suspiciousPatterns) {
            if (pattern.test(`${context.getSourceCode().getText(node.parent)}`)) {
              context.report({
                node,
                messageId: "hardcodedCredential",
              });
            }
          }
        }
      },
    };
  },
};

# インストール
pnpm add -D prettier
 
# ESLint との競合回避
pnpm add -D eslint-config-prettier
 
# プラグイン
pnpm add -D prettier-plugin-tailwindcss    # Tailwind クラスソート
pnpm add -D prettier-plugin-organize-imports  # インポートソート
pnpm add -D @ianvs/prettier-plugin-sort-imports  # インポートソート (高機能)
pnpm add -D prettier-plugin-prisma          # Prisma スキーマ
pnpm add -D prettier-plugin-packagejson     # package.json ソート

// .prettierrc
{
  "semi": true,
  "singleQuote": true,
  "trailingComma": "all",
  "printWidth": 80,
  "tabWidth": 2,
  "useTabs": false,
  "bracketSpacing": true,
  "arrowParens": "always",
  "endOfLine": "lf",
  "bracketSameLine": false,
  "singleAttributePerLine": false,
  "htmlWhitespaceSensitivity": "css",
  "proseWrap": "preserve",
  "plugins": [
    "prettier-plugin-tailwindcss",
    "prettier-plugin-packagejson"
  ],
  "overrides": [
    {
      "files": "*.md",
      "options": {
        "printWidth": 100,
        "proseWrap": "always"
      }
    },
    {
      "files": "*.json",
      "options": {
        "trailingComma": "none"
      }
    },
    {
      "files": ["*.yml", "*.yaml"],
      "options": {
        "tabWidth": 2,
        "singleQuote": false
      }
    }
  ]
}

# .prettierignore
dist/
build/
node_modules/
coverage/
.next/
.turbo/
pnpm-lock.yaml
package-lock.json
yarn.lock
*.min.js
*.min.css

// eslint.config.js に追加
import prettierConfig from "eslint-config-prettier";
 
export default tseslint.config(
  // ...既存の設定...
 
  // Prettier と競合するルールを無効化 (必ず最後に配置)
  prettierConfig,
);

# インストール
pnpm add -D @biomejs/biome
 
# 初期設定
pnpm biome init
 
# ESLint / Prettier からの移行
pnpm biome migrate eslint --write
pnpm biome migrate prettier --write

// biome.json
{
  "$schema": "https://biomejs.dev/schemas/1.9.0/schema.json",
  "organizeImports": {
    "enabled": true
  },
  "formatter": {
    "enabled": true,
    "indentStyle": "space",
    "indentWidth": 2,
    "lineWidth": 80,
    "lineEnding": "lf"
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true,
      "complexity": {
        "noBannedTypes": "error",
        "noExcessiveCognitiveComplexity": {
          "level": "warn",
          "options": { "maxAllowedComplexity": 15 }
        },
        "noForEach": "warn",
        "useSimplifiedLogicExpression": "warn"
      },
      "correctness": {
        "noUnusedVariables": "error",
        "noUnusedImports": "error",
        "useExhaustiveDependencies": "warn",
        "noConstAssign": "error",
        "noUndeclaredVariables": "error"
      },
      "style": {
        "noNonNullAssertion": "warn",
        "useConst": "error",
        "useTemplate": "error",
        "useBlockStatements": "error",
        "noParameterAssign": "error",
        "useDefaultParameterLast": "error"
      },
      "suspicious": {
        "noExplicitAny": "error",
        "noDoubleEquals": "error",
        "noConfusingVoidType": "error",
        "noArrayIndexKey": "warn",
        "noConsoleLog": "warn"
      },
      "security": {
        "noDangerouslySetInnerHtml": "error"
      },
      "a11y": {
        "noBlankTarget": "error",
        "useAltText": "error",
        "useValidAnchor": "error",
        "useKeyWithClickEvents": "warn"
      }
    }
  },
  "javascript": {
    "formatter": {
      "quoteStyle": "single",
      "semicolons": "always",
      "trailingCommas": "all",
      "arrowParentheses": "always"
    },
    "parser": {
      "unsafeParameterDecoratorsEnabled": true
    }
  },
  "json": {
    "formatter": {
      "trailingCommas": "none"
    }
  },
  "css": {
    "formatter": {
      "indentStyle": "space",
      "indentWidth": 2
    },
    "linter": {
      "enabled": true
    }
  },
  "files": {
    "ignore": [
      "dist/",
      "build/",
      "node_modules/",
      ".next/",
      "coverage/",
      "*.min.js",
      "*.min.css"
    ],
    "maxSize": 1048576
  },
  "overrides": [
    {
      "include": ["**/*.test.ts", "**/*.spec.ts", "**/__tests__/**"],
      "linter": {
        "rules": {
          "suspicious": {
            "noExplicitAny": "off",
            "noConsoleLog": "off"
          }
        }
      }
    }
  ]
}

# ─── リント ───
pnpm biome lint .
pnpm biome lint --write .          # 自動修正
 
# ─── フォーマット ───
pnpm biome format .
pnpm biome format --write .        # フォーマット適用
 
# ─── チェックのみ (CI 用) ───
pnpm biome check .                 # lint + format を同時チェック
pnpm biome ci .                    # CI モード (エラー時に非ゼロ終了)
 
# ─── 全自動修正 ───
pnpm biome check --write .        # lint fix + format を同時適用
 
# ─── インポートのソート ───
pnpm biome check --write --organize-imports-enabled=true .
 
# ─── 特定ファイル ───
pnpm biome lint src/utils/validate.ts
pnpm biome format src/components/Button.tsx

# Step 1: 移行分析
pnpm biome migrate eslint --include-inspired
# → どのルールが Biome に移行可能か表示
 
# Step 2: biome.json 生成
pnpm biome migrate eslint --write
pnpm biome migrate prettier --write
 
# Step 3: 並行運用期間
# - Biome で lint + format
# - ESLint は型チェック連携ルールのみ残す
# - CI で両方実行して結果を比較
 
# Step 4: ESLint の削除
pnpm remove eslint eslint-config-prettier @typescript-eslint/eslint-plugin \
  @typescript-eslint/parser eslint-plugin-import prettier

# インストール
pip install ruff
# または
brew install ruff
# または uv
uv add --dev ruff
# または pipx
pipx install ruff

# pyproject.toml
[tool.ruff]
target-version = "py312"
line-length = 88
indent-width = 4
fix = true
 
# ソースディレクトリの指定
src = ["src", "tests"]
 
# 除外パターン
exclude = [
    ".git",
    ".venv",
    "__pycache__",
    "dist",
    "build",
    "*.egg-info",
    "migrations",
]
 
[tool.ruff.lint]
select = [
    "E",    # pycodestyle errors
    "W",    # pycodestyle warnings
    "F",    # Pyflakes
    "I",    # isort (インポートソート)
    "N",    # pep8-naming
    "UP",   # pyupgrade (古い構文の検出)
    "B",    # flake8-bugbear (バグ候補の検出)
    "SIM",  # flake8-simplify (簡略化可能なコード)
    "C4",   # flake8-comprehensions (内包表記の最適化)
    "DTZ",  # flake8-datetimez (タイムゾーン関連)
    "T20",  # flake8-print (print 文の検出)
    "RUF",  # Ruff固有ルール
    "ANN",  # flake8-annotations (型ヒント)
    "S",    # flake8-bandit (セキュリティ)
    "PT",   # flake8-pytest-style (pytest スタイル)
    "RET",  # flake8-return (return 文)
    "ARG",  # flake8-unused-arguments (未使用引数)
    "ERA",  # eradicate (コメントアウトされたコード)
    "PL",   # Pylint (一部ルール)
    "PERF", # Perflint (パフォーマンス)
    "FURB", # refurb (モダン Python)
]
ignore = [
    "E501",   # line too long (formatter に任せる)
    "ANN101", # self の型ヒント (不要)
    "ANN102", # cls の型ヒント (不要)
    "ANN401", # Any 型 (場合による)
]
 
# 自動修正可能なルール
fixable = ["ALL"]
unfixable = []
 
[tool.ruff.lint.per-file-ignores]
"tests/**/*.py" = ["T20", "S101", "ANN"]  # テストでは print, assert, 型ヒント省略OK
"conftest.py" = ["ANN"]
"__init__.py" = ["F401"]  # 再エクスポートの未使用インポート
 
[tool.ruff.lint.isort]
known-first-party = ["myproject"]
force-single-line = false
lines-after-imports = 2
 
[tool.ruff.lint.pydocstyle]
convention = "google"
 
[tool.ruff.format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"
docstring-code-format = true
docstring-code-line-length = 72

# ─── リント ───
ruff check .
ruff check --fix .              # 自動修正
ruff check --fix --unsafe-fixes . # 安全でない修正も含む
 
# ─── フォーマット ───
ruff format .
ruff format --check .           # チェックのみ (CI 用)
ruff format --diff .            # 差分表示
 
# ─── 特定ルールの確認 ───
ruff rule E501                  # ルールの詳細説明
ruff linter                     # 利用可能なルール一覧
 
# ─── 設定の確認 ───
ruff check --show-settings      # 現在の設定を表示
ruff check --statistics         # 違反統計
 
# Ruff は Flake8 + isort + Black + pyupgrade を1つで置き換える
# 速度は Flake8 の 10-100倍

# pyproject.toml (mypy 設定)
[tool.mypy]
python_version = "3.12"
strict = true
warn_return_any = true
warn_unused_configs = true
disallow_untyped_defs = true
disallow_any_generics = true
check_untyped_defs = true
 
# ライブラリのスタブ
module = ["redis.*", "celery.*"]
ignore_missing_imports = true

# インストール
pnpm add -D stylelint stylelint-config-standard
 
# SCSS の場合
pnpm add -D stylelint-config-standard-scss
 
# CSS-in-JS の場合
pnpm add -D postcss-styled-syntax
 
# Prettier との連携
pnpm add -D stylelint-config-prettier-scss
 
# プロパティ順序
pnpm add -D stylelint-order stylelint-config-recess-order

// .stylelintrc.json
{
  "extends": [
    "stylelint-config-standard-scss",
    "stylelint-config-recess-order",
    "stylelint-config-prettier-scss"
  ],
  "plugins": [
    "stylelint-order"
  ],
  "rules": {
    "color-named": "never",
    "color-hex-length": "short",
    "declaration-no-important": true,
    "selector-max-id": 0,
    "selector-max-specificity": "0,3,3",
    "max-nesting-depth": 3,
    "no-descending-specificity": true,
    "font-family-name-quotes": "always-where-recommended",
    "scss/dollar-variable-pattern": "^[a-z][a-z0-9-]*$",
    "scss/at-mixin-pattern": "^[a-z][a-z0-9-]*$",
    "selector-class-pattern": [
      "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
      { "message": "BEM パターンを使用してください" }
    ]
  },
  "ignoreFiles": [
    "dist/**",
    "node_modules/**",
    "coverage/**"
  ]
}

// .stylelintrc.json (Tailwind 対応)
{
  "extends": ["stylelint-config-standard"],
  "rules": {
    "at-rule-no-unknown": [true, {
      "ignoreAtRules": [
        "tailwind",
        "apply",
        "layer",
        "config",
        "screen",
        "variants",
        "responsive"
      ]
    }],
    "function-no-unknown": [true, {
      "ignoreFunctions": ["theme", "screen"]
    }],
    "no-descending-specificity": null
  }
}

# インストール
pnpm add -D husky lint-staged
 
# husky 初期化
pnpm husky init

// package.json
{
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --fix --cache",
      "prettier --write"
    ],
    "*.{js,jsx,mjs,cjs}": [
      "eslint --fix --cache",
      "prettier --write"
    ],
    "*.{json,md,yml,yaml}": [
      "prettier --write"
    ],
    "*.{css,scss}": [
      "stylelint --fix",
      "prettier --write"
    ],
    "*.py": [
      "ruff check --fix",
      "ruff format"
    ],
    "*.prisma": [
      "prettier --write"
    ],
    "package.json": [
      "prettier --write"
    ]
  }
}

# .husky/pre-commit
pnpm lint-staged

// package.json (Biome 版)
{
  "lint-staged": {
    "*.{ts,tsx,js,jsx,json,css}": [
      "biome check --write --no-errors-on-unmatched"
    ],
    "*.{md,yml,yaml}": [
      "prettier --write"
    ],
    "*.py": [
      "ruff check --fix",
      "ruff format"
    ]
  }
}

# lefthook.yml (husky + lint-staged の代替)
pre-commit:
  parallel: true
  commands:
    lint:
      glob: "*.{ts,tsx}"
      run: pnpm eslint --fix {staged_files} && pnpm prettier --write {staged_files}
      stage_fixed: true
    format-json:
      glob: "*.{json,md}"
      run: pnpm prettier --write {staged_files}
      stage_fixed: true
    python:
      glob: "*.py"
      run: ruff check --fix {staged_files} && ruff format {staged_files}
      stage_fixed: true

# lefthook のセットアップ
pnpm add -D lefthook
pnpm lefthook install

// .vscode/settings.json
{
  // ─── デフォルトフォーマッター ───
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.formatOnSave": true,
  "editor.formatOnPaste": false,
 
  // ─── ESLint 連携 ───
  "eslint.enable": true,
  "eslint.useFlatConfig": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit",
    "source.organizeImports": "never"
  },
 
  // ─── 言語別フォーマッター ───
  "[typescript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[typescriptreact]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[json]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[jsonc]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[css]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[scss]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.codeActionsOnSave": {
      "source.fixAll.ruff": "explicit",
      "source.organizeImports.ruff": "explicit"
    }
  },
  "[prisma]": {
    "editor.defaultFormatter": "Prisma.prisma"
  },
 
  // ─── Stylelint 連携 ───
  "stylelint.validate": ["css", "scss"],
  "css.validate": false,
  "scss.validate": false,
 
  // ─── ファイル設定 ───
  "files.eol": "\n",
  "files.insertFinalNewline": true,
  "files.trimTrailingWhitespace": true,
 
  // ─── formatOnSave の最適化 ───
  "editor.formatOnSaveMode": "modificationsIfAvailable"
}

// .vscode/extensions.json
{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode",
    "stylelint.vscode-stylelint",
    "charliermarsh.ruff",
    "bradlc.vscode-tailwindcss",
    "EditorConfig.EditorConfig",
    "Prisma.prisma"
  ],
  "unwantedRecommendations": [
    // Biome 使用時は ESLint + Prettier を非推奨に
    // "biomejs.biome"
  ]
}

// .vscode/settings.json (Biome 版)
{
  "editor.defaultFormatter": "biomejs.biome",
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "quickfix.biome": "explicit",
    "source.organizeImports.biome": "explicit"
  },
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff"
  },
  "[markdown]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }
}

# .editorconfig (エディタ横断の基本設定)
root = true
 
[*]
charset = utf-8
end_of_line = lf
indent_style = space
indent_size = 2
insert_final_newline = true
trim_trailing_whitespace = true
 
[*.md]
trim_trailing_whitespace = false
 
[*.py]
indent_size = 4
 
[Makefile]
indent_style = tab
 
[*.{yml,yaml}]
indent_size = 2
 
[*.go]
indent_style = tab
indent_size = 4

# .github/workflows/lint.yml
name: Lint & Format
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  lint:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version-file: '.node-version'
          cache: 'pnpm'
 
      - run: pnpm install --frozen-lockfile
 
      # ESLint (キャッシュ使用)
      - name: Lint
        run: pnpm eslint --cache .
 
      # Format チェック (修正なし -- 差分検出)
      - name: Format check
        run: pnpm prettier --check .
 
      # 型チェック
      - name: Typecheck
        run: pnpm tsc --noEmit
 
  lint-python:
    runs-on: ubuntu-latest
    if: ${{ hashFiles('**/*.py') != '' }}
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.12'
 
      - run: pip install ruff mypy
 
      - name: Ruff lint
        run: ruff check .
 
      - name: Ruff format check
        run: ruff format --check .
 
      - name: Mypy
        run: mypy .

# .github/workflows/lint-biome.yml
name: Lint (Biome)
on: [push, pull_request]
 
jobs:
  biome:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - uses: actions/checkout@v4
 
      - uses: pnpm/action-setup@v4
 
      - uses: actions/setup-node@v4
        with:
          node-version-file: '.node-version'
          cache: 'pnpm'
 
      - run: pnpm install --frozen-lockfile
 
      - name: Biome CI
        run: pnpm biome ci .

# .github/workflows/lint-review.yml
name: Lint Review
on: pull_request
 
jobs:
  lint-review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
    steps:
      - uses: actions/checkout@v4
 
      - uses: pnpm/action-setup@v4
 
      - uses: actions/setup-node@v4
        with:
          node-version-file: '.node-version'
          cache: 'pnpm'
 
      - run: pnpm install --frozen-lockfile
 
      # ESLint の結果を PR コメントとして投稿
      - name: ESLint
        uses: reviewdog/action-eslint@v1
        with:
          reporter: github-pr-review
          eslint_flags: '.'

// packages/config/package.json
{
  "name": "@repo/config",
  "version": "0.0.0",
  "private": true,
  "exports": {
    "./eslint/base": "./eslint/base.js",
    "./eslint/react": "./eslint/react.js",
    "./eslint/next": "./eslint/next.js",
    "./eslint/node": "./eslint/node.js",
    "./prettier": "./prettier/index.json",
    "./tsconfig/base": "./tsconfig/base.json",
    "./tsconfig/react": "./tsconfig/react.json",
    "./tsconfig/nextjs": "./tsconfig/nextjs.json",
    "./tsconfig/node": "./tsconfig/node.json",
    "./stylelint": "./stylelint/index.json"
  },
  "dependencies": {
    "@eslint/js": "^9.0.0",
    "typescript-eslint": "^8.0.0",
    "eslint-plugin-react": "^7.35.0",
    "eslint-plugin-react-hooks": "^4.6.0",
    "eslint-plugin-jsx-a11y": "^6.9.0",
    "@next/eslint-plugin-next": "^14.2.0",
    "eslint-config-prettier": "^9.1.0",
    "globals": "^15.0.0"
  }
}

# 演習1: 基本実装のテンプレート
class Exercise1:
    """基本的な実装パターンの演習"""
 
    def __init__(self):
        self.data = []
 
    def validate_input(self, value):
        """入力値の検証"""
        if value is None:
            raise ValueError("入力値がNoneです")
        return True
 
    def process(self, value):
        """データ処理のメインロジック"""
        self.validate_input(value)
        self.data.append(value)
        return self.data
 
    def get_results(self):
        """処理結果の取得"""
        return {
            'count': len(self.data),
            'data': self.data
        }
 
# テスト
def test_exercise1():
    ex = Exercise1()
    assert ex.process(1) == [1]
    assert ex.process(2) == [1, 2]
    assert ex.get_results()['count'] == 2
 
    try:
        ex.process(None)
        assert False, "例外が発生するべき"
    except ValueError:
        pass
 
    print("全テスト合格!")
 
test_exercise1()

# 演習2: 応用パターン
from typing import List, Dict, Optional
from datetime import datetime
 
class AdvancedExercise:
    """応用パターンの演習"""
 
    def __init__(self, max_size: int = 100):
        self._items: List[Dict] = []
        self._max_size = max_size
        self._created_at = datetime.now()
 
    def add(self, key: str, value: any) -> bool:
        """アイテムの追加（サイズ制限付き）"""
        if len(self._items) >= self._max_size:
            return False
        self._items.append({
            'key': key,
            'value': value,
            'timestamp': datetime.now().isoformat()
        })
        return True
 
    def find(self, key: str) -> Optional[Dict]:
        """キーによる検索"""
        for item in reversed(self._items):
            if item['key'] == key:
                return item
        return None
 
    def remove(self, key: str) -> bool:
        """キーによる削除"""
        for i, item in enumerate(self._items):
            if item['key'] == key:
                self._items.pop(i)
                return True
        return False
 
    def stats(self) -> Dict:
        """統計情報"""
        return {
            'total_items': len(self._items),
            'max_size': self._max_size,
            'usage_percent': len(self._items) / self._max_size * 100,
            'uptime': str(datetime.now() - self._created_at)
        }
 
# テスト
def test_advanced():
    ex = AdvancedExercise(max_size=3)
    assert ex.add("a", 1) == True
    assert ex.add("b", 2) == True
    assert ex.add("c", 3) == True
    assert ex.add("d", 4) == False  # サイズ制限
    assert ex.find("b")['value'] == 2
    assert ex.remove("b") == True
    assert ex.find("b") is None
    stats = ex.stats()
    assert stats['total_items'] == 2
    print("応用テスト全合格!")
 
test_advanced()

# 演習3: パフォーマンス最適化
import time
from functools import lru_cache
 
# 最適化前（O(n^2)）
def slow_search(data: list, target: int) -> int:
    """非効率な検索"""
    for i in range(len(data)):
        for j in range(i + 1, len(data)):
            if data[i] + data[j] == target:
                return (i, j)
    return (-1, -1)
 
# 最適化後（O(n)）
def fast_search(data: list, target: int) -> tuple:
    """ハッシュマップを使った効率的な検索"""
    seen = {}
    for i, num in enumerate(data):
        complement = target - num
        if complement in seen:
            return (seen[complement], i)
        seen[num] = i
    return (-1, -1)
 
# ベンチマーク
def benchmark():
    import random
    data = list(range(5000))
    random.shuffle(data)
    target = data[100] + data[4000]
 
    start = time.time()
    result1 = slow_search(data, target)
    slow_time = time.time() - start
 
    start = time.time()
    result2 = fast_search(data, target)
    fast_time = time.time() - start
 
    print(f"非効率版: {slow_time:.4f}秒")
    print(f"効率版:   {fast_time:.6f}秒")
    print(f"高速化率: {slow_time/fast_time:.0f}倍")
 
benchmark()