docs: CLAUDE.md を階層化した共通ルールに合わせて整理し、GEMINI.md と .agents/rules（Antigravity 用参照）を追加

.agents/rules/claude-md.md

@@ -0,0 +1,7 @@
+---
+trigger: always_on
+description: Read the CLAUDE.md hierarchy via GEMINI.md before doing anything in this workspace
+---
+
+最初に、このディレクトリの `GEMINI.md` を読み、そこに列挙された CLAUDE.md を上から順にすべて読んで従うこと。
+Read `GEMINI.md` in this directory first, then read and follow every CLAUDE.md it lists, in order.

CLAUDE.md

@@ -1,50 +1,19 @@
-# phpMyAdmin Helm Chart - CLAUDE.md
+# CLAUDE.md — phpMyAdmin Helm Chart
+
+> **共通ルール（要約）** — 詳細は `P:\Claude\CLAUDE.md`（全体共通）と `P:\Claude\HelmChart\CLAUDE.md`（Helm チャート共通: リリースフロー・ワークフロー・Gitea Secrets）を参照。
+> 作業前に pull ／ 機能変更時は README 更新 ／ 作業単位ごとに commit → push まで ／ コミットに AI クレジットを付けない ／ pull で入った変更を revert しない ／ Helm・PHP はローカル実行不可（Python のみ可）。
 
 ## リポジトリ概要
 
 nginx をリバースプロキシとして使用する phpMyAdmin を Kubernetes 上にデプロイするHelmチャートです。
 Raspberry Pi などのベアメタル上で動作する Kubernetes クラスタを想定した構成になっています。
 
+- **Gitea リポジトリ**: `ssh://git@192.168.9.65/helmchart/phpmyadmin.git`
+- **主アプリ**: phpMyAdmin（チャートのバージョン = phpMyAdmin のバージョン）
+- **サブアプリ**: nginx（nginx のみの更新ではリリースしない）
+
 ## 実行環境について
 
 **PHP実行環境はこのチャートには含まれません。**
 phpMyAdmin は公式イメージ (`phpmyadmin/phpmyadmin`) の `-fpm-alpine` タグを使用しており、
 PHP-FPM はその公式イメージ内に含まれています。別途 PHP 実行環境を用意する必要はありません。
-
-## Git 情報
-
-- **ユーザー名**: Claude
-- **メールアドレス**: claude@cafepieters.com
-- **リポジトリ**: ssh://git@192.168.9.65/helmchart/phpmyadmin.git
-
-## リリースフローのルール
-
-### バージョン番号の方針
-- Helmチャートのバージョン番号（`Chart.yaml` の `version` / `appVersion`）は、**主アプリ（phpMyAdmin）のバージョン番号と同一**とする。
-
-### 自動リリース条件
-- **phpMyAdmin バージョン更新時**: `values.yaml` と `Chart.yaml` を更新し、Gitタグ・Giteaリリース・Gitea Package Registry への発行まで行う。
-- **nginx のみの更新時**: `values.yaml` の該当タグのみ更新してコミットするが、**リリースは行わない**。
-
-### 手動リリース（臨時）
-- 改修作業などで手動リリースが必要な場合は、バージョン末尾にアルファベットを付与する。
-  - 例: `5.2.3` → `5.2.3-a`, `5.2.3-b`
-
-## ワークフロー構成
-
-### `.gitea/workflows/image-update-and-release.yaml`
-毎週月曜日 3:00 AM（JST 12:00 PM）に自動実行され、以下を行う:
-1. Docker Hub から nginx・phpMyAdmin の最新バージョンを取得
-2. 更新がある場合は `values.yaml` を更新
-3. phpMyAdmin のバージョンが更新された場合のみ、Helm チャートのリリースを実施
-
-### `.gitea/workflows/helm-release.yaml`
-`main` ブランチへのプッシュ時に自動実行。Gitea Package Registry にチャートを発行する。
-
-## 必要な Gitea Secrets
-
-| シークレット名 | 用途 |
-|---|---|
-| `GITEA_TOKEN` | Gitea API（リリース作成・タグ操作） |
-| `REGISTRY_USER` | Gitea Package Registry ユーザー名 |
-| `REGISTRY_TOKEN` | Gitea Package Registry トークン |

GEMINI.md

@@ -0,0 +1,24 @@
+# GEMINI.md — Antigravity (Gemini) 用エントリポイント（HelmChart\phpmyadmin）
+
+このディレクトリのルールはすべて **`CLAUDE.md`** に記載されている。本ファイルにはルール本文を書かず、読むべき CLAUDE.md への参照だけを置く（正本は常に CLAUDE.md）。
+
+## 必ず最初に実行すること
+
+以下のファイルを**上から順に**読み込み、すべての指示に従うこと。上位ほど広い範囲に適用される共通ルールで、下位は上位を前提とした補足・例外である。
+
+1. `P:\Claude\CLAUDE.md` — 全組織共通ルール（Git 運用・コミット書式・実行環境・情報記載の原則）
+2. `P:\Claude\HelmChart\CLAUDE.md` — HelmChart 組織共通ルール
+3. `P:\Claude\HelmChart\phpmyadmin\CLAUDE.md` — phpmyadmin リポジトリ固有ルール（このディレクトリ）
+
+> Antigravity はワークスペース（または git ルート）直下のルールしか自動で読まず、親フォルダを遡らない。そのため上位階層のパスをここに明示している。`P:\Claude` はクラウド同期されており、デスクトップ・ノート PC とも同じパスで存在する。
+
+## 読み替え
+
+- CLAUDE.md 中の「Claude」「Claude Code」は、Antigravity で作業する場合は Gemini 自身のことと読み替える。
+- Git のコミット者は Antigravity でも `user.name = Claude` / `user.email = claude@cafepieters.com` のまま使う（変更しない）。コミットメッセージに AI クレジットを付けない。
+- Claude Code 固有の機能（`.claude/` 設定、スキル、メモリ等）に関する記述は無視してよい。
+
+## 保守ルール
+
+- ルールの追加・変更は **CLAUDE.md にのみ**行う。本ファイルと `.agents/rules/claude-md.md` は参照だけを保持し、内容を増やさない。
+- CLAUDE.md を新しいディレクトリに追加したときは、同じ形式の `GEMINI.md` と `.agents/rules/claude-md.md` も併置する。