# .editorconfig
# https://editorconfig.org
 
root = true
 
# 全ファイル共通
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 2
 
# Python
[*.py]
indent_size = 4
 
# Go
[*.go]
indent_style = tab
indent_size = 4
 
# Rust
[*.rs]
indent_size = 4
 
# Java / Kotlin
[*.{java,kt,kts}]
indent_size = 4
 
# C# / .NET
[*.{cs,csx}]
indent_size = 4
 
# Makefile (タブ必須)
[Makefile]
indent_style = tab
 
# マークダウン (末尾スペースは意味がある)
[*.md]
trim_trailing_whitespace = false
 
# YAML
[*.{yml,yaml}]
indent_size = 2
 
# JSON
[*.json]
indent_size = 2
 
# TOML
[*.toml]
indent_size = 2
 
# Shell scripts
[*.sh]
end_of_line = lf
indent_size = 2
 
# Docker
[Dockerfile*]
indent_size = 4
 
# Terraform / HCL
[*.{tf,tfvars,hcl}]
indent_size = 2
 
# XML / SVG
[*.{xml,svg}]
indent_size = 2

# .editorconfig (大規模プロジェクト向け拡張)
 
root = true
 
[*]
charset = utf-8
end_of_line = lf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 2
max_line_length = 120
 
# プロトコルバッファ
[*.proto]
indent_size = 2
 
# GraphQL
[*.{graphql,gql}]
indent_size = 2
 
# 環境変数ファイル
[.env*]
insert_final_newline = true
 
# バッチファイル / PowerShell
[*.{bat,cmd}]
end_of_line = crlf
[*.ps1]
end_of_line = crlf
charset = utf-8-bom
 
# ライセンスファイル
[LICENSE*]
insert_final_newline = true
trim_trailing_whitespace = true
 
# Gemfile / Rakefile (Ruby)
[{Gemfile,Rakefile,*.rb}]
indent_size = 2
 
# PHP
[*.php]
indent_size = 4
 
# ソリューションファイル
[*.sln]
end_of_line = crlf
 
# csproj (Microsoft XML形式)
[*.{csproj,vbproj,vcxproj,proj}]
indent_size = 2
end_of_line = crlf

#!/bin/bash
# scripts/check-editorconfig.sh
# EditorConfig の適用状態を検証する
 
set -euo pipefail
 
ERRORS=0
 
# UTF-8 BOM チェック
echo "=== UTF-8 BOM チェック ==="
BOM_FILES=$(find . -type f \( -name "*.ts" -o -name "*.js" -o -name "*.json" \) \
  -exec grep -Pl '\xEF\xBB\xBF' {} \; 2>/dev/null || true)
if [ -n "$BOM_FILES" ]; then
  echo "FAIL: BOM 付きファイルが見つかりました:"
  echo "$BOM_FILES"
  ((ERRORS++))
else
  echo "PASS: BOM 付きファイルなし"
fi
 
# 末尾改行チェック
echo ""
echo "=== 末尾改行チェック ==="
MISSING_NEWLINE=$(find . -type f \( -name "*.ts" -o -name "*.js" \) \
  -not -path "*/node_modules/*" -not -path "*/.git/*" \
  -exec sh -c '[ -s "$1" ] && [ "$(tail -c1 "$1" | xxd -p)" != "0a" ] && echo "$1"' _ {} \; 2>/dev/null || true)
if [ -n "$MISSING_NEWLINE" ]; then
  echo "WARN: 末尾改行がないファイル:"
  echo "$MISSING_NEWLINE"
else
  echo "PASS: 全ファイルに末尾改行あり"
fi
 
# CRLF チェック (LF が正しい環境)
echo ""
echo "=== 改行コードチェック ==="
CRLF_FILES=$(find . -type f \( -name "*.ts" -o -name "*.js" -o -name "*.json" \) \
  -not -path "*/node_modules/*" -not -path "*/.git/*" \
  -exec grep -Prl '\r\n' {} \; 2>/dev/null || true)
if [ -n "$CRLF_FILES" ]; then
  echo "WARN: CRLF が検出されたファイル:"
  echo "$CRLF_FILES"
else
  echo "PASS: CRLF ファイルなし"
fi
 
echo ""
echo "=== 結果: ${ERRORS} エラー ==="
exit $ERRORS

// package.json
{
  "engines": {
    "node": ">=20.0.0",
    "npm": ">=10.0.0"
  },
  "packageManager": "pnpm@9.0.0",
  "volta": {
    "node": "20.11.0",
    "pnpm": "9.0.0"
  }
}

