AGENTS.md / CLAUDE.mdの
作り方

# CLAUDE.md
@AGENTS.md

## Claude Code 向けの追記
- src/billing/ 配下の変更は Plan mode で進める。
- 大きな変更は実装前に計画を出す。

ln -s AGENTS.md CLAUDE.md

your-monorepo/
├─ AGENTS.md            # 全体の共通ルール
├─ CLAUDE.md            # @AGENTS.md を読み込む
├─ packages/
│  ├─ web/
│  │  └─ AGENTS.md      # web だけのルール
│  └─ api/
│     └─ AGENTS.md      # api だけのルール
└─ ...

# プロジェクト概要
このリポジトリは [何を作っているか] のプロジェクトです。

## コマンド
- 開発サーバー: npm run dev
- ビルド: npm run build
- テスト: npm test
- lint: npm run lint

## コードスタイル
- インデントは2スペース
- 命名は [規約] に従う
- 新しい依存関係は勝手に追加しない

## やってはいけないこと
- .env、秘密鍵、顧客情報、個人情報を読まない・変更しない
- 公開、投稿、削除、デプロイは実行前に必ず確認する
- 大きな変更は先に計画を出し、承認後に実装する

## どこに何があるか
- 入口: README.md / package.json
- 本体: src/
- テスト: tests/

## 完了条件（Done when）
- 関連するテスト・表示確認が通る
- 変更ファイル、確認結果、残ったリスクを最後に要約する

このリポジトリ用の AGENTS.md（または CLAUDE.md）を作りたい。
まず現在の構成、package.json の scripts、テスト・lint・ビルド方法を調べて。
その上で、初心者でも保守しやすい短いルールファイル案を提示して。
まだファイルは作成せず、内容案だけ出して。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm test)",
      "Bash(git status)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(git push *)"
    ]
  }
}

# 個人用ルール・設定
CLAUDE.local.md
.claude/settings.local.json

# 秘密情報
.env
.env.*
secrets/
*.pem
*.key

your-project/
├─ CLAUDE.md              # 毎回読む短い共通ルール
├─ .claude/
│  └─ rules/
│     ├─ code-style.md    # コードスタイル
│     ├─ testing.md       # テスト規約
│     └─ security.md      # セキュリティ要件
└─ ...