【結論】解決策 / 実行コマンド
CLAUDE.mdは単なるシステムプロンプトではなく、Claude Codeが階層的に読み込むプロジェクトメモリです。
リポジトリのルートだけでなく、親ディレクトリやサブディレクトリのルール、個人用メモリを組み合わせられます。
# ターミナルで実行：プロジェクト共通メモリを作成
cat > CLAUDE.md <<'EOF'
# Project instructions
- Package manager: pnpm
- Test: pnpm test
- Lint: pnpm lint
- 変更前に計画と対象ファイルを提示する。
- .env、production設定、生成物を変更しない。
EOF
# ターミナルで実行：Claude Codeを起動
claude
# 起動後のセッション内で実行：読み込まれたメモリを確認・編集
/memory具体的な手順・設定方法
繰り返し必要な事実だけを書き、長い設計書は
@docs/architecture.mdなどで参照します。ルートには全体ルール、サブディレクトリにはその領域固有のルールを配置します。
変更はGitレビューし、曖昧な指示や相互矛盾を削除します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
/memoryで読み込まれているCLAUDE.mdを確認してください。
その後、規約に従ってsrc/api/users.tsの修正計画だけを作成してください。
現在のルールに矛盾がある場合は編集せず、該当箇所を報告してください。注意点・よくあるエラーと対処法
CLAUDE.mdの指示は絶対的なセキュリティ境界ではなく、秘密情報の保護にはpermissionsを併用してください。
更新後に必ず/clearが必要とは限らず、/memoryで状態を確認できます。
APIキー、パスワード、個人固有の情報を共有ファイルへ記載しないでください。