# fnm のインストール
# macOS
brew install fnm
 
# Linux / macOS (curl)
curl -fsSL https://fnm.vercel.app/install | bash
 
# Windows (winget)
winget install Schniz.fnm
 
# シェル設定 (~/.zshrc or ~/.bashrc)
eval "$(fnm env --use-on-cd)"
# --use-on-cd: ディレクトリ移動時に .nvmrc / .node-version を自動読み込み
 
# 基本操作
fnm install 20.11.0        # インストール
fnm use 20.11.0             # 切り替え
fnm default 20.11.0         # デフォルト設定
fnm list                    # インストール済み一覧
fnm list-remote             # 利用可能なバージョン一覧
fnm current                 # 現在のバージョン
 
# .nvmrc を読み込んでインストール & 使用
fnm install
fnm use

# Volta のインストール
curl https://get.volta.sh | bash
 
# Node.js のインストール & ピン留め
volta install node@20.11.0
volta pin node@20.11.0      # package.json に記録
 
# パッケージマネージャのピン留め
volta install pnpm@9.0.0
volta pin pnpm@9.0.0
 
# グローバルツールのインストール
volta install typescript
volta install @biomejs/biome
 
# package.json に自動追記される:
# {
#   "volta": {
#     "node": "20.11.0",
#     "pnpm": "9.0.0"
#   }
# }

# .mise.toml (旧 .tool-versions 形式も対応)
[tools]
node = "20.11.0"
python = "3.12.1"
ruby = "3.3.0"
go = "1.22.0"
rust = "1.76.0"
java = "temurin-21.0.2+13.0.LTS"
terraform = "1.7.0"
 
[env]
NODE_ENV = "development"
 
[tasks.dev]
run = "npm run dev"
description = "開発サーバー起動"
 
[tasks.test]
run = "npm test"
description = "テスト実行"

# mise のインストール
brew install mise
 
# シェル設定
eval "$(mise activate zsh)"
 
# バージョンのインストール
mise install           # .mise.toml に記載の全ツールをインストール
mise use node@20.11.0  # .mise.toml にバージョンを記録
 
# タスク実行
mise run dev
mise run test

# .npmrc
 
# エンジンバージョンを厳密にチェック
engine-strict=true
 
# package-lock.json を必ず生成
package-lock=true
 
# 正確なバージョンでインストール (^ や ~ を付けない)
save-exact=true
 
# npm audit のレベル設定
audit-level=moderate
 
# プライベートレジストリ (社内パッケージがある場合)
# @mycompany:registry=https://npm.mycompany.com/
# //npm.mycompany.com/:_authToken=${NPM_TOKEN}
 
# ピアデプとの自動解決
legacy-peer-deps=false
auto-install-peers=true
 
# ログレベル
loglevel=warn
 
# Node.js のバージョンが合わない場合に npm install を阻止
# （engines + engine-strict=true と併用）

# .npmrc (pnpm 用)
shamefully-hoist=false
strict-peer-dependencies=true
auto-install-peers=true

# pnpm-workspace.yaml
packages:
  - 'apps/*'
  - 'packages/*'
  - 'tools/*'

# .yarnrc.yml (Yarn Berry / Yarn 4)
nodeLinker: node-modules  # PnP を使わない場合
enableGlobalCache: false
checksumBehavior: update
 
# プライベートレジストリ
npmScopes:
  mycompany:
    npmRegistryServer: "https://npm.mycompany.com/"
    npmAuthToken: "${NPM_TOKEN}"
 
# プラグイン
plugins:
  - path: .yarn/plugins/@yarnpkg/plugin-interactive-tools.cjs
    spec: "@yarnpkg/plugin-interactive-tools"
  - path: .yarn/plugins/@yarnpkg/plugin-workspace-tools.cjs
    spec: "@yarnpkg/plugin-workspace-tools"

# .npmrc (セキュリティ強化)
 
# postinstall スクリプトの実行を制限
ignore-scripts=false
 
# パッケージの provenance (出所) を検証
# npm v9.5+ で利用可能
audit=true
audit-level=moderate
 
# パッケージの署名を検証 (npm v9.8+)
# sign-git-tag=true
 
# 2FA を強制 (npm publish 時)
# auth-type=web

# .gitattributes
 
# 改行コードの統一
* text=auto eol=lf
 
