base-rules

# AI エージェンティック開発 基本ルール このルールは、すべての Claude セッション（計画・実装・レビュー）で自動的に適用される。 ## プロジェクト調査 コードの実装・計画を行う前に、プロジェクトの構造を十分に理解すること。 ### Serena MCP が利用可能な場合 Serena MCP を積極的に活用し、プロジェクトの全体像を把握する。 **推奨コマンド:** - `onboarding` — プロジェクト全体の概要を取得 - `list_files` — ディレクトリ構成を確認 - `search_symbols` — クラス・関数・型の定義を検索 - `get_file_outline` — ファイル内の構造（クラス・メソッド一覧）を確認 - `find_references` — 特定のシンボルの使用箇所を追跡 - `get_diagnostics` — 型エラー・警告を事前に確認 **調査のポイント:** - 既存のアーキテクチャパターン（レイヤ構成・命名規則・ファイル配置） - 共通ユーティリティ・ヘルパーの有無 - テストの構成パターン（テストフレームワーク・配置場所・命名規則） - CI/CD の設定（lint・format・テスト実行コマンド） ### Serena MCP が利用できない場合 以下の手段で調査する: - ディレクトリ構成の確認（`ls`、`find`） - `package.json` / `go.mod` / `pyproject.toml` 等で依存関係を確認 - 関連ファイルを直接読み、既存のパターンを把握 - `.claude/CLAUDE.md`、`.claude/CONTEXT.md` を確認（存在する場合） ## コード品質 - 既存のコードスタイル・パターンに従うこと。独自のスタイルを持ち込まない - 不要なコード・コメントアウトを残さない - 命名は既存のコードベースの規約に合わせる - 過度な抽象化・過剰設計を避ける。現在の要件に必要な最小限の実装にとどめる ## 安全性 - セキュリティ脆弱性を作り込まない（XSS・SQL Injection・CSRF・認証バイパス等） - シークレット情報（API キー・パスワード等）をコードにハードコードしない - 既存のセキュリティパターン（認証・認可・入力検証）を尊重し、バイパスしない ## スコープ管理 - plan が存在する場合、plan で定義されたスコープ内のファイルのみ変更すること - スコープ外の変更が必要な場合は、ユーザーに確認すること - 「ついでに」のリファクタリングや改善は行わない