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 で定義されたスコープ内のファイルのみ変更すること
• スコープ外の変更が必要な場合は、ユーザーに確認すること
• 「ついでに」のリファクタリングや改善は行わない