# 明示的なテキストファイル
*.js    text eol=lf
*.ts    text eol=lf
*.jsx   text eol=lf
*.tsx   text eol=lf
*.json  text eol=lf
*.yml   text eol=lf
*.yaml  text eol=lf
*.md    text eol=lf
*.css   text eol=lf
*.html  text eol=lf
*.sh    text eol=lf
*.py    text eol=lf
*.go    text eol=lf
*.rs    text eol=lf
*.java  text eol=lf
*.kt    text eol=lf
*.rb    text eol=lf
*.php   text eol=lf
*.sql   text eol=lf
*.graphql text eol=lf
*.proto text eol=lf
*.toml  text eol=lf
*.ini   text eol=lf
*.cfg   text eol=lf
*.env   text eol=lf
 
# Windows バッチファイル
*.bat   text eol=crlf
*.cmd   text eol=crlf
*.ps1   text eol=crlf
 
# バイナリファイル
*.png   binary
*.jpg   binary
*.jpeg  binary
*.gif   binary
*.ico   binary
*.webp  binary
*.avif  binary
*.woff  binary
*.woff2 binary
*.ttf   binary
*.eot   binary
*.pdf   binary
*.zip   binary
*.tar.gz binary
*.mp4   binary
*.mp3   binary
*.wav   binary
 
# ロックファイル (マージ時にコンフリクトを防ぐ)
package-lock.json merge=ours linguist-generated
pnpm-lock.yaml   merge=ours linguist-generated
yarn.lock        merge=ours linguist-generated
 
# 自動生成ファイル (diff に表示しない)
*.min.js linguist-generated
*.min.css linguist-generated
dist/** linguist-generated

# Git LFS (Large File Storage) 設定
# 大きなバイナリファイルを LFS で管理
*.psd filter=lfs diff=lfs merge=lfs -text
*.sketch filter=lfs diff=lfs merge=lfs -text
*.fig filter=lfs diff=lfs merge=lfs -text
*.ai filter=lfs diff=lfs merge=lfs -text
*.mov filter=lfs diff=lfs merge=lfs -text
 
# Diff のカスタマイズ
# JSON の差分を見やすくする
*.json diff=json
 
# CSS / SCSS の差分を関数単位で表示
*.css diff=css
*.scss diff=css
 
# Markdown の差分を見出し単位で表示
*.md diff=markdown
 
# Go の差分を関数単位で表示
*.go diff=golang
 
# Ruby の差分をメソッド単位で表示
*.rb diff=ruby

# .gitignore
 
# === 依存関係 ===
node_modules/
.pnpm-store/
vendor/
__pycache__/
*.pyc
.venv/
venv/
 
# === ビルド成果物 ===
dist/
build/
.next/
.nuxt/
.output/
out/
*.tsbuildinfo
 
# === 環境変数 ===
.env
.env.local
.env.development.local
.env.test.local
.env.production.local
 
# === エディタ ===
.idea/
*.swp
*.swo
*~
.project
.classpath
.settings/
 
# === OS ===
.DS_Store
Thumbs.db
Desktop.ini
 
# === テスト / カバレッジ ===
coverage/
.nyc_output/
*.lcov
test-results/
playwright-report/
 
# === ログ ===
*.log
logs/
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
 
# === Docker ===
docker-compose.override.yml
 
# === Terraform ===
*.tfstate
*.tfstate.backup
.terraform/
 
# === その他 ===
.cache/
.temp/
.tmp/
*.bak
*.orig

// .vscode/settings.json
{
  // エディタ基本設定
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit",
    "source.organizeImports": "explicit"
  },
  "editor.defaultFormatter": "esbenp.prettier-vscode",
 
  // TypeScript
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true,
 
  // ファイル除外
  "files.exclude": {
    "**/.git": true,
    "**/node_modules": true,
    "**/dist": true,
    "**/.next": true
  },
 
  // 検索除外
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/*.min.js": true,
    "**/pnpm-lock.yaml": true
  },
 
  // ファイルの自動保存
  "files.autoSave": "onFocusChange",
 
  // 末尾の空白を自動トリム
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,
  "files.trimFinalNewlines": true,
 
  // 言語固有設定
  "[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"
  },
  "[markdown]": {
    "editor.wordWrap": "on",
    "files.trimTrailingWhitespace": false
  },
  "[yaml]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[css]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[html]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
 
  // Tailwind CSS IntelliSense
  "tailwindCSS.experimental.classRegex": [
    ["cva\\(([^)]*)\\)", "\"'`.*?[\"'`]"],
    ["cx\\(([^)]*)\\)", "(?:'|\"|`)([^']*)(?:'|\"|`)"]
  ],
 
  // ESLint
  "eslint.validate": [
    "javascript",
    "javascriptreact",
    "typescript",
    "typescriptreact"
  ],
 
  // テスト
  "testing.automaticallyOpenPeekView": "never"
}

// .vscode/extensions.json
{
  "recommendations": [
    "dbaeumer.vscode-eslint",
    "esbenp.prettier-vscode",
    "editorconfig.editorconfig",
    "bradlc.vscode-tailwindcss",
    "prisma.prisma",
    "ms-azuretools.vscode-docker",
    "github.copilot",
    "github.copilot-chat",
    "ms-vscode.vscode-typescript-next",
    "streetsidesoftware.code-spell-checker",
    "usernamehw.errorlens",
    "eamodio.gitlens",
    "biomejs.biome"
  ],
  "unwantedRecommendations": [
    "hookyqr.beautify",
    "ms-vscode.vscode-typescript-tslint-plugin"
  ]
}

// .vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Next.js: Debug Server",
      "type": "node",
      "request": "launch",
      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/next",
      "args": ["dev"],
      "skipFiles": ["<node_internals>/**"],
      "console": "integratedTerminal"
    },
    {
      "name": "Vitest: Current File",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/node_modules/.bin/vitest",
      "args": ["run", "${relativeFile}"],
      "console": "integratedTerminal",
      "skipFiles": ["<node_internals>/**"]
    },
    {
      "name": "Vitest: Watch Mode",
      "type": "node",
      "request": "launch",
      "program": "${workspaceFolder}/node_modules/.bin/vitest",
      "args": ["--watch"],
      "console": "integratedTerminal",
      "skipFiles": ["<node_internals>/**"]
    }
  ]
}

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "dev",
      "type": "shell",
      "command": "make dev",
      "group": "build",
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    },
    {
      "label": "test",
      "type": "shell",
      "command": "make test",
      "group": "test"
    },
    {
      "label": "lint",
      "type": "shell",
      "command": "make lint",
      "group": "test",
      "problemMatcher": ["$eslint-stylish"]
    },
    {
      "label": "typecheck",
      "type": "shell",
      "command": "make typecheck",
      "group": "build",
      "problemMatcher": ["$tsc"]
    }
  ]
}

# husky と lint-staged のインストール
pnpm add -D husky lint-staged
 
# husky の初期化
pnpm exec husky init
 
# pre-commit フックの作成
echo "npx lint-staged" > .husky/pre-commit

// package.json
{
  "scripts": {
    "prepare": "husky"
  },
  "lint-staged": {
    "*.{ts,tsx,js,jsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,yml,yaml,md}": [
      "prettier --write"
    ],
    "*.css": [
      "prettier --write"
    ],
    "*.py": [
      "ruff check --fix",
      "ruff format"
    ],
    "*.go": [
      "gofmt -w",
      "go vet"
    ]
  }
}

#!/bin/sh
# .husky/pre-commit
npx lint-staged

#!/bin/sh
# .husky/commit-msg
npx --no -- commitlint --edit "$1"

#!/bin/sh
# .husky/pre-push
# プッシュ前にテストと型チェックを実行
npm run typecheck
npm run test -- --run

// commitlint.config.js
export default {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [
      2,
      'always',
      [
        'feat',     // 新機能
        'fix',      // バグ修正
        'docs',     // ドキュメント
        'style',    // フォーマット変更
        'refactor', // リファクタリング
        'perf',     // パフォーマンス改善
        'test',     // テスト
        'chore',    // ビルド・ツール
        'ci',       // CI 設定
        'revert',   // 取り消し
        'build',    // ビルドシステム変更
        'deps',     // 依存関係更新
      ],
    ],
    'subject-max-length': [2, 'always', 72],
    'body-max-line-length': [1, 'always', 100],
    'header-max-length': [2, 'always', 100],
    'scope-case': [2, 'always', 'lower-case'],
  },
};

# lefthook.yml
pre-commit:
  parallel: true
  commands:
    lint:
      glob: "*.{ts,tsx,js,jsx}"
      run: npx eslint --fix {staged_files} && git add {staged_files}
    format:
      glob: "*.{ts,tsx,js,jsx,json,yml,yaml,md,css}"
      run: npx prettier --write {staged_files} && git add {staged_files}
    typecheck:
      run: npx tsc --noEmit
 
commit-msg:
  commands:
    commitlint:
      run: npx commitlint --edit {1}
 
pre-push:
  commands:
    test:
      run: npx vitest run

// eslint.config.js
import js from '@eslint/js';
import tseslint from 'typescript-eslint';
import reactPlugin from 'eslint-plugin-react';
import reactHooksPlugin from 'eslint-plugin-react-hooks';
import importPlugin from 'eslint-plugin-import';
 
export default tseslint.config(
  // グローバル無視
  {
    ignores: [
      'dist/**',
      'build/**',
      '.next/**',
      'node_modules/**',
      'coverage/**',
      '*.config.js',
      '*.config.ts',
    ],
  },
 
  // 基本ルール
  js.configs.recommended,
 
  // TypeScript ルール
  ...tseslint.configs.recommendedTypeChecked,
  {
    languageOptions: {
      parserOptions: {
        project: './tsconfig.json',
        tsconfigRootDir: import.meta.dirname,
      },
    },
  },
 
  // React ルール
  {
    plugins: {
      react: reactPlugin,
      'react-hooks': reactHooksPlugin,
    },
    rules: {
      ...reactPlugin.configs.recommended.rules,
      ...reactHooksPlugin.configs.recommended.rules,
      'react/react-in-jsx-scope': 'off',
      'react/prop-types': 'off',
    },
    settings: {
      react: { version: 'detect' },
    },
  },
 
  // Import ルール
  {
    plugins: {
      import: importPlugin,
    },
    rules: {
      'import/order': [
        'error',
        {
          groups: [
            'builtin',
            'external',
            'internal',
            ['parent', 'sibling'],
            'index',
            'type',
          ],
          'newlines-between': 'always',
          alphabetize: { order: 'asc', caseInsensitive: true },
        },
      ],
      'import/no-duplicates': 'error',
    },
  },
 
  // カスタムルール
  {
    rules: {
      '@typescript-eslint/no-unused-vars': [
        'error',
        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
      ],
      '@typescript-eslint/no-explicit-any': 'error',
      '@typescript-eslint/consistent-type-imports': [
        'error',
        { prefer: 'type-imports' },
      ],
      'no-console': ['warn', { allow: ['warn', 'error'] }],
    },
  },
);

// .prettierrc
{
  "semi": true,
  "trailingComma": "all",
  "singleQuote": true,
  "printWidth": 100,
  "tabWidth": 2,
  "useTabs": false,
  "bracketSpacing": true,
  "arrowParens": "always",
  "endOfLine": "lf",
  "plugins": ["prettier-plugin-tailwindcss"],
  "overrides": [
    {
      "files": "*.md",
      "options": {
        "printWidth": 80,
        "proseWrap": "always"
      }
    }
  ]
}

// biome.json
{
  "$schema": "https://biomejs.dev/schemas/1.9.0/schema.json",
  "organizeImports": {
    "enabled": true
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true,
      "complexity": {
        "noBannedTypes": "error",
        "noExtraBooleanCast": "error"
      },
      "correctness": {
        "noUnusedVariables": "error",
        "noUnusedImports": "error",
        "useExhaustiveDependencies": "warn"
      },
      "suspicious": {
        "noExplicitAny": "error",
        "noConsoleLog": "warn"
      },
      "style": {
        "useConst": "error",
        "useTemplate": "error"
      }
    }
  },
  "formatter": {
    "enabled": true,
    "indentStyle": "space",
    "indentWidth": 2,
    "lineWidth": 100,
    "lineEnding": "lf"
  },
  "javascript": {
    "formatter": {
      "quoteStyle": "single",
      "trailingCommas": "all",
      "semicolons": "always",
      "arrowParentheses": "always"
    }
  },
  "json": {
    "formatter": {
      "trailingCommas": "none"
    }
  },
  "files": {
    "ignore": [
      "dist/**",
      "build/**",
      ".next/**",
      "node_modules/**",
      "coverage/**"
    ]
  }
}

// tsconfig.json
{
  "compilerOptions": {
    // 言語設定
    "target": "ES2022",
    "lib": ["ES2022", "DOM", "DOM.Iterable"],
    "module": "ESNext",
    "moduleResolution": "bundler",
    "jsx": "react-jsx",
 
    // 厳密モード
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true,
    "forceConsistentCasingInFileNames": true,
 
    // 出力設定
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "outDir": "./dist",
 
    // パスエイリアス
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"],
      "@/components/*": ["./src/components/*"],
      "@/lib/*": ["./src/lib/*"],
      "@/types/*": ["./src/types/*"]
    },
 
    // インポート
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "resolveJsonModule": true,
    "isolatedModules": true,
 
    // 型チェックの追加設定
    "skipLibCheck": true,
    "incremental": true
  },
  "include": ["src/**/*.ts", "src/**/*.tsx"],
  "exclude": ["node_modules", "dist", "**/*.test.ts"]
}

// renovate.json
{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "config:recommended",
    ":timezone(Asia/Tokyo)",
    ":semanticCommitTypeAll(chore)",
    "group:allNonMajor"
  ],
  "schedule": ["before 9am on Monday"],
  "labels": ["dependencies"],
  "automerge": true,
  "automergeType": "pr",
  "platformAutomerge": true,
  "packageRules": [
    {
      "matchUpdateTypes": ["major"],
      "automerge": false,
      "labels": ["dependencies", "major"]
    },
    {
      "matchPackagePatterns": ["eslint", "prettier", "biome"],
      "groupName": "linting tools"
    },
    {
      "matchPackagePatterns": ["vitest", "playwright", "@testing-library"],
      "groupName": "testing tools"
    },
    {
      "matchUpdateTypes": ["patch", "minor"],
      "matchPackagePatterns": ["*"],
      "automerge": true
    }
  ],
  "vulnerabilityAlerts": {
    "enabled": true,
    "labels": ["security"]
  }
}

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "weekly"
      day: "monday"
      time: "09:00"
      timezone: "Asia/Tokyo"
    open-pull-requests-limit: 10
    labels:
      - "dependencies"
    groups:
      development-dependencies:
        dependency-type: "development"
        update-types:
          - "minor"
          - "patch"
      production-dependencies:
        dependency-type: "production"
        update-types:
          - "minor"
          - "patch"
 
  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "weekly"
    labels:
      - "ci"
 
  - package-ecosystem: "docker"
    directory: "/"
    schedule:
      interval: "weekly"
    labels:
      - "docker"

# .github/workflows/ci.yml
name: CI
 
on:
  pull_request:
    branches: [main, develop]
  push:
    branches: [main]
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  lint:
    runs-on: ubuntu-latest
    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
      - run: pnpm run lint
      - run: pnpm run typecheck
      - run: pnpm run format:check
 
  test:
    runs-on: ubuntu-latest
    needs: lint
    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
      - run: pnpm run test -- --coverage
      - uses: actions/upload-artifact@v4
        with:
          name: coverage
          path: coverage/
 
  build:
    runs-on: ubuntu-latest
    needs: test
    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
      - run: pnpm run build

// NG: .vscode/settings.json に個人の好みを入れる
{
  "editor.fontSize": 18,
  "editor.fontFamily": "JetBrains Mono",
  "workbench.colorTheme": "One Dark Pro",
  "terminal.integrated.shell.osx": "/bin/zsh"
}
 
// OK: チームに関係する設定のみ
{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "typescript.tsdk": "node_modules/typescript/lib"
}

// NG: engines 未指定 → 各自のバージョンで動かす
{
  "name": "myapp",
  "version": "1.0.0"
}
 
// OK: engines + .nvmrc + engine-strict で強制
// package.json
{
  "name": "myapp",
  "version": "1.0.0",
  "engines": {
    "node": ">=20.0.0 <21.0.0",
    "npm": ">=10.0.0"
  }
}
// .npmrc
// engine-strict=true

# NG: 既存プロジェクトに厳密なルールを一度に適用
# → 数百〜数千のエラーが出てチームが混乱
eslint . --max-warnings 0
 
# OK: 段階的に導入
# Step 1: warn レベルで導入（既存コードは触らない）
# Step 2: 新規コードのみ strict 適用
# Step 3: 既存コードを段階的に修正
# Step 4: error レベルに昇格

# @mycompany/eslint-config パッケージ
mkdir eslint-config && cd eslint-config
npm init --scope=@mycompany
 
# package.json
{
  "name": "@mycompany/eslint-config",
  "version": "1.0.0",
  "main": "index.js",
  "peerDependencies": {
    "eslint": ">=9.0.0",
    "typescript-eslint": ">=8.0.0"
  }
}
 
# 利用側の package.json
{
  "devDependencies": {
    "@mycompany/eslint-config": "^1.0.0"
  }
}
 
# 利用側の eslint.config.js
import mycompanyConfig from '@mycompany/eslint-config';
export default [...mycompanyConfig, /* プロジェクト固有のルール */];